TToolButton.Grouped property

Declaration

property Grouped: Boolean read FGrouped write SetGrouped default False;

Description

Grouped is a Boolean property which indicates that the button is a member of a group when its value is set to True. A button group is a range of adjacent tool buttons with their Grouped properties set to True. The button range cannot extend beyond separators and dividers used on a tool bar control.

While Grouped can be assigned for any button style, it is significant when Style is set to tbsCheck. If Grouped is enabled, the checked-style button behaves like a check box in TCheckGroup or a radio button in TRadioGroup where only one of the grouped controls can be selected or checked at a time.

Changing the value for the property causes adjacent buttons on the TToolBar instance to be examined to ensure that only one of the grouped buttons has its Down property set to True.

Use AllowAllUp to indicate whether all of the buttons in a group can have their Down properties set to False.

See also

• Style
• Down
• AllowAllUp
• TToolButtonStyle