# Toolbar Group

## Content



The [C1ToolBarGroup](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarGroup.html) object defines a group of toolbar elements. The **C1ToolbarGroup** can hold the following toolbar controls: [C1ToolbarButton](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarButton.html), [C1ToolbarToggleButton](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarToggleButton.html), [C1ToolbarDropDown](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarDropDown.html), and [C1ToolbarSplitButton](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarSplitButton.html).

When you add toolbar items to the **C1ToolbarGroup** the child toolbar items appear grouped in a rectangular box like the following:

![](https://cdn.mescius.io/document-site-files/images/17ce8aee-69c7-489e-8aef-ce88c8948853/graphics/tbgroups.png)

**C1ToolbarGroups** are typically used when a group of functions are mutually exclusive. That is, only one of the functions represented by the group of buttons can be on at a time.

The images of the controls (**C1ToolbarButtons** and **C1ToolbarToggleButtons**) inside the **C1ToolbarGroup** can be all be sized to large, medium, or small using the [C1ToolbarGroupSizeDefinitions](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarGroupSizeDefinition.html) class.

The **GroupSizeDefinition** defines the control sizes as small, medium, or large and the position of the button text in a **C1ToolbarGroup**. If "large" is used then all the controls (**C1ToolbarButtons** and **C1ToolbarToggleButtons**) in the group gets the image size from the [LargeImageSource](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarButton.LargeImageSource.html) property and positions the text value of the [LabelTitle](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarButton.LabelTitle.html) property below the image. If "medium" is used then all the controls (**C1ToolbarButtons** and **C1ToolbarToggleButtons**) in the group gets the image size from the [SmallImageSource](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarButton.SmallImageSource.html) property and positions the text value of the **LabelTitle** property to the right of the image. If "small" is used then all the controls (**C1ToolbarButtons** and **C1ToolbarToggleButtons**) in the group gets the image size from the SmallImageResource property and does not show the text.

**EX: C1ToolbarGroup with a C1ToolbarStrip containing C1ToolbarButtons**

```xml
</c1:C1ToolbarGroup>
   <c1:C1ToolbarGroup Header="Font">
    <c1:C1ToolbarStrip>
       <c1:C1ToolbarToggleButton LabelTitle="Bold" />
       <c1:C1ToolbarToggleButton LabelTitle="Italic" />
       <c1:C1ToolbarToggleButton LabelTitle="Underline" />
    </c1:C1ToolbarStrip>
   </c1:C1ToolbarGroup>
```

The **C1ToolBarGroup** includes the following properties:

|   **Property**   |   **Definition**   |
| --- | --- |
|   [FocusBrush](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarGroup.FocusBrush.html)   |   Gets or sets the item that is located at a specified index of the collection.   |
|   [GroupSizeDefinitions](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarGroup.GroupSizeDefinitions.html)   |   Gets or sets the mode of selection for the items in the control.   |
|   [Header](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarGroup.Header.html)   |   Gets or sets the header of the toolbar group.   |
|   [MouseOverBrush](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarGroup.MouseOverBrush.html)   |   Gets or sets the Brush used to highlight the control when it has the mouse over.   |
|   [PressedBrush](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarGroup.PressedBrush.html)   |   Gets or sets the Brush used to paint a button when it is pressed.   |
|   [ShowDialogLauncher](/componentone/api/wpf/online-toolbar/dotnet-framework-api/C1.WPF.Toolbar.4.6.2/C1.WPF.Toolbar.C1ToolbarGroup.ShowDialogLauncher.html)   |   Gets or sets the dialog launcher visibility.   |