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
© 2024 Better Solutions Limited. All Rights Reserved. © 2024 Better Solutions Limited TopPrevNext