Skip to content

psImage - Button

Assigns an image to display on the button

Type: Property
Access: Read/Write
Data Type: String
Parameters: None

Syntax

Property String psImage
Access Type Syntax
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.