LEFT()

LEFT(N)

RETURNS THE NUMBER OF PIXELS BETWEEN THE LEFT EDGE OF THE SYSTEM OBJECT NUMBER N AND ITS PARENT

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

ACTION

The function LEFT(N) returns the number of pixels between the left edge of the system object, designated by its number N, and its parent object (the "container").

The function cannot be called for the system objects : MAIN_MENU, SUB_MENU, SOUND, OPEN_DIALOG, SAVE_DIALOG, DLIST, TIMER, MAIN_MENU_POP, OPEN_DIALOG_PIC, SAVE_DIALOG_PIC, SERIAL, IMAGE, TAB.

SYNTAX: Result=LEFT(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 LEFT() is used to know the horizontal position of 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 the object number N is of type : MAIN_MENU, SUB_MENU, SOUND, OPEN_DIALOG, SAVE_DIALOG, DLIST, TIMER, MAIN_MENU_POP, OPEN_DIALOG_PIC, SAVE_DIALOG_PIC, SERIAL, IMAGE, TAB.

EXAMPLE

rem create a BUTTON

button 1:left 1,15

rem print the position of its left edge in FORM0

print

print

print left(1)

SEE ALSO

TOP()