PictureButton control
A PictureButton displays a picture and, like a CommandButton,
is used to carry out an action. For example, you can use a button
with a picture of a file to save a file, or a button with a picture
of a stop sign to cancel a requested deletion.
The picture image can be in the following formats:
-
Bitmaps, with .BMP or .RLE extensions
-
Windows metafiles, with the .WMF extension
-
GIF or animated GIF files, with the .GIF extension
-
JPEG files, with .JPEG or .JPG extensions
-
Portable Networks Graphics, with .PNG extension
Properties
PictureButton property |
Datatype |
Description |
---|---|---|
String |
A description of the control and/or |
|
String |
A label that briefly describes the control, |
|
AccessibleRole (enumerated) |
Describes what kind of user interface |
|
Long |
Specifies the numerical value of the |
|
Boolean |
Specifies whether PowerBuilder moves |
|
Boolean |
Specifies whether the control acts as
|
|
ClassDefinition |
PowerObject |
An object of type PowerObject containing |
Boolean |
Specifies whether the control is the
Editable controls Default behavior can be affected by editable controls on the |
|
String |
Specifies the name of the picture (bitmap |
|
Boolean |
Specifies whether PowerBuilder puts the
|
|
String |
Specifies the name of the stock icon When the user drags the control, the icon displays when the control |
|
Boolean |
Specifies whether the control is enabled
|
|
String |
Specifies the name of the typeface in |
|
FlatStyle |
Boolean |
Specifies that the edge of the button
|
FontCharSet (enumerated) |
Specifies the font character set used |
|
FontFamily (enumerated) |
Specifies the font family (type style)
|
|
FontPitch (enumerated) |
Specifies the pitch (spacing) of the
|
|
Integer |
Specifies the height of the control, |
|
Alignment (enumerated) |
Specifies how the text in the control
|
|
Boolean |
Specifies whether the text in the control
|
|
Boolean |
Specifies whether the system 3D colors
|
|
Boolean |
Specifies whether the width and height
In the Window painter, setting OriginalSize to true overrides |
|
String |
Specifies the name of the file that contains |
|
String |
Specifies the name of the stock pointer |
|
Long |
Specifies a PowerTip for the control. |
|
Integer |
Specifies the tab value of the control |
|
String |
Specifies the tag value assigned to the |
|
String |
Specifies the text that displays in the |
|
Long |
Specifies the numeric value of the text This property applies only when the UserObject is a tab page. |
|
Integer |
Specifies the size of the text in the |
|
Boolean |
Specifies whether the text in the control
|
|
Boolean |
Specifies whether the control is visible.
|
|
VTextAlign (enumerated) |
Specifies how the text in the control
All these values except MultiLine! assume there is only one |
|
Integer |
Specifies the stroke weight of the text |
|
Integer |
Specifies the width of the control, in |
|
Integer |
Specifies the X position (the distance |
|
Integer |
Specifies the Y position (the distance |
Events
PictureButton event |
Occurs |
---|---|
When the control is clicked |
|
Immediately before the Open event occurs |
|
Immediately after the Close event occurs |
|
When a dragged control is dropped on |
|
When a dragged control enters the control |
|
When a dragged control leaves the control |
|
When a dragged control is within the |
|
Just before the control receives focus |
|
When the user presses the F1 key or drags |
|
When the control loses focus (becomes |
|
When a Windows message occurs that is |
|
When the right mouse button is pressed |
Functions
PictureButton function |
Datatype returned |
Description |
---|---|---|
String |
Returns the name assigned to the control. |
|
Integer |
Starts or ends the dragging of the control. |
|
Integer |
Creates a reference to a context-specific |
|
PowerObject |
Returns a reference to the name of the |
|
Integer |
Makes the control invisible. |
|
Integer |
Moves the control to a specified location. |
|
Integer |
Returns the distance of the pointer from |
|
Integer |
Returns the distance of the pointer from |
|
Boolean |
Adds an event to the end of the message |
|
Integer |
Prints the control. |
|
Integer |
Changes the size of the control. |
|
Integer |
Sets focus to the specified control. |
|
Integer |
Specifies the position of the control |
|
Integer |
Controls automatic redrawing of the control |
|
Integer |
Makes the control visible. |
|
Integer |
Triggers a specified event in the control |
|
Object |
Returns the type of the control. |