The tool’s ribbon command can be set to only open a drop-down menu, or alternatively, set with dual functionality, where clicking the bottom half of the button opens a drop-down menu with sub-options, while clicking the upper half activates the “main” tool option, which will also be listed first in the drop-down menu.
To determine button functionality:
§ Set the value of the <Ribbon>’s splitButton attribute:
· splitButton = “0” - Button only opens a drop-down menu.
· splitButton = “1” (Default) Button is split into two halves with the functionality described above.
To format the drop-down menu:
§ Use the <Submenu> child elements:
· <Separator> - Creates horizontal divider lines in the drop-down menu.
· <GroupTitle> - Creates headings in the drop-down menu.
<Tool caption="Data Analysis" id="ACO009" Path="MyToolFolder\MyTool.html">
<Icon path="MyAddon.ico"/>
<Ribbon Show="1" Toggle="0" splitButton="1">
<Category id="AnalysisTools" caption="Graphs"/>
<Panel id="MyGroupID" caption="Analysis" />
<ToolTip title=“My Tooltip” description="Tool for demonstrating add-on use"/>
<Submenu>
<GroupTitle>MyGroup1</GroupTitle>
<Item caption="My SubmenuOption1" id="MySubId1" Path="MySubmenuToolFolder\MySubmenuTool1.html">
<ToolTip title="My Tooltip1" description="Tool for demonstrating submenu use"/>
<Icon path="MySubmenuOption1.ico"/>
</Item>
<Separator></Separator>
<Item caption="My SubmenuOption2" id="MySubId2" Path="MySubmenuToolFolder\MySubmenuTool2.html">
<ToolTip title="My Tooltip2" description="Tool for demonstrating submenu use"/>
<Icon path="MySubmenuOption2.ico"/>
</Item>
<GroupTitle>MyGroup2</GroupTitle>
<Item caption="My SubmenuOption3" id="MySubId3" Path="MySubmenuToolFolder\MySubmenuTool3.html">
<ToolTip title="My Tooltip3" description="Tool for demonstrating submenu use"/>
<Icon path="MySubmenuOption3.ico"/>
</Item>
</Submenu>
</Ribbon>
</Tool>