IMProcessAuxiliary Subroutine

Purpose

Notifies the input method of input for an auxiliary area.

Library

Input Method Library (libIM.a)

Syntax

int IMProcessAuxiliary(IM, AuxiliaryID, Button, PanelRow
      PanelColumn, ItemRow, ItemColumn, String, Length)
IMObject  IM;
caddr_t  AuxiliaryID;
uint  Button;
uint  PanelRow;
uint  PanelColumn;
uint  ItemRow;
uint  ItemColumn;
caddr_t *String;
uint *Length;

Description

The IMProcessAuxiliary subroutine notifies the input method instance of input for an auxiliary area.

Parameters

Item Description
IM Specifies the input method instance.
AuxiliaryID Identifies the auxiliary area.
Button Specifies one of the following types of input:
IM_ABORT
Abort button is pushed.
IM_CANCEL
Cancel button is pushed.
IM_ENTER
Enter button is pushed.
IM_HELP
Help button is pushed.
IM_IGNORE
Ignore button is pushed.
IM_NO
No button is pushed.
IM_OK
OK button is pushed.
IM_RETRY
Retry button is pushed.
IM_SELECTED
Selection has been made. Only in this case do the PanelRow, PanelColumn, ItemRow, and ItemColumn parameters have meaningful values.
IM_YES
Yes button is pushed.
PanelRow Indicates the panel on which the selection event occurred.
PanelColumn Indicates the panel on which the selection event occurred.
ItemRow Indicates the selected item.
ItemColumn Indicates the selected item.
String Holds the returned string. If a null value is returned, the input is used or discarded by the input method. Note that the String parameter is not a null-terminated string.
Length Stores the length, in bytes, of the String parameter.