Ribbon for WinForms | ComponentOne
Design-Time Support / Collection Editors
In This Topic
    Collection Editors
    In This Topic

    Collection Editors are used to add, remove or edit items in a collection at design-time. A Collection Editor can be launched by selecting the Ribbon element on the Form and then clicking the ellipsis next to Items, MenuItems, LeftPaneItems, RightPaneItems, BottomPaneItems or LeftBottomPaneItems properties in their respective Properties window.

    The text label at the top of the Collection Editor Dialog Box displays the name of Collection Editor. The Collection Editor dialog box usually comprises two sections: left and right sections. The Left part of the Collection Editor contains the Add and Remove button that can be used to add and remove items. The added items gets displayed in the Members section of the Collection Editor. You can click on each item added in the Members sections to view the respective item properties on the right pane. The Up and Down arrow buttons are used to navigate up and down the Members.

    The image below depicts the RibbonFontComboBox Menu Items Collection Editor.

    Collection editor for fontcombobox

    Types of Collection Editors

    Collection editors are grouped into three major types: Items Collection Editors, Menu Items Collection Editors and PaneItems Collection Editors.

    Refer the table below to get an in-depth idea about the Collection Editors associated with different elements in the C1Ribbon control.

    Elements

    Collection Editors

    Collection Editor Types

    C1Ribbon

    C1Ribbon has 13 types of Collection Editors:

    • RibbonApplicationMenu LeftPaneItems Collection Editor
    • RibbonApplicationMenu RightPaneItems Collection Editor
    • RibbonApplicationMenu BottomPaneItems Collection Editor
    • RibbonBottomToolBar Items Collection Editor
    • RibbonConfigToolBar Items Collection Editor
    • RibbonMenu Items Collection Editor
    • RibbonContextualTabGroup Collection Editor
    • QAT Items Collection Editor
    • QAT MenuItems Collection Editor
    • RibbonTopToolBar Items Collection Editor
    • Backstage View LeftBottomPaneItems Collection Editor
    • Backstage View LeftPaneItems Collection Editor
    • RibbonTab Collection Editor
    Application Menu

    Application Menu has 3 types of Collection Editors:

    • RibbonApplicationMenu LeftPaneItems Collection Editor
    • RibbonApplicationMenu RightPaneItems Collection Editor
    • RibbonApplicationMenu BottomPaneItems Collection Editor
    Backstage View

    BackStage View has 2 types of Collection Editors:

    • Backstage View LeftBottomPaneItems Collection Editor
    • Backstage View LeftPaneItems Collection Editor
    Configuration Toolbar RibbonConfigToolBar Items Collection Editor
    Contextual Tab Group RibbonTab Collection Editor
    Quick Access Toolbar

    The QAT has 2 types of Collection Editors:

    • QAT Items Collection Editor
    • QAT MenuItems Collection Editor
    Ribbon Group RibbonGroup Items Collection Editor
    Ribbon Tab RibbonGroup Collection Editor
    StatusBar

    StatusBar has 2 types of Collection Editors:

    • C1StatusBar LeftPaneItems Collection Editor
    • C1StatusBar RightPaneItems Collection Editor
    Button
    CheckBox
    ColorPicker
    ComboBox ComboBox has 2 types of Collection Editors:
    • RibbonComboBox Items Collection Editor
    • RibbonComboBox MenuItems Collection Editor
    ControlHost
    Date Picker
    Font ComboBox

    RibbonFontComboBox Menu Items Collection Editor

    Gallery

    Gallery has 2 types of Collection Editors:

    • RibbonGallery Items Collection Editor
    • RibbonGallery MenuItems Collection Editor
    Label
    Menu RibbonMenu Items Collection Editor

    NumericBox

    ProgressBar
    Separator
    SplitButton RibbonSplitButton Items Collection Editor
    TextBox
    Time Picker
    Toggle Button
    ToolBar RibbonToolBar Items Collection Editor
    TrackBar