RibbonBarButton
RibbonBarButton
The RibbonBarButton has a few important properties, which are listed below:
-
Text is the string that the user sees displayed on the RibbonBarButton.
-
Tooltip is a string that appears in the tooltip window when the user hovers the mouse over the RibbonBarButton.
-
Size determines the size of the RibbonBarButton. Use the Size property to specify the item's initial size:
- For small icon: RibbonBarItemSize.Small
- For small icon with text: RibbonBarItemSize.Medium
- For large icon with text: RibbonBarItemSize.Large.
-
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
-
CssClass is the name of a CSS style to be applied to the RibbonBarButton. The style can be declared in the CSS file of the applied skin.