HANDLE_CANVAS()

HANDLE_CANVAS(N)

RETURNS THE HANDLE OF THE GRAPHIC AREA OF THE SYSTEM OBJECT NUMBER N

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

ACTION

The function HANDLE(N) returns the handle of the graphic area of the system object designated by its number N.

The handle is the number given by the operating system (Windows) to an object.

The system object is of type : COMBO, ALPHA, FORM, LIST, PICTURE.

SYNTAX: Result=HANDLE_CANVAS(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 HANDLE_CANVAS() is used to know the handle of the graphic area of a system object, useful when calling DLL functions.

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 not the number of a SCENE3D, BUTTON, EDIT, MEMO, COMBO, ALPHA, FORM, LIST, CHECK, OPTION, MAIN_MENU, SUB_MENU, SOUND, MOVIE, TRACK_BAR, OPEN_DIALOG, SAVE_DIALOG, SCROLL_BAR, PROGRESS_BAR, SCENE2D.

EXAMPLE

rem create a LIST

list 1

rem print its handle

print handle(1)

SEE ALSO

HANDLE()