PICTURE

PICTURE N

CREATES A SYSTEM OBJECT PICTURE AND ALLOCATES IT NUMBER N AS REFERENCE

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

ACTION

The command PICTURE N creates a system object PICTURE, and allocates it a number N. The number N will be used to designate the PICTURE.

The created PICTURE can then be used through the appropriated commands.

The PICTURE is created at position (0,0) : that is TOP = 0 pixel and LEFT = 0 pixel, with dimensions: WIDTH = 105 pixels and HEIGHT = 105 pixels.

A PICTURE displays a bitmap file with command FILE_LOAD.

A PICTURE can generate the events : ON_CLICK, ON_DOUBLE_CLICK.

Remark: by default, the PICTURE is created on the FORM number 0, but another FORM can be used. For that, create a FORM by FORM N, and send it all the commands by COMMAND_TARGET_IS N before creating the PICTURE.

SYNTAX: PICTURE 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

  • A PICTURE is used to display a bitmap file (with command FILE_LOAD).

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 or equal to 0.
  • If number N is already used for a system object number.

EXAMPLE

rem create a PICTURE with default position and dimensions

picture 1

rem display the bitmap file

file_load 1,"landscape.bmp"

SEE ALSO

TOP

LEFT

WIDTH

HEIGHT

HINT

HINT_HIDE

COLOR

FULL_SPACE

ON_CLICK

ON_DOUBLE_CLICK

FILE_LOAD