Toolbar Group

The C1ToolBarGroup object defines a group of toolbar elements. The C1ToolbarGroup can hold the following toolbar controls: C1ToolbarButton, C1ToolbarToggleButton, C1ToolbarDropDown, and C1ToolbarSplitButton.

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

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 GroupSizeDefinitions 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 property and positions the text value of the LabelTitle 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 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

XAML	Copy Code
</c1:C1ToolbarGroup> <c1:C1ToolbarGroup Header="Font"> <c1:C1ToolbarStrip> <c1:C1ToolbarToggleButton LabelTitle="Bold" /> <c1:C1ToolbarToggleButton LabelTitle="Italic" /> <c1:C1ToolbarToggleButton LabelTitle="Underline" /> </c1:C1ToolbarStrip> </c1:C1ToolbarGroup>

XAML

Copy Code

</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	Gets or sets the item that is located at a specified index of the collection.
GroupSizeDefinitions	Gets or sets the mode of selection for the items in the control.
Header	Gets or sets the header of the toolbar group.
MouseOverBrush	Gets or sets the Brush used to highlight the control when it has the mouse over.
PressedBrush	Gets or sets the Brush used to paint a button when it is pressed.
ShowDialogLauncher	Gets or sets the dialog launcher visibility.