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  
imageMsoThis 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)

getImagecustomUI14.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