Bagikan melalui


Menambahkan perintah ke menu pintasan

Topik ini menunjukkan cara menambahkan perintah ke menu pintasan dalam aplikasi Office likasi dengan menggunakan Add-in VSTO.

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen dan proyek Add-in VSTO. Lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Untuk menambahkan perintah ke menu pintasan di Office

  1. Tambahkan item XML Pita ke tingkat dokumen atau proyek Add-in VSTO. Untuk informasi selengkapnya, lihat Cara: Mulai mengkustomisasi Pita. Dalam

  2. Penjelajah Solusi, pilih ThisAddin.cs atau ThisAddin.vb.

  3. Pada bilah menu, pilih Tampilkan>Kode.

    File kelas ThisAddin terbuka di Editor Kode.

  4. Tambahkan kode berikut ke kelas ThisAddin . Kode ini mengambil CreateRibbonExtensibilityObject alih metode dan mengembalikan kelas XML Pita ke aplikasi Office likasi.

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
    {
          return new Ribbon1();
    }
    
  5. Di Penjelajah Solusi, pilih file XML Pita. Secara default, file XML Pita diberi nama Ribbon1.xml.

  6. Pada bilah menu, pilih Tampilkan>Kode.

    File xml Pita terbuka di Editor Kode.

  7. Di Editor Kode, tambahkan XML yang menjelaskan menu pintasan dan kontrol yang ingin Anda tambahkan ke menu pintasan.

    Contoh berikut menambahkan tombol, menu, dan kontrol galeri ke menu pintasan untuk dokumen word. ID kontrol menu pintasan ini adalah ContextMenuText. Untuk daftar lengkap ID kontrol pintasan Office 2010, lihat File bantuan Office 2010: Pengidentifikasi kontrol antarmuka pengguna Office yang fasih.

    <?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. Di Penjelajah Solusi, pilih MyRibbon.cs atau MyRibbon.vb.

  9. Tambahkan metode panggilan balik ke Ribbon1 kelas untuk setiap kontrol yang ingin Anda tangani.

    Metode panggilan balik berikut menangani tombol Tombol Saya. Kode ini menambahkan string ke dokumen aktif di lokasi kursor saat ini.

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