ON_MOUSE_UP

ON_MOUSE_UP N,L

EXECUTES THE PROGRAM FROM LABEL L WHEN THE USER RELEASES A KEY OF MOUSE ON THE SYSTEM OBJECT NUMBER N

  • Type: Command
  • Parameters: 2
  • Group: Events

ACTION

The command ON_MOUSE_UP N,L assigns a label (which must be defined in the program) from which the program will run every time the user releases a key of mouse, while the mouse is on the system object designated by the number N.

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.

SYNTAX: ON_MOUSE_UP N,L

  • 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.
  • L = Label.

USE

  • The command ON_MOUSE_UP is used to associate an event (MOUSE_UP) 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 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.
  • If the label L does not exist.
  • If L is not a correct label name.

EXAMPLE

label down, up

button 1

left 1,300

width 1,200

on_mouse_up 1, down

on_mouse_up 1, up

caption 0,"Press and release mouse button on Button"

end

down:

caption 0,"DOWN on BUTTON"

pause 1000:caption 0,""

off_mouse_down 1

return

up:

caption 0,"UP on BUTTON"

pause 1000:caption 0,""

off_mouse_up 1

return

SEE ALSO

ON_MOUSE_MOVE

ON_MOUSE_DOWN

OFF_MOUSE_UP

OFF_MOUSE_DOWN

OFF_MOUSE_UP