Bagikan melalui

Panduan: Membuat tab kustom dengan menggunakan XML Pita

  • Artikel

Panduan ini menunjukkan cara membuat tab Pita kustom dengan menggunakan item Pita (XML).

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek tingkat dokumen dan proyek Add-in VSTO untuk aplikasi berikut: Excel; InfoPath 2013 dan InfoPath 2010; Outlook; Powerpoint; Proyek; Visio; Kata. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Panduan ini mengilustrasikan tugas-tugas berikut:

  • Menambahkan tombol ke tab Add-In . Tab Add-In adalah tab default yang ditentukan dalam file XML Pita.

  • Mengotomatiskan Microsoft Office Word dengan menggunakan tombol pada tab Add-In .

Catatan

Komputer Anda mungkin memperlihatkan nama atau lokasi yang berbeda untuk beberapa elemen antarmuka pengguna Visual Studio dalam petunjuk berikut. Edisi Visual Studio yang Anda miliki dan setelan yang Anda gunakan menentukan elemen-elemen ini. Untuk informasi selengkapnya, lihat Mempersonalisasi IDE Visual Studio.

Prasyarat

Anda memerlukan komponen berikut untuk menyelesaikan panduan ini:

Membuat proyek

Langkah pertama adalah membuat proyek Add-in Word VSTO. Anda nantinya akan mengkustomisasi tab Add-In dari dokumen ini.

Untuk membuat proyek baru

  1. Buat proyek Add-in Word dengan nama MyRibbonAddIn.

    Untuk informasi selengkapnya, lihat Cara: Membuat proyek Office di Visual Studio.

    Visual Studio membuka file kode ThisAddIn.cs atau ThisAddIn.vb dan menambahkan proyek MyRibbonAddIn ke Penjelajah Solusi.

Membuat tab Add-in VSTO

Untuk membuat tab Add-In , tambahkan item Pita (XML) ke proyek Anda. Nanti dalam panduan ini, Anda akan menambahkan beberapa tombol ke tab ini.

Untuk membuat tab Add-in

  1. Pada menu Proyek, klik Tambahkan Item Baru.

  2. Dalam kotak dialog Tambahkan Item Baru, pilih Pita (XML).

  3. Ubah nama Pita baru menjadi MyRibbon, dan klik Tambahkan.

    File MyRibbon.cs atau MyRibbon.vb terbuka di perancang. File XML yang bernama MyRibbon.xml juga ditambahkan ke proyek Anda.

  4. Di Penjelajah Solusi, klik kanan ThisAddin.cs atau ThisAddin.vb, lalu klik Tampilkan Kode.

  5. 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 MyRibbon();
}

  6. Di Penjelajah Solusi, klik kanan proyek MyRibbonAddIn lalu klik Bangun. Verifikasi bahwa proyek dibangun tanpa kesalahan.

Menambahkan tombol ke tab Add-in

Tujuan untuk Add-in VSTO ini adalah untuk memberi pengguna cara untuk menambahkan teks boilerplate dan tabel tertentu ke dokumen aktif. Untuk menyediakan antarmuka pengguna, tambahkan dua tombol ke tab Add-In dengan memodifikasi file XML Pita. Nanti dalam panduan ini, Anda akan menentukan metode panggilan balik untuk tombol. Untuk informasi selengkapnya tentang file XML Pita, lihat XML Pita.

Untuk menambahkan tombol ke tab Add-in

  1. Di Penjelajah Solusi, klik kanan MyRibbon.xml lalu klik Buka.

  2. Ganti konten elemen tab dengan XML berikut. XML ini mengubah label grup kontrol default ke Konten, dan menambahkan dua tombol baru dengan label Sisipkan Teks dan Sisipkan Tabel.

    <tab idMso="TabAddIns">
    <group id="ContentGroup" label="Content">
        <button id="textButton" label="Insert Text"
             screentip="Text" onAction="OnTextButton"
             supertip="Inserts text at the cursor location."/>
        <button id="tableButton" label="Insert Table"
             screentip="Table" onAction="OnTableButton"
             supertip="Inserts a table at the cursor location."/>
    </group>
</tab>

Mengotomatiskan dokumen dengan menggunakan tombol

Anda harus menambahkan onAction metode panggilan balik untuk tombol Sisipkan Teks dan Sisipkan Tabel untuk melakukan tindakan saat pengguna mengkliknya. Untuk informasi selengkapnya tentang metode panggilan balik untuk kontrol Pita, lihat XML Pita.

Untuk menambahkan metode panggilan balik untuk tombol

  1. Di Penjelajah Solusi, klik kanan MyRibbon.cs atau MyRibbon.vb, lalu klik Buka.

  2. Tambahkan kode berikut ke bagian atas file MyRibbon.cs atau MyRibbon.vb . Kode ini membuat alias untuk Microsoft.Office.Interop.Word namespace.

    using Word = Microsoft.Office.Interop.Word;

  3. Tambahkan metode berikut ke kelas MyRibbon. Ini adalah metode panggilan balik untuk tombol Sisipkan Teks yang menambahkan string ke dokumen aktif di lokasi kursor saat ini.

    public void OnTextButton(Office.IRibbonControl control)
{
    Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
    currentRange.Text = "This text was added by the Ribbon.";
}

  4. Tambahkan metode berikut ke kelas MyRibbon. Ini adalah metode panggilan balik untuk tombol Sisipkan Tabel yang menambahkan tabel ke dokumen aktif di lokasi kursor saat ini.

    public void OnTableButton(Office.IRibbonControl control)
{
    object missing = System.Type.Missing;
    Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
    Word.Table newTable = Globals.ThisAddIn.Application.ActiveDocument.Tables.Add(
    currentRange, 3, 4, ref missing, ref missing);

    // Get all of the borders except for the diagonal borders.
    Word.Border[] borders = new Word.Border[6];
    borders[0] = newTable.Borders[Word.WdBorderType.wdBorderLeft];
    borders[1] = newTable.Borders[Word.WdBorderType.wdBorderRight];
    borders[2] = newTable.Borders[Word.WdBorderType.wdBorderTop];
    borders[3] = newTable.Borders[Word.WdBorderType.wdBorderBottom];
    borders[4] = newTable.Borders[Word.WdBorderType.wdBorderHorizontal];
    borders[5] = newTable.Borders[Word.WdBorderType.wdBorderVertical];

    // Format each of the borders.
    foreach (Word.Border border in borders)
    {
        border.LineStyle = Word.WdLineStyle.wdLineStyleSingle;
        border.Color = Word.WdColor.wdColorBlue;
    }
}

Menguji Add-in VSTO

Saat Anda menjalankan proyek, Word terbuka dan tab bernama Add-In muncul di pita. Klik tombol Sisipkan Teks dan Sisipkan Tabel pada tab Add-In untuk menguji kode.

Untuk menguji Add-in VSTO Anda

  1. Tekan F5 untuk menjalankan proyek Anda.

  2. Konfirmasikan bahwa tab Add-In terlihat pada pita.

  3. Klik tab Add-In .

  4. Konfirmasikan bahwa grup Konten terlihat pada pita.

  5. Klik tombol Sisipkan Teks di grup Konten .

    String ditambahkan ke dokumen di lokasi kursor saat ini.

  6. Klik tombol Sisipkan Tabel di grup Konten .

    Tabel ditambahkan ke dokumen di lokasi kursor saat ini.

Langkah berikutnya

Anda bisa mempelajari selengkapnya tentang cara mengkustomisasi UI Office dari topik-topik ini:

  • Kustomisasi pita aplikasi Office likasi yang berbeda. Untuk informasi selengkapnya tentang aplikasi yang mendukung kustomisasi pita, lihat Gambaran umum pita.

  • Kustomisasi pita aplikasi Office likasi dengan menggunakan Perancang Pita. Untuk informasi selengkapnya, lihat Desainer Pita.

  • Buat panel tindakan kustom. Untuk informasi selengkapnya, lihat Gambaran umum panel Tindakan.

  • Kustomisasi UI Microsoft Office Outlook dengan menggunakan Wilayah Formulir Outlook. Untuk informasi selengkapnya, lihat Panduan: Mendesain wilayah formulir Outlook.

Konten terkait