Bagikan melalui


Panduan: Membuat Add-in VSTO pertama Anda untuk PowerPoint

Panduan ini memperlihatkan kepada Anda cara membuat Add-in VSTO untuk Microsoft Office PowerPoint. Fitur yang Anda buat dalam solusi semacam ini tersedia untuk aplikasi itu sendiri, terlepas dari presentasi mana yang terbuka. Untuk informasi selengkapnya, lihat Gambaran umum pengembangan solusi Office (VSTO).

Berlaku untuk: Informasi dalam topik ini berlaku untuk proyek Add-in VSTO untuk PowerPoint. Untuk informasi selengkapnya, lihat Fitur yang tersedia berdasarkan aplikasi Office likasi dan jenis proyek.

Panduan ini mengilustrasikan tugas-tugas berikut:

  • Membuat proyek Add-in PowerPoint VSTO untuk PowerPoint.

  • Menulis kode yang menggunakan model objek PowerPoint untuk menambahkan kotak teks ke setiap slide baru.

  • Membangun dan menjalankan proyek untuk mengujinya.

  • Membersihkan proyek sehingga Add-in VSTO tidak lagi berjalan secara otomatis di komputer pengembangan Anda.

    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.

Prasyarat

Anda memerlukan komponen berikut untuk menyelesaikan panduan ini:

Membuat proyek

Untuk membuat proyek baru

  1. Mulai Visual Studio.

  2. Pada menu File, arahkan ke Baru, lalu klik Proyek.

  3. Di panel templat, perluas Visual C# atau Visual Basic, lalu perluas Office/SharePoint.

  4. Di bawah simpul Office/SharePoint yang diperluas, pilih simpul Add-in Office.

  5. Dalam daftar templat proyek, pilih proyek Add-in PowerPoint VSTO.

  6. Dalam kotak Nama , ketik FirstPowerPointAddIn.

  7. Klik OK.

    Visual Studio membuat proyek FirstPowerPointAddIn dan membuka file kode ThisAddIn di editor.

Menulis kode yang menambahkan teks ke setiap slide baru

Selanjutnya, tambahkan kode ke file kode ThisAddIn. Kode baru menggunakan model objek PowerPoint untuk menambahkan kotak teks ke setiap slide baru. Secara default, file kode ThisAddIn berisi kode yang dihasilkan berikut:

  • Definisi parsial kelas ThisAddIn . Kelas ini menyediakan titik masuk untuk kode Anda dan menyediakan akses ke model objek PowerPoint. Untuk informasi selengkapnya, lihat Add-in VsTO Program. ThisAddIn Sisa kelas ditentukan dalam file kode tersembunyi yang tidak boleh Anda ubah.

  • Penanganan ThisAddIn_Startup aktivitas dan ThisAddIn_Shutdown . Penanganan aktivitas ini dipanggil saat PowerPoint memuat dan membongkar Add-in VSTO Anda. Gunakan penanganan aktivitas ini untuk menginisialisasi Add-in VSTO Anda saat dimuat, dan untuk membersihkan sumber daya yang digunakan oleh Add-in VSTO Anda saat dibongkar. Untuk informasi selengkapnya, lihat Peristiwa di proyek Office.

Untuk menambahkan kotak teks ke setiap slide baru

  1. Dalam file kode ThisAddIn, tambahkan kode berikut ke ThisAddIn kelas . Kode ini mendefinisikan penanganan aktivitas untuk peristiwa Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide dari objek Aplikasi .

    Saat pengguna menambahkan slide baru ke presentasi aktif, penanganan aktivitas ini menambahkan kotak teks ke bagian atas slide baru, dan menambahkan beberapa teks ke kotak teks.

    void Application_PresentationNewSlide(PowerPoint.Slide Sld)
    {
        PowerPoint.Shape textBox = Sld.Shapes.AddTextbox(
            Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50);
        textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.");
    }
    
  2. Jika Anda menggunakan C#, tambahkan kode berikut ke penanganan ThisAddIn_Startup aktivitas. Kode ini diperlukan untuk menghubungkan Application_PresentationNewSlide penanganan aktivitas dengan peristiwa Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide .

    this.Application.PresentationNewSlide += 
        new PowerPoint.EApplication_PresentationNewSlideEventHandler(
        Application_PresentationNewSlide);
    

    Untuk mengubah setiap slide baru, contoh kode sebelumnya menggunakan objek berikut:

Menguji proyek

Saat Anda membuat dan menjalankan proyek, verifikasi bahwa kotak teks muncul di slide baru yang Anda tambahkan ke presentasi.

Untuk menguji proyek

  1. Tekan F5 untuk membangun dan menjalankan proyek Anda.

    Saat Anda membangun proyek, kode dikompilasi ke dalam rakitan yang dimasukkan ke dalam folder output build untuk proyek. Visual Studio juga membuat sekumpulan entri registri yang memungkinkan PowerPoint menemukan dan memuat Add-in VSTO, dan mengonfigurasi pengaturan keamanan pada komputer pengembangan untuk mengaktifkan Add-in VSTO untuk dijalankan. Untuk informasi selengkapnya, lihat Membangun solusi Office.

  2. Di PowerPoint, tambahkan slide baru ke presentasi aktif.

  3. Verifikasi bahwa teks berikut ditambahkan ke kotak teks baru di bagian atas slide.

    Teks ini ditambahkan dengan menggunakan kode.

  4. Tutup PowerPoint.

Membersihkan proyek

Setelah Anda selesai mengembangkan proyek, hapus rakitan Add-in VSTO, entri registri, dan pengaturan keamanan dari komputer pengembangan Anda. Jika tidak, Add-in VSTO akan berjalan setiap kali Anda membuka PowerPoint di komputer pengembangan.

Untuk membersihkan proyek Anda

  1. Di Visual Studio, pada menu Build , klik Bersihkan Solusi.

Langkah berikutnya

Sekarang setelah Anda membuat Add-in VSTO dasar untuk PowerPoint, Anda bisa mempelajari selengkapnya tentang cara mengembangkan Add-in VSTO dari topik ini:

  • Tugas pemrograman umum yang bisa Anda lakukan di Add-in VSTO untuk PowerPoint. Untuk informasi selengkapnya, lihat Add-in VsTO Program.

  • Menggunakan model objek PowerPoint. Untuk informasi selengkapnya, lihat Solusi PowerPoint.

  • Mengkustomisasi UI PowerPoint, misalnya, dengan menambahkan tab kustom ke pita atau membuat panel tugas kustom Anda sendiri. Untuk informasi selengkapnya, lihat Kustomisasi Office UI.

  • Membangun dan men-debug Add-in VSTO untuk PowerPoint. Untuk informasi selengkapnya, lihat Membangun solusi Office.

  • Menyebarkan Add-in VSTO untuk PowerPoint. Untuk informasi selengkapnya, lihat Menyebarkan solusi Office.