GEOS SDK TechDocs|
| 
6.3 LocatorClass Instance Data
MSG_LOCATOR_CHANGE_TO_ACTION_BAR, MSG_LOCATOR_CHANGE_TO_TEXT_SEARCH, MSG_LOCATOR_DO_STRING_LOCATE, MSG_LOCATOR_DO_CHAR_LOCATE
Each time the Locator object changes its mode (
index
or
text search
) it will send itself either
MSG_LOCATOR_CHANGE_TO_ACTION_BAR
(if it is changing to index mode) or
MSG_LOCATOR_CHANGE_TO_TEXT_SEARCH
.
For example, if the Locator is in text search mode, it is desirable to revert to index mode whenever it loses the focus (and loses keyboard input). If the Locator is in text search mode and does lose the focus, the Locator's superclass (
TableClass
) senses this, sending
MSG_TABLE_STOP_EDIT_CELL_TEXT
to itself. In the handler for that message, the Locator sends itself
MSG_LOCATOR_CHANGE_TO_ACTION_BAR
.
void MSG_LOCATOR_CHANGE_TO_ACTION_BAR();
This message instructs the Locator object to appear as an "action bar" with a row of dyad buttons ("AB", "CD", etc.). This
index
mode is distinct from the Locator's other mode, that of a text search field. When the Locator object is in index mode, tapping (once) on a dyad button will send MSG_LOCATOR_DO_STRING_LOCATE with the first letter of the dyad tapped on (e.g. "A" in the `AB' dyad; "E" in the `EF' dyad). Repeatedly tapping on that dyad button will send
MSG_LOCATOR_DO_STRING_LOCATE
with the succeeding characters. The Locator object automatically "wraps" when it performs a search with its second character. I.e. after `B' is sent in the `AB dyad, `A' is sent again.
Source: The Locator object sends this message to itself.
Destination: A Locator object.
Parameters: None.
Return: Nothing.
Interception: May intercept to receive notification when the Locator object is switching into index mode. Make sure to pass this message on to the superclass, however.
void MSG_LOCATOR_CHANGE_TO_TEXT_SEARCH();
This message instructs the Locator object to appear as a text search field. When the Locator object is in text search mode any characters entered into the device will appear within the Locator's text search field. Pressing RETURN will send the text string to the Table with MSG_LOCATOR_DO_STRING_LOCATE.
Source: The Locator object.
Destination: A Locator object.
Parameters: None.
Return: Nothing.
Interception: May intercept to receive notification when the Locator is switching into text search mode. Make sure to pass this message on to the superclass, however.
GEOS SDK TechDocs|
| 6.3 LocatorClass Instance Data