The attributes of PictureButton are listed below. The data type of each attribute is also listed.
|
Attribute
|
Data Type
|
|
Cancel
Cancels any changes you have made and exits the current Window.
|
Boolean
|
|
Default
Default has these boolean values:
TRUE - The control is the default CommandButton or PictureButton. It has a thick border and will receive a clicked event when the user presses Enter without selecting an object.
FALSE - The control is not the default CommandButton or PictureButton.
If the Default attribute is TRUE for more than one CommandButton or PictureButton in a Window, the first button in the tab order receives a clicked event when the user presses Enter without selecting a control.
|
Boolean
|
|
DisabledName
DisabledName is a string containing the name of a Picture (bitmap image) that will be displayed when the PictureButton is disabled. If the picture is stored in a .BMP file and does not have an extension, PowerBuilder adds the extension .BMP.
|
String
|
|
DragAuto
DragAuto is a boolean indicating whether PowerBuilder will put the control automatically into Drag Mode. DragAuto has these boolean values:
TRUE - When the control is clicked, the control is automatically in Drag Mode.
TIP: When DragAuto is TRUE, clicking the control triggers a DragDrop event, not a Clicked event.
FALSE - When the control is clicked, the control is not automatically in Drag Mode; you have manually put the control into Drag Mode by using the Drag function.
|
Boolean
|
|
DragIcon
DragIcon is a string containing the name of the file containing the icon you want to display when the user drags a control (the .ICO file). The default icon is a box the size of the control.
When the user drags a control, the icon displays when the control is over an area in which the control can be dropped (a valid drop area). When the control is over an area that is not a valid drop area, the no drop icon displays.
|
String
|
|
Enabled
Enabled has these boolean values:
TIP: You can use the Enable and Disable functions to change the Enabled attribute of a MenuItem.
|
Boolean
|
|
FaceName
FaceName is a string containing the name of the type face (for example, Arial or Courier) for StaticText.
|
String
|
|
FontCharSet
FontCharSet is an enumerated data type specifying the font character set:
|
FontCharSet (enumerated)
|
|
FontFamily
FontFamily is an enumerated data type specifying the group type faces with similar characteristics. The data types for FontFamily are:
|
FontFamily (enumerated)
|
|
FontPitch
FontPitch is an enumerated data type specifying the spacing (pitch) of the font:
Default! - Use the standard pitch for the font (fixed or variable).
Fixed! - Use fixed pitch.
Variable! - Use variable pitch.
|
FontPitch (enumerated)
|
|
Height
Height is an integer containing the height of an object in PowerBuilder units.
|
Integer
|
|
HTextAlign
HTextAlign is an enumerated data type specifying the alignment of text in a PictureButton control:
|
HTextAlign (enumerated)
|
|
Italic
Italic has these boolean values:
|
Boolean
|
|
OriginalSize
OriginalSize has these boolean values:
TRUE - Set the Width and Height attributes of a bitmap image (Picture) to their original values.
FALSE - Do not set the Width and Height attributes to their original values.
Note:OriginalSize overrides the current Width and Height attributes.
|
Boolean
|
|
PictureName
PictureName is a string containing the filename of a Picture (bitmap image). The file extension .BMP is required.
|
String
|
|
Pointer
Pointer is a string containing the name of the file containing the pointer that will be used for the object or control.
|
String
|
|
TabOrder
TabOrder is an unsigned integer indicating the position of a control in the tabbing sequence within a Window. 0 means the control is read only and will be skipped when the user tabs.
TIP: You can use the Tab Order Option on the Design Menu in the Window Painter to assign the TabOrder.
To permit tabbing in a group box, change the tab value of the GroupBox to 0 and then assign non-zero tab values to the controls in the GroupBox. The default tab value for the RadioButtons in a GroupBox is 0.
Note:You do not have to assign TabOrder consecutively.
|
Integer
|
|
Tag
Tag is a string containing the tag value of a control, drawing object, user object, or MenuItem.
|
String
|
|
Text
Text is a string containing the text displayed in a control or MenuItem.
Notes:If a MenuItem that has a shortcut key (for example, F1 or Alt+A), text includes the shortcut key. If the Text attribute of a MenuItem is a single hyphen (-), the item displays as a separator (a horizontal line the width of the menu) and all other attributes for the item are ignored.
If the control is a DropDownListBox, text displays in the SingleLineEdit portion of the DropDownListBox.
|
String
|
|
TextSize
TextSize is an integer containing the font size of the text in points (for example, this is 10 point text).
|
Integer
|
|
VTextAlign
VTextAlign is an enumerated data type specifying the alignment of text in a PictureButton control:
Note:All these values except MultiLineText assume there is only one line of text.
|
Alignment
|
|
Underline
Underline has these boolean values:
|
Boolean
|
|
Visible
Visible has these boolean values:
TRUE - Make the object, window object, or MenuItem visible.
FALSE - Make the object, window object, or MenuItem invisible (hidden).
TIP: You can use the Show and Hide functions to change the visible attribute.
You cannot use the visible attribute or the Show or Hide functions to show or hide a drop-down or cascading menu or any menu that has an MDI frame window as its parent window.
|
Boolean
|
|
Weight
Weight is an integer containing the weight (line thickness) of the text in StaticText. Weight is in points. For example, 400 for normal and 700 for bold.
|
Integer
|
|
Width
Width is an integer containing the width of an object or window object in PowerBuilder units.
|
Integer
|
|
X
X is an integer containing the X coordinate of an object or window object in PowerBuilder units. The X coordinate is the distance from the left edge of the Window.
If the object is a main window, the distance is relative to the screen. If it is not a main window, the distance is relative to the parent window unless it is opened in a MDI frame window in which case, the distance is relative to the MDI frame.
|
Integer
|
|
Y
Y is an integer containing the Y coordinate of the object or window object in PowerBuilder units. The Y coordinate is the distance from the top.
If the object is a main Window, the distance is relative to the screen. If it is not a main window, the distance is relative to the parent window unless it is opened in a MDI frame window in which case, the distance is relative to the MDI frame.
|
Integer
|
