exitcode

Exitcode returns a code indicating the event received. Typically this would be the exitcode associated with a mouse click on an object, or a particular keystroke or timer event. The actual values are generally consistent with INFLD, or XTREE, or both, to facilitate a single exitcode-handling routine that covers all three.

To avoid confusion between control-identifying exitcodes (i.e. those generated via the click string associated with a control) and navigational exitcodes (such as those in the following table), you should avoid assigning control-identifying exitcodes in the range of -100 to 100. See the cmd parameter of AUI_CONTROL, the hlpidx parameter of INFLD, and the XTR'KBDSTR (xtrctl) parameter of XTREE for information on how control-identifying exitcodes are defined.

Note that buttons with exitcode values -1 thru -32 may be used with EVW_EXCDINOUT. This allows buttons that emulate the standard function keys to be used with EVW_EXCDINOUT.

Exit Code

Flag(s)

Description

0

EVW_NUMERIC

number + enter

0

EVW_RAW

any keystroke

1

 

Escape

2

EVW_HAREXIT

LeftArrow

3

EVW_NOWRAP

Attempt to navigate up/back from end of group (instead of wrap)

3

EVW_VAREXIT

UpArrow

4

 

PrevPage

5

EVW_NOWRAP

Attempt to navigate down/forward from end of group

5

EVW_VAREXIT

DownArrow

6

 

NextPage

7

EVW_TABEXIT

Tab

10

 

Ctrl C

11

 

Time out

12

EVW_HAREXIT

Right Exit

99

 

Invalid combination of parameter values (no matching control)

-35

EVW_TABEXIT

Shift Tab

-36

EVW_HAREXIT

Shift Left Arrow

-37

EVW_VAREXIT

Shift UpArrow

-38

EVW_HAREXIT

Shift Right Arrow

-39

EVW_VAREXIT

Shift Down Arrow

-45

 

Home

-46

 

End

-47

 

Del

-52

EVW_CTLARROW, EVW_HAREXIT

Ctrl+Left Arrow

-53

EVW_CTLARROW, EVW_VAREXIT

Ctrl+UpArrow

-54

EVW_CTLARROW, EVW_HAREXIT

Ctrl+Right Arrow

-55

EVW_CTLARROW, EVW_VAREXIT

Ctrl+Down Arrow

-56

EVW_CTLCLIPBD

Ctrl+C

-57

EVW_CTLCLIPBD

Ctrl+V

-58

EVW_CTLCLIPBD

Ctrl+X

-60

EVW_CTLCLIPBD

Ctrl+Z

-61

EVW_CTLARROW

Ctrl+-(numpad minus)

-62

EVW_CTLARROW

Ctrl+Plus (numeric keyboard)

-65

 

Shift+Tab

-66

 

Ctrl+PageDown

-67

 

Ctrl+PageUp

-68

 

Ctrl+Home

<= -100

EVW_EXCDINOUT

No event, incoming exitcode passed through

-1 thru -16

 

F1 thru F16

#

 

Right click on control with VK_xrF# clickstring

-#

 

Left click on control with VK_xF# clickstring