OFF_MOUSE_MOVE

OFF_MOUSE_MOVE N

IGNORES THE EVENT "MOUSE_MOVE" WHEN THE USER MOVES THE MOUSE ON THE SYSTEM OBJECT NUMBER N

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

ACTION

The command OFF_MOUSE_MOVE N ignores the event "mouse_move" on the system object designated by the number N: the event subprogram is not executed when the user moves the mouse on the system object designated by the number N.

Remark 1: the system object must be one of the following types: SCENE3D, BUTTON , EDIT, MEMO, ALPHA, FORM, LIST, PICTURE, CHECK, OPTION, PROGRESS_BAR, SPIN, GRID, CONTAINER, SCENE2D, PANEL, CONTAINER_TAB, TAB.

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

SYNTAX: OFF_MOUSE_MOVE 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_MOUSE_MOVE is used not to treat the event "MOUSE_MOVE" 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 : SCENE3D, BUTTON , EDIT, MEMO, ALPHA, FORM, LIST, PICTURE, CHECK, OPTION, PROGRESS_BAR, SPIN, GRID, CONTAINER, SCENE2D, PANEL, CONTAINER_TAB, TAB.

EXAMPLE

dim c%

label mousemove

memo 1

left 1,300

caption 0,"Move mouse on MEMO"

on_mouse_move 1, mousemove

end

mousemove:

c%=c%+1

caption 0,"MOUSE_MOVE "+str$(c%)+" times"

if c%>10 then off_mouse_move 1

return

SEE ALSO

ON_MOUSE_UP

ON_MOUSE_MOVE

ON_MOUSE_DOWN

OFF_MOUSE_UP

OFF_MOUSE_DOWN