ButtonBar is a tool bar which can contain any number of ButtonBarButton and ButtonBarSeparator components. Each ButtonBarButton raises an event when clicked. A ContextMenuStrip can be assigned to a ButtonBarButton. If this is the case then the ContextMenuStrip is displayed when the ButtonBarButton, or the ButtonBarButton sub button if present, is clicked. A ButtonBarButton may be Checked. The Checked state of ButtonBarButton is automatically toggled when the CheckOnClick property is true. Each ButtonBarButton may be assigned to a check group. The ButtonBar ensures that only one ButtonBarButton in a check group is Checked at any time.

The image below shows a ButtonBar with all major visual items identified.

Property	Description
ButtonBarButton	A button on the ButtonBar. A ButtonBarButton can display Text, an Image and have a Menu assigned to it.
ButtonBarButton.CheckGroupIdentifier	A string identifying the check group the ButtonBarButton belongs to. Only one button in the check group can be checked at any time. The CheckOnClick property determines if the Checked property is automatically toggled when the ButtonBarButton is clicked. The EnableGroupUncheck ButtonBarButton property determines if it is possible for no button in the check group to be checked.
ButtonBarButton.Image	The Image displayed on the ButtonBarButton. If the ButtonBar has an ImageList, then the ImageIndex or ImageKey properties can be used to specify the image. The ImageSmallList ImageList contains the small versions of the images. The SmallImages property of ButtonBar can be used to specify if the buttons should display large or small images. The TextImageRelation property determines the location of the Image relative to the Text.
ButtonBarButton.Menu	The ContextMenuStrip associated with the ButtonBarButton. This menu is displayed when the ButtonBarButton is clicked.
ButtonBarButton.SubButton	Specifies if the ButtonBarButton has a subordinate button. For a ButtonBarButton with a sub button, the Menu is displayed when the sub button, not the button, is clicked.
ButtonBarButton.Text	The Text displayed on the ButtonBarButton. Depending on the size of the ButtonBar, a ButtonBarButton may be removed from the ButtonBar and placed on the overflow menu. The ButtonBarButton MenuText property can be used if the caption of the button on the overflow menu should be different from the Text. The TextImageRelation property determines the location of the Text relative to the Image.
ButtonBarSeparator	A separator on the ButtonBar. It is used to group the buttons of the ButtonBar.
Overflow menu indicator	When a ButtonBar is too narrow to contain all buttons then those ButtonBarButton components not visible are added to an overflow menu. Clicking an overflow menu item has the same effect as clicking the ButtonBarButton were it visible. Clicking the overflow menu indicator displays the overflow menu. If the ButtonBar is wide enough to contain all buttons then the overflow menu will be empty and the overflow indicator is hidden.

 

 

---