OFF_DOUBLE_CLICK

OFF_DOUBLE_CLICK N

IGNORES THE EVENT "DOUBLE CLICK" WHEN THE SYSTEM OBJECT NUMBER N IS DOUBLE-CLICKED

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

ACTION

The command OFF_DOUBLE_CLICK N ignores the event "double click" when the user clicks on the system object designated by the number N.

Remark 1: the system object must be one of the following types: SCENE3D, EDIT, MEMO, COMBO, ALPHA, FORM, LIST, PICTURE, OPTION, SPIN, GRID, CONTAINER.

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

SYNTAX: OFF_DOUBLE_CLICK N

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

USE

  • The command OFF_DOUBLE_CLICK is used to disassociate the event "DOUBLE CLICK" happening to a system object, to a program location (defined by the label L).
  • When the event occurs, the program named by the label is not executed any more.

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 : SCENE3D, EDIT, MEMO, COMBO, ALPHA, FORM, LIST, PICTURE, OPTION, SPIN, GRID, CONTAINER.

EXAMPLE

label col

dim c%

c%=3

edit 1

top 1,60

width 1,200

text 1,"double-click on me "+str$(c%)+" times"

on_double_click 1, col

end

col:

text 1,"double-clicked"

wait 250

c%=C%-1

text 1,"double-click on me "+str$(c%)+" times"

if c%=0

off_double_click 1

text 1,"double-click is inactive"

end_if

return

SEE ALSO

ON_DOUBLE_CLICK

DOUBLE_CLICKED()

NUMBER_DOUBLE_CLICK