Udostępnij za pośrednictwem

Przewodnik: tworzenie pierwszego dodatku VSTO dla programu PowerPoint

  • Artykuł

W tym przewodniku pokazano, jak utworzyć dodatek VSTO dla programu Microsoft Office PowerPoint. Funkcje tworzone w tym rodzaju rozwiązania są dostępne dla samej aplikacji, niezależnie od tego, które prezentacje są otwarte. Aby uzyskać więcej informacji, zobacz Omówienie programowania rozwiązań pakietu Office (VSTO).

Dotyczy: informacje w tym temacie dotyczą projektów dodatków VSTO dla programu PowerPoint. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

W instruktażu przedstawiono następujące zagadnienia:

  • Tworzenie projektu dodatku VSTO programu PowerPoint dla programu PowerPoint.

  • Pisanie kodu korzystającego z modelu obiektów programu PowerPoint w celu dodania pola tekstowego do każdego nowego slajdu.

  • Kompilowanie i uruchamianie projektu w celu jego przetestowania.

  • Czyszczenie projektu w taki sposób, aby dodatek VSTO nie był już uruchamiany automatycznie na komputerze dewelopera.

    Uwaga

    Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE.

Wymagania wstępne

Następujące składniki są wymagane do przeprowadzenia tego instruktażu:

Tworzenie projektu

Aby utworzyć nowy projekt

  1. Uruchom program Visual Studio.

  2. W menu Plik wskaż polecenie Nowy, a następnie kliknij pozycję Projekt.

  3. W okienku szablonów rozwiń węzeł Visual C# lub Visual Basic, a następnie rozwiń węzeł Office/SharePoint.

  4. W rozwiniętym węźle Office/SharePoint wybierz węzeł Dodatki pakietu Office.

  5. Na liście szablonów projektów wybierz projekt dodatku VSTO programu PowerPoint.

  6. W polu Nazwa wpisz FirstPowerPointAddIn.

  7. Kliknij przycisk OK.

    Program Visual Studio tworzy projekt FirstPowerPointAddIn i otwiera plik kodu ThisAddIn w edytorze.

Pisanie kodu, który dodaje tekst do każdego nowego slajdu

Następnie dodaj kod do pliku kodu ThisAddIn. Nowy kod używa modelu obiektów programu PowerPoint do dodawania pola tekstowego do każdego nowego slajdu. Domyślnie plik kodu ThisAddIn zawiera następujący wygenerowany kod:

  • Częściowa definicja ThisAddIn klasy. Ta klasa zapewnia punkt wejścia dla kodu i zapewnia dostęp do modelu obiektów programu PowerPoint. Aby uzyskać więcej informacji, zobacz Program VSTO Add-ins (Dodatki programu VSTO). Pozostała część ThisAddIn klasy jest zdefiniowana w ukrytym pliku kodu, którego nie należy modyfikować.

  • Programy obsługi zdarzeń ThisAddIn_Startup i ThisAddIn_Shutdown . Te programy obsługi zdarzeń są wywoływane, gdy program PowerPoint ładuje i zwalnia dodatek VSTO. Użyj tych procedur obsługi zdarzeń, aby zainicjować dodatek VSTO podczas ładowania i wyczyścić zasoby używane przez dodatek VSTO podczas jego zwolnienia. Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Aby dodać pole tekstowe do każdego nowego slajdu

  1. W pliku kodu ThisAddIn dodaj następujący kod do ThisAddIn klasy . Ten kod definiuje procedurę obsługi zdarzeń dla zdarzenia Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlideobiektu Application .

    Gdy użytkownik doda nowy slajd do aktywnej prezentacji, ten program obsługi zdarzeń dodaje pole tekstowe w górnej części nowego slajdu i dodaje jakiś tekst do pola tekstowego.

    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. Jeśli używasz języka C#, dodaj następujący kod do procedury obsługi zdarzeń ThisAddIn_Startup . Ten kod jest wymagany do połączenia Application_PresentationNewSlide programu obsługi zdarzeń z zdarzeniem Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide .

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

    Aby zmodyfikować każdy nowy slajd, poprzednie przykłady kodu używają następujących obiektów:

Testowanie projektu

Podczas kompilowania i uruchamiania projektu sprawdź, czy pole tekstowe jest wyświetlane w nowych slajdach dodanych do prezentacji.

Aby przetestować projekt

  1. Naciśnij klawisz F5 , aby skompilować i uruchomić projekt.

    Podczas kompilowania projektu kod jest kompilowany w zestawie umieszczonym w folderze danych wyjściowych kompilacji dla projektu. Program Visual Studio tworzy również zestaw wpisów rejestru, które umożliwiają programowi PowerPoint odnajdywanie i ładowanie dodatku VSTO oraz konfigurowanie ustawień zabezpieczeń na komputerze deweloperów w celu umożliwienia uruchamiania dodatku VSTO. Aby uzyskać więcej informacji, zobacz Tworzenie rozwiązań pakietu Office.

  2. W programie PowerPoint dodaj nowy slajd do aktywnej prezentacji.

  3. Sprawdź, czy następujący tekst został dodany do nowego pola tekstowego w górnej części slajdu.

    Ten tekst został dodany przy użyciu kodu.

  4. Zamknij program PowerPoint.

Czyszczenie projektu

Po zakończeniu tworzenia projektu usuń zestaw dodatku VSTO, wpisy rejestru i ustawienia zabezpieczeń z komputera dewelopera. W przeciwnym razie dodatek VSTO będzie uruchamiany za każdym razem, gdy otworzysz program PowerPoint na komputerze dewelopera.

Aby wyczyścić projekt

  1. W programie Visual Studio w menu Kompilacja kliknij pozycję Wyczyść rozwiązanie.

Następne kroki

Po utworzeniu podstawowego dodatku VSTO dla programu PowerPoint możesz dowiedzieć się więcej o sposobie tworzenia dodatków VSTO z następujących tematów:

  • Ogólne zadania programistyczne, które można wykonywać w dodatku VSTO dla programu PowerPoint. Aby uzyskać więcej informacji, zobacz Program VSTO Add-ins (Dodatki programu VSTO).

  • Korzystanie z modelu obiektów programu PowerPoint. Aby uzyskać więcej informacji, zobacz Rozwiązania programu PowerPoint.

  • Dostosowywanie interfejsu użytkownika programu PowerPoint, na przykład przez dodanie karty niestandardowej do wstążki lub utworzenie własnego niestandardowego okienka zadań. Aby uzyskać więcej informacji, zobacz Dostosowywanie interfejsu użytkownika pakietu Office.

  • Kompilowanie i debugowanie dodatków VSTO dla programu PowerPoint. Aby uzyskać więcej informacji, zobacz Tworzenie rozwiązań pakietu Office.

  • Wdrażanie dodatków VSTO dla programu PowerPoint. Aby uzyskać więcej informacji, zobacz Wdrażanie rozwiązania pakietu Office.

Powiązana zawartość