Aracılığıyla paylaş

İzlenecek yol: PowerPoint için ilk VSTO Eklentinizi oluşturma

  • Makale

Bu kılavuzda, Microsoft Office PowerPoint için VSTO Eklentisi oluşturma gösterilmektedir. Bu tür bir çözümde oluşturduğunuz özellikler, hangi sunuların açık olduğuna bakılmaksızın uygulamanın kendisi tarafından kullanılabilir. Daha fazla bilgi için bkz . Office çözümleri geliştirmeye genel bakış (VSTO).

Şunlar için geçerlidir: Bu konudaki bilgiler PowerPoint için VSTO Eklenti projeleri için geçerlidir. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Bu izlenecek yol aşağıdaki görevleri gösterir:

  • PowerPoint için PowerPoint VSTO Eklenti projesi oluşturma.

  • Her yeni slayda metin kutusu eklemek için PowerPoint'in nesne modelini kullanan kod yazma.

  • Test etmek için projeyi oluşturma ve çalıştırma.

  • VSTO Eklentisinin artık geliştirme bilgisayarınızda otomatik olarak çalışmaması için projeyi temizleme.

    Not

    Bilgisayarınız, aşağıdaki yönergelerde yer alan Visual Studio kullanıcı arabirimi öğelerinden bazıları için farklı adlar veya konumlar gösterebilir. Sahip olduğunuz Visual Studio sürümü ve kullandığınız ayarlar bu öğeleri belirler. Daha fazla bilgi için bkz . IDE'yi kişiselleştirme.

Önkoşullar

Bu izlenecek yolu tamamlamak için aşağıdaki bileşenlere ihtiyacınız vardır:

  • Microsoft Office geliştirici araçlarını içeren bir Visual Studio sürümü. Daha fazla bilgi için bkz . Office çözümleri geliştirmek için bilgisayar yapılandırma.

  • PowerPoint

Proje oluşturma

Yeni proje oluşturmak için

  1. Visual Studio’yu çalıştırın.

  2. Dosya menüsünde Yeni'nin üzerine gelin ve Proje'ye tıklayın.

  3. Şablonlar bölmesinde Visual C# veya Visual Basic'i ve ardından Office/SharePoint'i genişletin.

  4. Genişletilmiş Office/SharePoint düğümü altında Office Eklentileri düğümünü seçin.

  5. Proje şablonları listesinde bir PowerPoint VSTO Eklentisi projesi seçin.

  6. Ad kutusuna FirstPowerPointAddIn yazın.

  7. Tamam'a tıklayın.

    Visual Studio FirstPowerPointAddIn projesini oluşturur ve ThisAddIn kod dosyasını düzenleyicide açar.

Her yeni slayda metin ekleyen kod yazma

Ardından ThisAddIn kod dosyasına kod ekleyin. Yeni kod, her yeni slayda bir metin kutusu eklemek için PowerPoint'in nesne modelini kullanır. ThisAddIn kod dosyası varsayılan olarak aşağıdaki oluşturulan kodu içerir:

  • Sınıfın ThisAddIn kısmi tanımı. Bu sınıf, kodunuz için bir giriş noktası sağlar ve PowerPoint'in nesne modeline erişim sağlar. Daha fazla bilgi için bkz . PROGRAM VSTO Eklentileri. Sınıfın ThisAddIn geri kalanı, değiştirmemeniz gereken gizli bir kod dosyasında tanımlanır.

  • ThisAddIn_Startup ve ThisAddIn_Shutdown olay işleyicileri. Bu olay işleyicileri, PowerPoint VSTO Eklentinizi yükleyip kaldırdığında çağrılır. Yüklendiğinde VSTO Eklentinizi başlatmak ve kaldırıldığında VSTO Eklentiniz tarafından kullanılan kaynakları temizlemek için bu olay işleyicilerini kullanın. Daha fazla bilgi için bkz . Office projelerindeki olaylar.

Her yeni slayda metin kutusu eklemek için

  1. ThisAddIn kod dosyasında sınıfına ThisAddIn aşağıdaki kodu ekleyin. Bu kod, Application nesnesinin Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide olayı için bir olay işleyicisi tanımlar.

    Kullanıcı etkin sunuya yeni bir slayt eklediğinde, bu olay işleyicisi yeni slaydın en üstüne bir metin kutusu ekler ve metin kutusuna biraz metin ekler.

    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. C# kullanıyorsanız olay işleyicisine ThisAddIn_Startup aşağıdaki kodu ekleyin. Bu kod, olay işleyicisini Application_PresentationNewSlide Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide olayına bağlamak için gereklidir.

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

    Her yeni slaydı değiştirmek için, önceki kod örnekleri aşağıdaki nesneleri kullanır:

  • Application Sınıfının alanıThisAddIn. alanı Application , PowerPoint'in geçerli örneğini temsil eden bir Application nesnesi döndürür.

  • Sld Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide olayı için olay işleyicisinin parametresi. Sld parametresi, yeni slaydı temsil eden bir Slide nesnesidir. Daha fazla bilgi için bkz . PowerPoint çözümleri.

Projeyi test etme

Projeyi derleyip çalıştırdığınızda, sunuya eklediğiniz yeni slaytlarda metin kutusunun göründüğünü doğrulayın.

Projeyi test etmek için

  1. Projenizi oluşturmak ve çalıştırmak için F5 tuşuna basın.

    Projeyi oluşturduğunuzda kod, projenin derleme çıktı klasörüne yerleştirilmiş bir derlemede derlenmiş. Visual Studio ayrıca PowerPoint'in VSTO Eklentisini bulup yüklemesini sağlayan bir kayıt defteri girdileri kümesi oluşturur ve VSTO Eklentisi'nin çalışmasını sağlamak için geliştirme bilgisayarındaki güvenlik ayarlarını yapılandırmaktadır. Daha fazla bilgi için bkz . Office çözümleri oluşturma.

  2. PowerPoint'te etkin sunuya yeni bir slayt ekleyin.

  3. Slaydın üst kısmındaki yeni bir metin kutusuna aşağıdaki metnin eklendiğini doğrulayın.

    Bu metin kod kullanılarak eklendi.

  4. PowerPoint'i kapatın.

Projeyi temizleme

Proje geliştirmeyi bitirdiğinizde VSTO Eklenti derlemesini, kayıt defteri girdilerini ve güvenlik ayarlarını geliştirme bilgisayarınızdan kaldırın. Aksi takdirde, geliştirme bilgisayarında PowerPoint'i her açtığınızda VSTO Eklentisi çalışır.

Projenizi temizlemek için

  1. Visual Studio'da, Oluştur menüsünde Çözümü Temizle'ye tıklayın.

Sonraki adımlar

PowerPoint için temel bir VSTO Eklentisi oluşturduğunuza göre, şu konulardan VSTO Eklentileri geliştirme hakkında daha fazla bilgi edinebilirsiniz:

  • PowerPoint için VSTO Eklentileri'nde gerçekleştirebileceğiniz genel programlama görevleri. Daha fazla bilgi için bkz . PROGRAM VSTO Eklentileri.

  • PowerPoint'in nesne modelini kullanma. Daha fazla bilgi için bkz . PowerPoint çözümleri.

  • Örneğin, Şerit'e özel bir sekme ekleyerek veya kendi özel görev bölmenizi oluşturarak PowerPoint kullanıcı arabirimini özelleştirme. Daha fazla bilgi için bkz . Office kullanıcı arabirimi özelleştirmesi.

  • PowerPoint için VSTO Eklentileri oluşturma ve hata ayıklama. Daha fazla bilgi için bkz . Office çözümleri oluşturma.

  • PowerPoint için VSTO Eklentileri dağıtma. Daha fazla bilgi için bkz . Office çözümü dağıtma.

İlgili içerik