TOP()

TOP(N)

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

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

ACTION

The function TOP(N) returns the number of pixels between the top 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=TOP(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 TOP() is used to know the vertical 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 system object number N does not exist.
  • 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

rem print the position of its top edge in FORM0

print

print

print top(1)

SEE ALSO

LEFT()