PICTURE Property

PLBCMP GUI Only

The PICTURE property allows use of a picture in place of the text for a BUTTON object. The property uses the following format:

PICTURE={value}

Note the following:

PICTURE may be used in CREATE or SETPROP statements for BUTTON objects only.
If {value} is a Character String Variable, it specifies the name of a picture file. If {value} is a Null String, the PICTURE property is removed and the TITLE property is used.
If the picture file name does not have an extension, a default extension of '.bmp' is assumed.
The name supports $MACRO and :VOL name formats and the runtime attempts to locate the file using the PLB_PATH specification.
The actual picture file types supported for this property are the same as allowed for a CREATE PICT object.
If {value} is a Numeric Variable or decimal constant, it specifies the resource number of the picture. If {value} is zero, the PICTURE property is removed and the default BUTTON name text is used.
If {value} is a PICT object, the bitmap it represents is the PICTURE property.
This property is not available under Windows CE.
The PICTURE property is supported for the PWS BUTTON object by the PL/B Web Server. The client browser downloads and renders the image into HTML button object. PLB developers can evaluate the 'plbwebbasic.css' class 'button img' which is used by default by the PWS runtime. In addition, the PLB developers can create custom CSS classes that can be specified using the WEBCLASS property to control rendering of the images by the client browser. The images for the PICTURE property can be specified as follows:

The property can be specified as a resource number which must be a '.jpg', '.gif', or '.bmp' resource type.
The property can be specified as a specific image file name where the image file must reside under in or under the PWS images directory identified by the 'PLBWEB_IMAGES={directory}' keyword. The default when this keyword is not used is the PWS 'http_root\images' directory. The image files are limited to the image types as determined by the client browsers.
The property can be specified as a PICT object.