Progress
Language Reference


Image Phrase

Interfaces
OS
SpeedScript
All
All
No

Specifies the file in which an image is stored and the dimensions of the image.

SYNTAX

FILE name
  [ { IMAGE-SIZE | IMAGE-SIZE-CHARS | IMAGE-SIZE-PIXELS } 
      width BY height
  ]
  [ FROM { X n Y n | ROW n COLUMN n } ] 

{ IMAGE-SIZE | IMAGE-SIZE-CHARS | IMAGE-SIZE-PIXELS }
  width BY height
  [ FROM { X n Y n | ROW n COLUMN n } ] 

FILE name

A character expression that specifies the name of an operating system file that contains an image. If you do not specify a full pathname, Progress searches your PROPATH for the file. If you do not supply a suffix, Progress searches for files with the extension .bmp, .ico, or .cur on Windows. The image contained within the file must be in a format that is appropriate for the target platform. The file is not read until the image is displayed.

[ IMAGE-SIZE | IMAGE-SIZE-CHARS ]

Specifies that the unit of measure when reading the image is characters.

IMAGE-SIZE-PIXELS

Specifies that the unit of measure when reading the image is pixels.

width

Specifies the width of the image. The value width must be an integer constant. If the image is larger than the size you specify, Progress crops the image to the specified size.

height

Specifies the height of the image. The value height must be an integer constant. If the image is larger than the size you specify, Progress crops the image to the specified size.

FROM { X n Y n | ROW n COL n }

Two integer constants (n) that specify the offset inside the image file where Progress starts reading the image. If you specify X and Y, the offset is measured in pixels; if you specify ROW and COL, the offset is measured in characters.

EXAMPLE

See the DEFINE IMAGE Statement reference entry for an example.

NOTES

SEE ALSO

DEFINE BUTTON Statement, DEFINE IMAGE Statement, FORM Statement


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095