Options on the Label tab of a button object's Properties dialog box

The following table shows the options on the
Label
tab of a button object's
Properties
dialog box.
Options
Descriptions
Caption
Specify the text for the object. The text appears on the face of the object to give the operator information about what the object does or about the current state.
Insert Variable
Click this button to select the type of variable to be inserted.
Font
Select the font to use for the caption.
Size
Select the font size to use for the caption or message.
Bold, Italic, Underline
Select a font style for the caption or message, if needed.
Caption color
This box shows the current text color for the caption. Click it to select another color.
Caption back color
This box shows the current background color for the caption. Click it to select another color.
If the caption background style is transparent, the application does not use this caption background color.
Caption blink
Select this check box if you want the caption to blink at runtime. The caption blinks twice per second.
Word wrap
Select this check box if you want the text to continue on the next line at the beginning of a new word.
If this check box is cleared, the text continues on the next line whenever the maximum text length is reached, even if this occurs in the middle of a word or number. The maximum text length depends on the width of the object and the font size.
Alignment
Select how you want the caption to be positioned on the object.
If the object shape is circle or ellipse, the position is relative to the button’s bounding box.
Caption back style
Select whether the caption’s background is solid or transparent.
If you select
Transparent
, the object’s background is not filled in and any objects behind it show through.
Image settings
Specify the image to show on the button.
Image
Specify the name of the image file to show on the button, or click the
Browse
button to open the
Image Browser
.
The image appears on the face of the object to give the operator information about what the object does or about the current state.
Before you can place an image on the object, you must import the image into your project.
Image back style
This property applies to monochrome and color images. Use it to set the background style to
Solid
or
Transparent
.
If Image back style is
Transparent
:
  • For monochrome images, the background will be transparent .
  • For color images that are not PNG with Alpha channel, any parts of the images that are black will be transparent.
Image color
Specify the color that the image is drawn in; that is, the foreground color. It applies only to monochrome images.
Click it to select another color.
Image back color
This property applies to monochrome images. It determines the color of the background the image is drawn on. Click the colored box to select another color.
If the
Image back style
 is
Transparent
, the background of the image will be transparent.
Image blink
Select this check box to let the monochrome image blink at runtime. The image blinks twice per second.
Image scaled
Select this check box to let the application resize the image to fit the object. If the object shape is circle or ellipse, the image is resized to fit in the object’s bounding box and clipped to fit the object’s shape.
If this is not selected, the image is first aligned using the
Alignment
setting, and then, if larger than the object, the image is clipped to fit the object.
Alignment
Specify how you want the image to be positioned on the object.
If the object shape is circle or ellipse, the position is relative to the object’s bounding box.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal