Button Properties

Description

A list of button properties.

Setup Properties 

  • Object Name 

    Any text description that you wish.

    :formname.controlname.object.name as C
  • Label 

    The text that appears on the button.

    :formname.controlname.text as C
  • Style 

    A button can have text, a bitmap, or text and a bitmap.

    :formname.controlname.btn_appearance as C
  • Enable Password 

    Checking Enable password enables the Set password button, which displays the Set Button Password screen.

  • Fly-over Effects Set Fly-over Appearance 

    Check Fly-over Effects and click Set Fly-over Appearance to set horizontal alignment, vertical alignment, border, fill, font, and shadow properties to take effect when the cursor is above the button. Fly-over properties are not settable through Xbasic.

  • Status Bar text 

    The text that appears on the Status Bar when the button is clicked.

  • Always on Top 

    When checked the button is always on the top-most level of the form layout. No other form elements will over lap it.

    :formname.controlname.object.always_on_top as L
  • Hide 

    When checked the button becomes invisible.

    :formname.controlname.object.visible as L
  • Tab Stop 

    When checked causes allows the user to tab to the button.

    :formname.controlname.object.tabstop as L
  • Disable 

    When checked the button becomes inaccessible.

    :formname.controlname.object.enabled as L
  • images/Button_Setup_Properties.gif

Alignment Properties 

  • Horizontal Alignment 

    Determines whether the button label will be left, right, or center aligned.

    :formname.controlname.align as C
  • Vertical Alignment 

    Determines whether the button label will be top, bottom, or center aligned.

    :formname.controlname.vertical_align as C
  • Word Wrap 

    Determines whether the button label may wrap to move than one line.

    :formname.controlname.word_wrap as  L
  • images/Button_Alignment_Properties.gif

Border Properties 

  • Border Style 

    Sets the border line style.

    :formname.controlname.border.style as C
  • Border Color 

    Sets the border line color (using a color name or RGB value ).

    :formname.controlname.border.color as C
  • Border Edge Shape 

    Sets the shape of the border.

    :formname.controlname.border.style as C
  • Border Width 

    The width of the border line in pixels.

    :formname.controlname.border.width as N
  • Show Left, Right, Top, Bottom 

    For edge shape "Square" determines which sides of the rectangle will display. For other edge shapes, determines which corners will be square or styled.

    :formname.controlname.border.has_bottom_edge as L
    :formname.controlname.border.has_left_edge as L
    :formname.controlname.border.has_right_edge as L
    :formname.controlname.border.has_top_edge as L
  • Shadow Style 

    Determines how much the shadow will be offset and its degree of shading.

    :formname.controlname.shadow.style as C
  • Shadow Color 

    Sets the shadow color (using a color name or RGB value ).

    :formname.controlname.shadow.color as C
  • Background Style 

    The fill color mode and translucency of the control's background.

    :formname.controlname.Background_style as C
  • Fill 

    The style and color(s) of the control's background.

    :formname.controlname.fill.backcolor as C
    :formname.controlname.fill.forecolor as C
    :formname.controlname.fill.style as C
  • images/Button_Border_Properties.gif

Font Properties 

  • Face 

    Sets the font.

    :formname.controlname.font.name as C
  • Size 

    Sets the point size.

    :formname.controlname.font.size as N
  • Bold, Italic, Underline, Strikeout 

    When checked set the named attribute.

    :formname.controlname.font.bold as  L
    :formname.controlname.font.italic as L
    :formname.controlname.font.strikeout as L
    :formname.controlname.font.underline as L
  • Color 

    Sets the text color.

    :formname.controlname.font.color as C
  • images/Button_Font_Properties.gif

Dimension Properties 

  • Left 

    Sets the horizontal position of the control.

    :formname.controlname.object.left as N
  • Top 

    Sets the vertical position of the control.

    :formname.controlname.object.top as N
  • Width 

    Sets the width of the control.

    :formname.controlname.object.width as N
  • Height 

    Sets the height of the control.

    :formname.controlname.object.height as N
  • Anchor 

    Determines the way the tabbed control will or will not stretch as the base form is resized. Possible attachment points are: 1 = top and right 2 = top, left, and right 4 = bottom and left 5 = bottom and right 6 = bottom, left, and right 8 = top, bottom, and left 9 = top, bottom, and right 10 = top, bottom, left, and right

    :formname.controlname.object.anchor as N
  • images/Button_dimension_Properties.gif

Help Properties 

  • Bubble Help Text 

    Click Edit... to define the bubble help text that appears when you place the cursor over the control.

    :formname.controlname.bubble_help as C
  • Help Source File 

    The path to and name of the compiled help file that contains the help topics.

    :formname.controlname.help_filename as C
  • Topic Name 

    The name of the help topic in a compiled help file.

    :formname.controlname.help_topic as C
  • Chapter Name 

    The name of the chapter name in an Alpha Anywhere help file.

    :formname.controlname.chapter_name.help_topic as C
  • Topic Name 

    The name of the help topic in a compiled help file.

    :formname.controlname.settings.help_title as C
  • images/Button_Help_Properties.gif

See Also