CLICKED()

CLICKED(N)

RETURNS 1 IF THE SYSTEM OBJECT NUMBER N IS CLICKED, 0 OTHERWISE

  • Type: Function
  • Parameter: 1
  • Group: System Objects

ACTION

The function CLICKED(N) returns 1 if the system object designated by its number N is clicked, and 0 if the system object is not clicked.

The system object N is of type : SCENE3D, BUTTON, EDIT, MEMO, COMBO, ALPHA, FORM, LIST, PICTURE, CHECK, OPTION, SUB_MENU.

SYNTAX: Result=CLICKED(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 function CLICKED() is used to know if a system object is clicked by the user.

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 the system object number N does not exist.
  • If number N is the number of : MAIN_MENU, SOUND, MOVIE, TRACK_BAR, OPEN_DIALOG, SAVE_DIALOG, SCROLL_BAR, PROGRESS_BAR.

EXAMPLE

rem create a BUTTON

button 1

caption 1,"Clic"

wait 3000

print

print

rem print its state : 0 or 1

print clicked(1)

SEE ALSO

ON_CLICK

CHECKED()