WIDTH()

WIDTH(N)

RETURNS THE WIDTH IN PIXELS OF THE SYSTEM OBJECT NUMBER N

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

ACTION

The function WIDTH(N) returns the width of the system object designated by its number N, expressed in pixels.

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=WIDTH(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 WIDTH() is used to know the horizontal dimension 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 its width

print

print

print width(1)

SEE ALSO

HEIGHT()