comboBox
In the object model this is RibbonComboBox.
The value returned is the actual list value.
This is a combination of an editbox and a dropdown control. The edit box allows the user to enter a value. The dropdown allows the user to choose a value from a list.
cannot be contained within a buttonGroup
The values in the list can be specified at design time or dynamically at runtime
You can control the width of the edit box.
You can control the default text
You cannot control the width of the dropdown list.
The dropdown list can display a label, an image or both.
You can use the RibbonComboBoxItems collection to add,remove and modify items at runtime.
<customUI xmlns="http://schemas.microsoft.com/office/2009/07/customui">
<ribbon startFromScratch="true">
<tabs>
<tab id="CustomTab" label="My Tab">
<group id="Group1" label="MyGroup">
<comboBox id="MyCombo"
label="Attributes"
sizeString="AAAAAAAAAAAAAAAAAA"
onChange="ComboBox_OnChange">
<item id="Super" label="First" />
<item id="Next" label="Second" />
<item id="Last" label="Third" />
</comboBox>
</group>
</tab>
</tabs>
</ribbon>
</customUI>
Attributes (properties)
| enabled | (Enabled) "true" | "false" |
| id | |
| idMso | |
| idQ | |
| image | (Image) |
| imageMso | (OfficeImageId) |
| insertAfterMso | |
| insertAfterQ | |
| insertBeforeMso | |
| insertBeforeQ | |
| invalidContentOnDrop | |
| item | |
| keytip | (KeyTip) |
| label | (Label) |
| maxLength | (MaxLength) 1 to 1024 maximum length of entry |
| screentip | (ScreenTip) "my screentip" |
| showImage | (ShowImage) "true" | "false" |
| showItemImage | (ShowItemImage) "true" | "false" whether the images are displayed |
| showLabel | (ShowLabel) "true" | "false" |
| size | "normal" | "large" (large is on 3 rows) |
| sizeString | (SizeString) "AAAAAAAAAAAAAA" |
| supertip | (SuperTip) |
| tag | (Tag) |
| visible | (Visible) "true" | "false" |
| (GenerateMember) | |
| (ImageName) | |
| (Items) | |
| (Locked) | |
| (Modifiers) |
Children
This control can contain the following controls
| item |
C# Events (design-time)
The RibbonComboBox has a TextChanged event that is raised when the user changes the text in the edit box and the user exits the edit box by pressing the Enter key or changing the focus.
This event is also raised when the user selects a different value from the dropdown list.
The ItemsLoading event is raised before the dropdown list is displayed and allows you to change the list immediately before it is shown.
Callbacks (run-time)
| onChange | ComboBox_OnChange - In here we can InvalidateControl"combo") to rewrite and update the list of items |
| getEnabled | ComboBox_OnGetEnabled - |
| getImage | ComboBox_OnGetImage - |
| getImageMso | |
| getItemCount | ComboBox_OnGetItemCount - |
| getItemID | ComboBox_OnGetItemID - |
| getItemImage | ComboBox_OnGetItemImage - |
| getItemLabel | ComboBox_OnGetItemLabel - Called multiple times to populate the list |
| getItemScreentip | ComboBox_OnGetItemScreentip - |
| getItemSupertip | ComboBox_OnGetItemSupertip - |
| getKeytip | ComboBox_OnGetKeytip - |
| getLabel | ComboBox_OnGetLabel - |
| getScreentip | ComboBox_OnGetScreenTip - |
| getShowImage | ComboBox_OnGetShowImage - |
| getShowLabel | ComboBox_OnGetShowLabel - |
| getSupertip | ComboBox_OnGetSupertip - |
| getText | ComboBox_OnGetText - |
| getVisible | ComboBox_OnGetVisible - |
© 2026 Better Solutions Limited. All Rights Reserved. © 2026 Better Solutions Limited TopPrevNext