OFF_KEY_DOWN

OFF_KEY_DOWN N

IGNORES THE EVENT "KEY_DOWN" WHEN THE USER PRESSES ANY KEY WHILE THE SYSTEM OBJECT NUMBER N HAS FOCUS

  • Type: Command
  • Parameter: 1
  • Group: Events

ACTION

The command OFF_KEY_DOWN N ignores the event "key_down" on the system object designated by the number N: the event subprogram is not executed when a change happens in the system object.

Remark 1: the system object must be one of the following types: BUTTON, EDIT, MEMO, COMBO, FORM, LIST, CHECK, OPTION, SPIN, GRID, MEMO_RICH, BUTTON_PICTURE, SCENE2D, GRID_DRAW, SYNEDIT.

Remark 2: the event subprogram is defined by the command ON_KEY_DOWN N,L which assigns the label L as the starting point of the event subprogram.

SYNTAX: OFF_KEY_DOWN N

  • N = system object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of system objects.

USE

  • The command OFF_KEY_DOWN is used not to treat the event "KEY_DOWN" happening to a system object: when the event occurs, the event subprogram is not executed.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of system objects.
  • If number N is less than 0.
  • If system object number N does not exist.
  • If system object number N is not of the type : BUTTON, EDIT, MEMO, COMBO, FORM, LIST, CHECK, OPTION, SPIN, GRID, MEMO_RICH, BUTTON_PICTURE, SCENE2D, GRID_DRAW, SYNEDIT.

EXAMPLE

off_key_down 1

SEE ALSO

ON_KEY_DOWN