Kısayol menülerine komut ekleme

Bu konu başlığında, VSTO Eklentisi kullanarak Office uygulaması bir kısayol menüsüne komutların nasıl ekleneceği gösterilmektedir.

Şunlar için geçerlidir: Bu konudaki bilgiler belge düzeyi projeler ve VSTO Eklenti projeleri için geçerlidir. Bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Office'te kısayol menülerine komut eklemek için

  1. Belge düzeyine veya VSTO Eklentisi projesine Şerit XML öğesi ekleyin. Daha fazla bilgi için bkz . Nasıl yapılır: Şeridi özelleştirmeye başlama. İçinde

  2. Çözüm Gezgini ThisAddin.cs veya ThisAddin.vb seçin.

  3. Menü çubuğunda Kodu Görüntüle'yi>seçin.

    ThisAddin sınıf dosyası Kod Düzenleyicisi'nde açılır.

  4. ThisAddin sınıfına aşağıdaki kodu ekleyin. Bu kod yöntemini geçersiz kılar CreateRibbonExtensibilityObject ve Şerit XML sınıfını Office uygulaması'ye döndürür.

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
    {
          return new Ribbon1();
    }
    
  5. Çözüm Gezgini şerit XML dosyasını seçin. Varsayılan olarak, Şerit XML dosyası Ribbon1.xml olarak adlandırılır.

  6. Menü çubuğunda Kodu Görüntüle'yi>seçin.

    Şerit xml dosyası Kod Düzenleyicisi'nde açılır.

  7. Kod Düzenleyicisi'nde, kısayol menüsünü ve kısayol menüsüne eklemek istediğiniz denetimi açıklayan XML ekleyin.

    Aşağıdaki örnek, word belgesinin kısayol menüsüne bir düğme, menü ve galeri denetimi ekler. Bu kısayol menüsünün denetim kimliği ContextMenuText'tir. Office 2010 kısayol denetim kimliklerinin tam listesi için bkz . Office 2010 yardım dosyaları: Office akıcı kullanıcı arabirimi denetim tanımlayıcıları.

    <?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. Çözüm Gezgini'da MyRibbon.cs veya MyRibbon.vb'ı seçin.

  9. İşlemek istediğiniz her denetim için sınıfına Ribbon1 bir geri çağırma yöntemi ekleyin.

    Aşağıdaki geri çağırma yöntemi Düğmem düğmesini işler. Bu kod, imlecin geçerli konumundaki etkin belgeye bir dize ekler.

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