The Table Objects: 6.3 LocatorClass: LocatorClass Instance Data

GEOS SDK TechDocs

6.2 Text Mode

6.4 Locator Actions

LocatorClass contains a number of instance fields that are usually not accessed directly. In most cases, these instance fields are maintained by the system. In some cases, you can send messages to alter these instance fields.

Code Display 5-10 LocatorClass Instance Data

/*
 * LocatorClass is a subclass of TableClass. Do not treat it as a 
 * normal subclass of TableClass, however. Many of the instance fields of 
 * TableClass undergo special treatment in LocatorClass (especially the column 
 * definitions). All of the Locator object's instance fields (except 
 * LI_destination) are internal and maintained by the Locator object itself.
 */

@instance 		LocatorStateFlags			LI_state;

@instance 		ChunkHandle			LI_actionBarColDefsHandle = 0;

@instance 		ChunkHandle			LI_textSearchColDefsHandle = 0;

@instance 		TableCellLocation			LI_selectionStart = 0;

@instance 		LocatorSelections			LI_selections = 0;

@instance 		optr			LI_destination = 0;

LI_ state is an internal field that is maintained by the LocatorClass object. This field determines whether the Locator has been initialized, and the status of its current state ( index or text search ). Do not alter this field.

LI_ actionBarColDefsHandle is an internal field; this field contains the chunk handle of the column definitions for the Locator object when it is in index mode. Note that the Locator object contains two separate column definitions, unusual for normal Table objects. Do not alter this field.

LI _textSearchColDefsHandle is an internal field; this field contains the chunk handle of the column definitions for the Locator object when it is in text search mode. Do not alter this field.

LI _selectionStart and LI_ selections are internal fields that manage information about the dyad button's states. Do not alter this field.

LI_ destination contains the optr of the object to receive messages (e.g., MSG_LOCATOR_DO_STRING_LOCATE ) sent out by this Locator object. This is usually the sibling Table object that searches are performed on. This field should be set statically.

GEOS SDK TechDocs

6.2 Text Mode

6.4 Locator Actions