BTNSTYLE Property

PLBCMP GUI Only

 

The BTNSTYLE property defines the type of button used. The property uses the following format:

 

BTNSTYLE={value}

Note the following:

  1. BTNSTYLE may be used in SETPROP or GETPROP statements of a TOOLBUTTON object.

  2. TOOLBARs containing buttons with a dropdown style should use to $BUTTONCLICK or $ITEMCLICK to determine the selected list value.

  3. {value} is a decimal number, a Numeric Variable, an Expression, or a keyword as defined in PLBEQU.INC. The supported values and keywords are:
     

    4. Value

    Keyword

    Creates a ...

    1

    $TBSTYLEDROPDOWN

    drop-down style button that can display a list when the button is clicked. When the button is clicked a pop menu is shown and the $BUTTONCLICK or $ITEMCLICK Event Modifier contains a one-based menu selection value.

     

    If the TOOLBAR has the DOWNARROW property set, drop-down buttons have an arrow displayed in a separate section to their right. If the arrow is clicked, a drop down menu is shown and the $BUTTONCLICK or $ITEMCLICK Event Modifier contains a one-based menu selection value. If the associated button is clicked, a $BUTTONCLICK event is created with an Event Modifier value of zero.

    2

    $TBSTYLEDROPDOWNW

    button with a drop-down arrow but not as a separate section. Buttons with this style behave the same regardless of whether the DOWNARROW property is set for the TOOLBAR object.

    3

    $TBSTYLEPUSH

    standard push button.

    4

    $TBSTYLESEP

    separator providing a small gap between button groups. A button that has this style does not receive user input.

    5

    $TBSTYLETOGGLE

    dual-state push button that toggles between the pressed and not pressed states each time the user clicks it. The button has a different background color when it is in the pressed state.

    6

    $TBSTYLETOGGLEGRP

    button that stays pressed until another button in the group is pressed, similar to radio buttons.

 

See Also: Object Properties, Object IO Instructions, Object Definitions


PL/B Language Reference BTNHEIGHT Property BTNWIDTH Property