Componentone Toolbar for WPF and Silverlight
Toolbar Elements / Toolbar Group
In This Topic
    Toolbar Group
    In This Topic

    The C1ToolBarGroup object defines a group of toolbar elements. The C1ToolbarGroup can hold the following toolbar controls: C1ToolbarButtonC1ToolbarToggleButtonC1ToolbarDropDown, 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>
    

        

    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.