By John Paul Mueller

The following table runs through many of the controls on RibbonX and what they do. The list also contains the most common callbacks and attributes — but not every callback or attribute that the control supports.

Control Description Common Callbacks Common Attributes
box Groups the controls together within a group. You can place any
control within a box and flow the set of controls either
horizontally or vertically.
getVisible boxStyle, id, idQ, insertAfterMso, insertAfterQ,
insertBeforeMso, insertBeforeQ, visible
button Provides a basic execution function. Click the button and
something happens within Office.
getDescription, getEnabled, getImage, getLabel, getSize,
getVisible, onAction
description, enabled, id, idMso, idQ, image, imageMso,
insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ,
label, size, visible
buttonGroup Groups various types of buttons together. The buttons appear
within a box on-screen and Office places them closer together to
show that they’re associated in some way.
getVisible id, idQ, insertAfterMso, insertAfterQ, insertBeforeMso,
insertBeforeQ, visible
checkBox Provides a basic selection function. The user enables or
disables an option by clicking the control.
getDescription, getEnabled, getLabel, getPressed, getVisible,
onAction
description, enabled, id, idMso, idQ, imageMso, insertAfterMso,
insertAfterQ, insertBeforeMso, insertBeforeQ, visible
comboBox Displays a list of options for the user. You create the list of
options using the item control. When working with a comboBox
control, the user can also type a value that doesn’t appear in the
list (a dropDown control requires the user to choose one of the
options on the list).
getEnabled, getImage, getItemCount, getItemId, getItemImage,
getItemLabel, getLabel, getText, getVisible, onChange
enabled, id, idMso, idQ, image, imageMso, insertAfterMso,
insertAfterQ, insertBeforeMso, insertBeforeQ, label, maxLength,
visible
dropDown Displays a list of options for the user. You create the list of
options using the item or button control. The user must choose one
of the options in the list you provide. When the user chooses a
button rather than an item control, Office executes the requested
action instead of choosing the desired option.
getEnabled, getImage, getItemCount, getItemId, getItemImage,
getItemLabel, getLabel, getText, getVisible, onAction
enabled, id, idMso, idQ, image, imageMso, insertAfterMso,
insertAfterQ, insertBeforeMso, insertBeforeQ, label, maxLength,
visible
dynamicMenu Defines a menu that you create at runtime, rather than during
design time. The menu contents can change to meet specific
needs.
getContent, getDescription, getEnabled, getImage, getLabel,
getSize, getVisible
description, enabled, id, idMso, idQ, image, imageMso,
insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ,
label, size, visible
editBox Lets the user enter plain text into the Ribbon. You might use
this feature to perform a task such as searching. Use this control
for any input that you can’t define through using some other
control.
getEnabled, getImage, getLabel, getText, getVisible,
onChange
enabled, id, idMso, idQ, image, imageMso, insertAfterMso,
insertAfterQ, insertBeforeMso, insertBeforeQ, label, visible
gallery Displays a group of controls in a drop-down structure to save
space on the Ribbon. Word uses such a grouping in the Styles group
of the Home tab. A gallery control differs from other grouping
controls by providing a drop-down list that you can control in
various ways.
getDescription, getEnabled, getImage, getItemCount,
getItemHeight, getItemId, getItemImage, getItemLabel, getItemWidth,
getLabel, getSelectedItemId, getSelectedItemIndex, getSize,
onAction
columns, description, enabled, id, idMso, idQ, image, imageMso,
insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ,
itemHeight, itemWidth, label, rows, size, visible
labelControl Creates a label on-screen. You can use this control to label
control groups or other elements that don’t easily lend themselves
to other forms of identification. The user can’t interact with the
labels you provide, only read them.
getEnabled, getLabel, getVisible enabled, id, idMso, idQ, image, imageMso, insertAfterMso,
insertAfterQ, insertBeforeMso, insertBeforeQ, label, visible
menu Defines a menu that you create at design time. The menu can
contain controls such as the button and checkbox. You can use a
menu in standalone mode, or as part of a splitButton control. Use
the menuSeparator control to place separations between menu
elements.
getDescription, getEnabled, getImage, getLabel, getSize,
getVisible,
description, enabled, id, idMso, idQ, image, imageMso,
insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ,
itemSize, label, size, visible
menuSeparator Provides a means of separating elements within any control
group.
getTitle id, idQ, insertAfterMso, insertAfterQ, insertBeforeMso,
insertBeforeQ, title
splitButton Creates a button that has a default action and a list of
alternative options. One of the best examples of the split button
is the Paste button in the Clipboard group on the Home tab. You
must include a button or toggleButton for the default control. The
optional actions appear within a menu control, where you can add
button or toggleButton controls.
getEnabled, getSize, getVisible enabled, id, idMso, idQ, insertAfterMso, insertAfterQ,
insertBeforeMso, insertBeforeQ, size, visible
toggleButton Provides a combination of a checkBox and a button control. The
user selects a state and performs an action by clicking the
toggleButton.
getDescription, getEnabled, getImage, getLabel, getPressed,
getSize, getVisible, onAction
description, enabled, id, idMso, idQ, image, imageMso,
insertAfterMso, insertAfterQ, insertBeforeMso, insertBeforeQ,
label, size, visible