Name
XtGetActionKeysym — retrieve the keysym and modifiers that matched the final event specification in the translation table entry.
Synopsis
KeySym XtGetActionKeysym(event, modifiers_return)
XEvent ∗event;
Modifiers ∗modifiers_return;
Arguments
eventSpecifies the event pointer passed to the action procedure by the Intrinsics.
modifiers_return
Returns the modifiers that caused the match, if non-NULL.
Description
XtGetActionKeysym returns the keysym that matched the final event specification in the translation table, provided that:
•XtGetActionKeysym is called after an action procedure has been invoked by the Intrinsics and before that action procedure returns,
•the event pointer has the same value as the event pointer passed to that action routine, and
•the event is a KeyPress or a KeyRelease.
XtGetActionKeysym also returns the modifiers actually used to generate this keysym if modifiers_return is non-NULL.
If modifiers_return is NULL, XtGetActionKeysym returns values according to two cases:
•If the event is a KeyPress or KeyRelease, then XtGetActionKeysym calls XtTranslateKeycode and returns the results.
•If the event is not a KeyPress or KeyRelease, then XtGetActionKeysym returns NoSymbol and does not examine modifiers_return.
Note that if an action procedure which was invoked by the Intrinsics invokes a subsequent action procedure (and so on) via XtCallActionProc, the nested action procedure may also call XtGetActionKeysym to retrieve the Intrinsics’ keysym and modifiers.