RibbonComboBox - harborsiem/WinForms-Ribbon GitHub Wiki

RibbonComboBox

In the markup file this control is called ComboBox

Public constructors, methods, properties and events:

Constructors:

Name	Description
RibbonComboBox(RibbonStrip, uint)	Initializes a new instance of the RibbonComboBox class.

Methods:

Name	Description
InvalidateCategories()	Invalidates the GalleryCategories.
InvalidateItemsSource()	Invalidates the GalleryItemItemsSource.

Properties:

Name	Description
CommandId	Get the Id; set by constructor.
CommandType	Get the CommandType. Before this control is in view by the UI, the CommandType is Unknown. After this control is first time in UI view the CommandType is Collection.
Enabled	Get, Set the enabled state.
Name	Get, Set an optional Name.
Ribbon	Get the RibbonStrip (set by constructor).
ResourceIds	Get class MarkupResIds. This class delivers all markup resource ids for a Command. Only available if RibbonStrip.Markupheader is set.
Keytip	Get, Set a Keytip string. See Note below.
Label	Get, Set a Label (LabelTitle) string. See Note below.
TooltipTitle	Get, Set a TooltipTitle string. See Note below.
TooltipDescription	Get, Set a TooltipDescription string. See Note below.
LargeImage	Get, Set UIImage. See Note below.
SmallImage	Get, Set UIImage. See Note below.
LargeHighContrastImage	Get, Set UIImage. See Note below.
SmallHighContrastImage	Get, Set UIImage. See Note below.
Tag	Get, Set an optional Tag.
RepresentativeString	Get, Set a RepresentativeString. This value must be set in InitializeComponent.
SelectedItem	Get, Set a SelectedItem.
StringValue	Get, Set a StringValue.
GalleryCategories	Get a GalleryCategories.
GalleryItemItemsSource	Get a GalleryItemItemsSource.

Events:

Name	Description
SelectedIndexChanged	User can handle changed selected item. EventArgs are GalleryItemEventArgs.
Preview	User can handle changed selected item. EventArgs are GalleryItemEventArgs.
CancelPreview	User can handle changed selected item. EventArgs are GalleryItemEventArgs.
CategoriesReady	Ready to fill GalleryCategories by code.
ItemsSourceReady	Ready to fill GalleryItemItemsSource by code.
CreateUICommand	Control is created by the Ribbon Framework
DestroyUICommand	Control is destroyed by the Ribbon Framework

!Note:
For properties Keytip, LableTitle, LabelDescription, TooltipTitle and TooltipDescription: If listed property value is only set by Markup resource you get a value of null (nothing). But if you set RibbonStrip property MarkupHeader to the 'Embedded Resource' RibbonMarkup.h file, you will get the correct string.

!Note:
For properties SmallImage, LargeImage, SmallHighContrastImage and LargeHighContrastImage: If listed property value is only set by Markup resource you get a value of null (nothing).