Cheat Sheet

RibbonX For Dummies

From RibbonX For Dummies by John Paul Mueller

RibbonX lets you design and implement Ribbon apps quickly using VBA, VB.NET, or C#. The software will make more sense to you once you understand the most common RibbonX controls.

RibbonX Controls

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
  • Add a Comment
  • Print
  • Share
blog comments powered by Disqus
Advertisement

Inside Dummies.com

Dummies.com Sweepstakes

Win $500. Easy.