Waits for input from the key in the list display and returns an event if there is any input.

Syntax

int AL_ExecList(
  LIST_HANDLE list
);

Parameters

list
[in] List handle

Return value

Returns one of the events in the following table.
ValueDescription
AMENU_SPECIAL_KEY Indicates that the special key operation specified by the SpecialKey1 and SpecialKey2 members of the AM_Option structure has been detected.
NUM0_KEY Indicates that the [0] key has been pressed.
NUM1_KEY Indicates that the [1] key has been pressed.
NUM2_KEY Indicates that the [2] key has been pressed.
NUM3_KEY Indicates that the [3] key has been pressed.
NUM4_KEY Indicates that the [4] key has been pressed.
NUM5_KEY Indicates that the [5] key has been pressed.
NUM6_KEY Indicates that the [6] key has been pressed.
NUM7_KEY Indicates that the [7] key has been pressed.
NUM8_KEY Indicates that the [8] key has been pressed.
NUM9_KEY Indicates that the [9] key has been pressed.
SCAN_KEY Indicates that the [SCAN] key has been pressed.
Q1_KEY Indicates that the [Q1] key has been pressed.
Q2_KEY Indicates that the [Q2] key has been pressed.
BS_KEY Indicates that the [BS] key has been pressed.
CLR_KEY Indicates that the [CLEAR] key has been pressed.
ENT_KEY Indicates that the [ENT] key has been pressed.
SHIFT_KEY Indicates that the [SHIFT] key has been pressed.
DOT_KEY Indicates that the [.] key has been pressed.
F1_KEY Indicates that the [F1] key has been pressed.
F2_KEY Indicates that the [F2] key has been pressed.
F3_KEY Indicates that the [F3] key has been pressed.

Remarks

Waits for input from the key in the list display of list and returns an event if there is any input.

This function automatically performs the following processing.
  • Display the highlight on the list item that has focus.
  • Moves the focus backward or forward when you press the [Q1] key or the [Q2] key.
  • When more list items are registered than the number of rows in the list area, scroll the list up and down as the focus moves so that the list item with focus is always displayed in the list area.
  • Returns an event if there is any input.
  • If there is no input, wait for input while calling Idle function.

Requirements

Header file:
lib.h
AdvancedMenu.h
Library file:
libAdvancedMenu.a
libSTARTUPOPH5000.a

Last updated: 2020/10/16