Aggiungere comandi ai menu di scelta rapida

  • Articolo

In questo argomento viene illustrato come aggiungere comandi a un menu di scelta rapida in un app Office lication usando un componente aggiuntivo VSTO.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento e ai progetti di componente aggiuntivo VSTO. Vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Per aggiungere comandi al menu di scelta rapida in Office

  1. Aggiungere un elemento Barra multifunzione (XML) in un progetto di componente aggiuntivo VSTO o a livello di documento. Per altre informazioni, vedere Procedura: Introduzione alla personalizzazione della barra multifunzione. In

  2. Esplora soluzioniselezionare ThisAddin.cs o ThisAddin.vb.

  3. Sulla barra dei menu scegliere Visualizza>Codice.

    Il file di classe ThisAddin viene 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 XML della barra multifunzione all'applicazione Office.

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

  5. In Esplora soluzioniselezionare 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 descriva il menu di scelta rapida e il controllo da 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. L'ID del controllo di questo menu di scelta rapida è ContextMenuText. Per un elenco completo degli ID del controllo di scelta rapida di Office 2010, vedere File della Guida di Office 2010: identificatori di controllo dell'interfaccia utente fluent di Office.

    <?xml version="1.0" encoding="UTF-8"?>
<customUI xmlns="http://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 soluzioniscegliere MyRibbon.cs o MyRibbon.vb.

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

    Il metodo di callback seguente consente di gestire il pulsante My Button . Questo codice aggiunge una stringa al documento attivo nella posizione corrente del cursore.

    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.";
}

Contenuto correlato