psImage - Button

Assigns an image to display on the button

Type: Property

Access: Read/Write

Data Type: String

Parameters: None

Syntax
 Property String psImage

Read Access: Get psImage to StringVariable
Write Access: Set psImage to StringVariable/Value


Description

This assigns the image and can be used in place of Set Bitmap, which is deprecated.

By default, the image size is 16 x 16, which can be changed with piImageSize. peImageAlign determines the image alignment. The piImageMarginTop, piImageMarginBottom, piImageMarginRight and piImageMarginLeft properties determine the image margins.

If the Label is non-blank, both the text and image are displayed. If the Label is blank, only the image is displayed.

This property can be changed after the button is displayed.

Sample

This sample shows a button that displays text and an image.

Object oTextAndImageButton is a Button
    Set Location to 20 71
    Set Label to 'Save'
    Set psImage to "ActionSave.ico"

    Procedure OnClick
    End_Procedure

End_Object


Instead of using psImage, you can create custom images for different button states by creating your own custom imagelist. See phoExternalButtonImageList.