POSITION()

POSITION(N)

RETURNS THE POSITION OF THE CURSOR OF THE BAR NUMBER N

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

ACTION

The function POSITION(N) returns the position value of the cursor of the system object designated by its number N.

The system object number N is a bar: SCROLL_BAR, TRACK_BAR, PROGRESS_BAR.

SYNTAX: Result=POSITION(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 POSITION() is used to know the position of the cursor moved 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 not the number of a SCROLL_BAR, a TRACK_BAR, a PROGRESS_BAR.

EXAMPLE

rem create a SCROLL_BAR

scroll_bar 1

rem print the position of its cursor

print position(1)

SEE ALSO

MIN

MAX

SCROLL_BAR

TRACK_BAR

PROGRESS_BAR