Procedura: aggiungere comandi a menu di scelta rapida

In questo argomento viene illustrato come aggiungere controlli a un menu di scelta rapida in un'applicazione di Office utilizzando un componente aggiuntivo a livello di applicazione.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento e di applicazione per Office 2013 e Office 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Per aggiungere controlli al menu di scelta rapida in Office

1. Aggiungere un elemento Barra multifunzione (XML) in un progetto a livello di documento o di applicazione.Per ulteriori informazioni, vedere Procedura: iniziare a personalizzare la barra multifunzione.In

2. Esplora soluzioni, ThisAddin.cs selezionato o ThisAddin.vb.

3. Sulla barra dei menu, scegliere Visualizza, Codice.

   Il file di classe ThisAddin verrà aperto nell'editor di codice.

4. Aggiungere il codice seguente alla classe ThisAddin.Questo codice esegue l'override del metodo CreateRibbonExtensibilityObject e restituisce la classe Ribbon XML all'applicazione di Office.

   Protected Overrides Function CreateRibbonExtensibilityObject() As Microsoft.Office.Core.IRibbonExtensibility
       Return New Ribbon1()
   End Function
   

   protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
   {
         return new Ribbon1();
   }
   

5. In Esplora soluzioni, selezionare il file XML della barra multifunzione.Per impostazione predefinita, il file XML della barra multifunzione è denominato Ribbon1.xml.

6. Sulla barra dei menu, scegliere Visualizza, Codice.

   Il file XML della barra multifunzione viene aperto nell'editor di codice.

7. Nell'editor di codice, aggiungere codice XML che descrive il menu di scelta rapida e il controllo che si desidera aggiungere al menu di scelta rapida.

   Nell'esempio seguente viene aggiunto un pulsante, un controllo e un controllo della raccolta al menu di scelta rapida per un documento di Word.ID del controllo del menu di scelta rapida viene ContextMenuText.Per un elenco completo del controllo ID di collegamento di Office 2010, vedere File della Guida di Office 2010: Identificatori del controllo fluenti dell'interfaccia utente di Office.

   <?xml version="1.0" encoding="UTF-8"?>
   <customUI xmlns="https://schemas.microsoft.com/office/2009/07/customui">
     <contextMenus>
       <contextMenu idMso="ContextMenuText">
         <button id="MyButton" label="My Button" insertBeforeMso="HyperlinkInsert" onAction="GetButtonID" />
         <menu id="MySubMenu" label="My Submenu" >
           <button id="MyButton2" label="Button on submenu" />
         </menu>
         <gallery id="galleryOne" label="My Gallery">
           <item id="item1" imageMso="HappyFace" />
           <item id="item2" imageMso="HappyFace" />
           <item id="item3" imageMso="HappyFace" />
           <item id="item4" imageMso="HappyFace" />
         </gallery>
       </contextMenu>
     </contextMenus>
   </customUI>
   

8. In Esplora soluzioni, scegliere MyRibbon.cs o MyRibbon.vb.

9. Aggiungere un metodo di callback alla classe Ribbon1 per ogni controllo che si desidera gestire.

   Il seguente metodo di callback gestisce il pulsante Pulsante.Questo codice aggiunge una stringa al documento attivo nella posizione corrente del cursore.

   Public Sub GetButtonID(ByVal control As Office.IRibbonControl)
       Dim currentRange As Word.Range = Globals.ThisAddIn.Application.Selection.Range
       currentRange.Text = "This text was added by the context menu named My Button."
   End Sub
   

   public void GetButtonID(Office.IRibbonControl control)
   {
       Microsoft.Office.Interop.Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
       currentRange.Text = "This text was added by the context menu named My Button.";
   }
   

Vedere anche

Attività

Procedura dettagliata: creazione di menu di scelta rapida per segnalibri

Concetti

Parametri facoltativi nelle soluzioni Office

Altre risorse

Personalizzazione dell'interfaccia utente di Office

Personalizzazione di menu di scelta rapida in Office 2010