CURSOR_BEAM

CURSOR_BEAM N

DISPLAYS A CAPITAL I-SHAPED CURSOR ON THE SYSTEM OBJECT NUMBER N

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

ACTION

The command CURSOR_BEAM N displays a capital I-shaped cursor (driven by the mouse) on the system object number N.

The system object is of the type: SCENE3D, BUTTON, EDIT, MEMO, COMBO, ALPHA, FORM, LIST, PICTURE, CHECK, OPTION, MOVIE, TRACK_BAR, SCROLL_BAR, PROGRESS_BAR, SPIN, GRID, CONTAINER, MEMO_RICH, BUTTON_PICTURE, SCENE2D,PANEL, GRID_DRAW, CONTAINER_OPTION, SHAPE, HVIEWER, LED1,DIGIT1, SWITCH1, CONTAINER_TAB, SYNEDIT, CHART.

Remark 1: The cursor is the cursor by default for objects EDIT, MEMO, COMBO.

Remark 2: the cursor can be hidden by the command CURSOR_HIDE, and restored to its standard shape by the command CURSOR_DEFAULT.

SYNTAX: CURSOR_BEAM 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 CURSOR_BEAM is used to display an I-shaped cursor (mouse picture) on a system object.

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 the system object is of the type: SCENE3D, BUTTON, EDIT, MEMO, COMBO, ALPHA, FORM, LIST, PICTURE, CHECK, OPTION, MOVIE, TRACK_BAR, SCROLL_BAR, PROGRESS_BAR, SPIN, GRID, CONTAINER, MEMO_RICH, BUTTON_PICTURE, SCENE2D,PANEL, GRID_DRAW, CONTAINER_OPTION, SHAPE, HVIEWER, LED1,DIGIT1, SWITCH1, CONTAINER_TAB, SYNEDIT, CHART.

EXAMPLE

rem create a gray container with a capital I-shaped cursor

container 1

color 1,200,200,200

cursor_beam 1

SEE ALSO

CURSOR_ARROW

CURSOR_CROSS

CURSOR_DEFAULT

CURSOR_HELP

CURSOR_HIDE

CURSOR_HOURGLASS

CURSOR_NOPARKING

CURSOR_POINT