The RibbonBarToggleButton has a few important properties, which are listed below:
Text is the string that the user sees displayed on the RibbonBarSplitButton.
ToolTip is the text of the tooltip that appears when the user hovers the mouse over the button.
Setting the tooltip can enable an accessibility feature: Special accessibility readers like JAWS can pronounce the tooltip of the highlighted item.
Size determines the size of the RibbonBarToggleButton. The value can be “Large”, “Medium” or “Small”.
ImageAltText specifies the alternate text of the image.
ImageUrlLarge specifies a custom image that will be used when the item has Size = RibbonBarItemSize.Large.
ImageUrl specifies a custom image that will be used when the item has Size = RibbonBarItemSize.Small or RibbonBarItemSize.Medium.
ImageRenderingMode determines the rendering mode of the image. In case ImageRenderingMode is not explicitly set (meaning RibbonBar's ImageRenderingMode is Auto), it's considered as follows:
- If ImageUrl is set and ImageUrlLarge is not set: the mode is Clip
- Any other case: Dual
Toggled represents the state of the RibbonBarToggleButton - “true” when the button is toggled and “false” when it is not.
CssClass is the name of a CSS style to be applied to the RibbonBarSplitButton. The style can be declared in the CSS file of the applied skin.