Open topic with navigation
WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
result = %L_CLASSINFO(listclass_id, info_type)
xcall L_CLASSINFO(listclass_id, info_type)
A value that is specific to info_type. (^VAL)
The ID of a list class window. (n)
One of the following to indicate the type of information to be returned (defined in tools.def): (n)
Returns the trimmed length of the list class name in result and the name of the list class in name. (a)
Returns the placement row specified for the list class. Returns zero if no placement row was specified.
Returns the placement column specified for the list class. Returns zero if no placement column was specified.
Returns the list class setting for the number of items to be displayed at one time. Returns zero if this was not specified.
Returns the number of header lines specified for the list class. Returns zero if the number of headers was not specified.
Returns the number of footer lines specified for the list class. Returns zero if the number of footers was not specified.
Returns true if headers for the list class are set to static. Otherwise, returns false.
Returns true if footers for the list class are set to static. Otherwise, returns false.
Returns true if the list class is set to prevent an empty list. Otherwise, returns false.
Returns true if the list class is set to maintain input window control information for list items. Otherwise, returns false.
D_LMETHOD, methodtype[, method]
Returns information about the method specified by methodtype. The trimmed length of the method name is returned in result. Zero is returned if no method was specified for the list class when it was created.
Optionally, the method name or address can be returned in method. If method is passed as a, the name of the method is returned; if it is passed as n, the address is returned. (If method is n and the method is not available—e.g., the routine doesn’t exist or the ELB hasn’t been opened yet—Toolkit will generate a trappable runtime error.) (a or n)
methodtype is one of the following: (n)
D_LLOAD = Load method
D_LARRIVE = Arrive method for list items
D_LLEAVE = Leave method for list items
D_LDBLCLK = Double‑click method for list items
Returns information about the options string defined for the list class. The trimmed length of the string is returned in result (or zero if no option string was defined for the list class). The options string itself can optionally be returned in options. If no options string was defined for the list class, options is cleared to all spaces. (a)
%L_CLASSINFO returns information about a list class (a window created by the .LISTCLASS script command or the L_CLASS routine).
To return most of the most of the info_type options, you must call %L_CLASSINFO as a function because information is returned in the return value (result). A few info_type options (such as D_LNAME and D_LMETHOD) include arguments that return additional information. So, for example, if you call %L_CLASSINFO as a function and pass D_LNAME, it will return the name of the list class in name and the length of the list class name in result. However, if you make this same call but as a subroutine, it will return only the name of the list class in name. Calling D_LPROW, for example, as a subroutine is pointless because nothing will be returned.
The following example returns the length of the list class’s name in length, and it returns the name of the list class in lc_name:
length = %L_CLASSINFO(lc_id, D_LNAME, lc_name)
The next example returns the length of the name of the load method for the list class, and it returns the method name in meth_name:
length = %L_CLASSINFO(lc_id, D_LMETHOD, D_LLOAD, meth_name)