HC_Show_String_Source

void HC_Show_String_Source(char *keyboard, Key *cursor_key)
void HC_Show_String_Source(char keyboard, Key cursor_key)

Returns the keyboard-device segment and cursor that gave rise to the current string event.

In HOOPS, events are trapped with routines like Await_Event() . Once Await_Event() has a current event, routines like Show_String_Source() , can be used to garner information about the event.

Show_String_Source() is one of a family of routines that extracts information from the current event (presumably a string event) and returns it to you. In particular, Show_String_Source() returns the keyboard device and cursor combination that was originally enabled for String events, which gave rise to the event now at hand. This information might be of interest if your program is handling several different string devices simultaneously.

HC_Enable_String_Events, HC_Show_String, HC_Get_String.

Parameters

keyboard: The segment associated with the physical keyboard device that initiated the current event. Passed by reference always. Returned to user.

cursor_key: The cursor being used for string echoing. Passed by reference always. Returned to user.