group
In the object model this is RibbonGroup
represents a group of controls on a tab.
You can have multiple groups on a tab.
Each group should have an icon for when the width of the group gets reduced
Displaying an ampersand
label = "Copy && Paste"
In addition to specifying a label you can display an icon in the bottom-right corner called a DialogLauncher
This icon raises an event that you can handle
There is a DialogLauncherClick event that is raised when the user clicks the icon.
You cannot add controls directly to a tab they must be added to a group.
You can also specify an image and label but these elements are only displayed if the user adds the dialog launcher to the Quick Access Toolbar.
<customUI xmlns="http://schemas.microsoft.com/office/2009/07/customui">
<ribbon startFromScratch="true">
<tabs>
<tab id="CustomTab" label="My Tab">
<group id="Group1" label="Group 1" visible="true">
<button id="button1"
label="Button..."
size="large"
imageMso="ErrorChecking"/>
</group>
<group id="Group2" label="Group 2">
<button id="button2"
label="Button..."
size="large"
visible="false"
imageMso="LeaveReader"/>
</group>
<group id="Group3" label="Group 3">
<button id="button3"
label="Button..."
size="large"
imageMso="OutlookTaskCreate"/>
</group>
</tab>
</tabs>
</ribbon>
</customUI>
Attributes (properties)
| autoSize | "true" | "false" - Does not control "full" or "miniumum" only the "in-between" scaling. | |
| enabled | (Enabled) "true" | "false" | |
| id | (Id) | |
| idMso | | |
| idQ | | |
| image | | |
| imageMso | This has to be a built-in control id | |
| insertAfterMso | | |
| insertAfterQ | | |
| insertBeforeMso | | |
| insertBeforeQ | | |
| keytip | (KeyTip) | |
| label | (Label) | |
| screentip | | |
| showLabel | "true" | "false" | |
| size | | |
| supertip | | |
| tag | (Tag) | |
| visible | (Visible) "true" | "false" | |
| | (DialogLauncher) | |
| | (GenerateMember) | |
| | (Locked) | |
| | (Modifiers) | |
| | (Name) | |
| | (Position) | |
Children
| box | | |
| button | | |
| buttonGroup | | |
| checkBox | | |
| comboBox | | |
| control | | |
| dialogBoxLauncher | | |
| dropDown | | |
| editBox | | |
| gallery | | |
| labelControl | | |
| menu | | |
| separator | | |
| splitButton | | |
| toggleButton | | |
Callbacks (run-time)
| getImage | customUI14.xsd only | |
| getImageMso | | |
| getKeytip | | |
| getLabel | | |
| getScreentip | | |
| getSupertip | | |
| getVisible | | |
' VBA
Public Sub Group_OnGetLabel( _
ByRef control As Office.IRibbonControl, _
ByRef Label As Variant)
Label = "my dynamic label"
End Sub
' VBA
Public Sub Group_OnGetVisible( _
ByRef control As Office.IRibbonControl, _
ByRef Visible As Boolean)
End Sub
© 2025 Better Solutions Limited. All Rights Reserved. © 2025 Better Solutions Limited TopPrevNext