init_initialize_the_locatorclass_object_.htm
Navigation: ABC Library Reference > LocatorClass > LocatorClass Methods >====== Init (initialize the LocatorClass object)  ====== |    |
Init( [control] , freeelement, nocase [,browseclass ] )
| Init | Initializes the LocatorClass object. |
| control | An integer constant, variable, EQUATE, or expression that sets the locator control number for the LocatorClass object. If omitted, the control number defaults to zero (0) indicating there is no locator control. |
| freeelement | The fully qualified label of a component of the sort sequence of the searched data set. The ABC Templates further require this to be a free component of a key. A free component is one that is not range limited to a single value. Typically this is also the USE variable of the locator control. |
| nocase | An integer constant, variable, EQUATE, or expression that determines whether the LocatorClass object performs case sensitive searches or case insensitive searches. |
| browseclass | The label of the BrowseClass object for the locator. If omitted, the LocatorClass object has no direct access to the browse QUEUE or it's underlying VIEW. |
The Init method initializes the LocatorClass object.
Implementation:
The Init method sets the values of the Control, FreeElement, NoCase, and ViewManager properties.
A nocase value of zero (0 or False) produces case sensitive searches; a value of one (1 or True) produces case insensitive searches.
By default, only the StepLocatorClass and FilterLocatorClass use the browseclass. The other locator classes do not.
Example:
BRW1::Sort1:Locator.Init(,CUST:StateCode,1) !without locator control
BRW1::Sort2:Locator.Init(?CUST:CustNo,CUST:CustNo,1)!with locator control
See Also: Control, FreeElement, NoCase, ViewManager
init_initialize_the_locatorclass_object_.htm.txt · Last modified: 2021/04/15 15:57 by 127.0.0.1