FileHandle Attribute
Data Type: varchar(256)
4GL Access: RW
The FileHandle attribute identifies an external file containing a bitmap.
When you set this attribute to the file name, OpenROAD associates the bitmap in the file with the BitmapObject object and automatically displays the bitmap if the bitmap object is currently displayed in an ImageField. To update the image in a palette field, you must then call the UpdChoiceList method.
The file format must have one of the following formats:
XBM
Specifies portable X black and white
GIF
Specifies GIF format, in black and white or color
RAST
Specifies Sun raster format, for color or black and white
BMP
Specifies .BMP format
ICO
Specifies .ICO icon format
JPG
Specifies JPEG format
TIFF
Specifies TIFF format
CUR
Specifies .CUR format
If you set the FileHandle attribute to an empty or null string, OpenROAD clears any existing bitmap from the bitmap object and, consequently, from the display if the bitmap was displayed. If you set FileHandle to an invalid file name or a file that does not exist, OpenROAD generates an error message and removes the bitmap object.
For a discussion of using this attribute, see the Programming Guide.