PrimaryItem - Menu - Control

Remark: All functions in this chapter refer to Access / Office 2010.  

The menu element of primaryItem Controls has following attributes different to the standard Ribbon Menu - Control.

The menu control can have one or more menuGroup elements.

The menuGroup element can have one or more menu Buttons, menu ToggleButtons, menu checkboxes or menu elements.

 

 

 

The corresponding XML Ribbon file:

<customUI xmlns="http://schemas.microsoft.com/office/2009/07/customui">
   <ribbon startFromScratch="false">
      <!-- Ribbon XML -->
   </ribbon>
  <backstage>
    <tab  id="btab1" label="Tab Label 1. ">
      <firstColumn>
       <taskFormGroup id="MytskfrmGroup1" label="Label taskFormGroup 1. Column" helperText="Helpertext for 1. Column">
           <category id="cat1" label="Label 1. Category" >
            <task id="tsk1" label="Label 1.0 Task" description="Description 1.0 Task" imageMso="HappyFace">
             <group id="myGroup21" label="Label 1. Group" helperText="Style:= normal"  style="normal">
                <primaryItem>
                  <menu id="mnu1" imageMso="AppointmentColorDialog" label="HeroMenĂ¼">
                    <menuGroup id="myMenuGroup1" label="Label: menuGroup 1">
                      <button id="btnMGrp" label="Button in MenuGroup 1"/>
                      <checkBox id="chkMGrp1" label="Checkbox in Menugroup 1"/>
                      <menu id="mnu2" label="Label: Menu II" imageMso="_1">
                        <menuGroup id="myMenuGroup2" label="Label: menuGroup 2">
                          <button id="btnMGrp2" label="Button in MenuGroup 2"/>
                        </menuGroup>
                      </menu>
                    </menuGroup>
                  </menu>
                </primaryItem>
                <topItems>
                    <labelControl id="lblInForm1" label="topItems:"/>
                    <button id="btnInForm1" label="Button 1."/>
                </topItems>               
                <bottomItems>
                    <labelControl id="lblInForm2" label="bottomItems:"/>
                    <button id="btnInForm2" label="Button 2."/>
                    <button id="btnInForm3" label="Button 3."/>
                </bottomItems>
             </group>
             <group id="myGroup22" label="Label 2. Group" helperText="Style:= warning" style="warning"/>
             <group id="myGroup23" label="Label 3. Group" helperText="Style:= error" style="error"/>
            </task>
               <task id="tsk1a" label="Label 1.1. Task" description="Description 1.1 Task" imageMso="AppointmentColorDialog">
              <group id="myGroup24"style="normal"/>
            </task>
           </category>
         <category id="cat2" label="Label 2. Category">
            <task id="tsk2" label="Label 2.0 Task" description="Description 2.0 Task">
              <group id="myGroup25"style="normal"/>
            </task>
           </category>
       </taskFormGroup>
     </firstColumn>
    </tab>
    <button id="btnBackstage1" label="Label Backstage Button" imageMso="HappyFace" onAction="OnActionButton"/>
  </backstage>
</customUI>

 

Attributes and Callbacks:

Attributes: enabled, id, idMso, idQ, image, imageMso, keytip, label,
                 screentip, supertip, tag, visible

Callbacks: getEnabled, getImage, getKeytip, getLabel,
                getScreentip, getSupertip, getVisible

Attributes:id, itemSize, idQ, label, tag

Callbacks: getLabel 

Attributes: description, enabled, id, idMso, idQ, image, imageMso,
                 isDefinitive, keytip, label, tag, visible

Callbacks: getImage, getDescription, getEnabled, getKeytip,
                getLabel, getVisible, onAction 

Attributes: description, enabled, id, idMso, idQ, image, imageMso,
                 keytip, label, tag, visible

Callbacks: getImage, getDescription, getEnabled, getKeytip,
                getLabel, getVisible, getPressed, onAction

Attributes:description, enabled, id, idMso, idQ, keytip, label, tag, visible

Callbacks: getDescription, getEnabled, getKeytip, getLabel,
                getPressed, getVisible, onAction


You can also find this sample in sample database "Backstage View".