Udostępnij za pośrednictwem

Przewodnik: tworzenie pierwszego dostosowania na poziomie dokumentu dla programu Word

  • Artykuł

W tym przewodniku wprowadzającym pokazano, jak utworzyć dostosowywanie na poziomie dokumentu dla programu Microsoft Office Word. Funkcje tworzone w tym rodzaju rozwiązania są dostępne tylko po otwarciu określonego dokumentu. Nie można użyć dostosowania na poziomie dokumentu, aby wprowadzić zmiany w całej aplikacji, na przykład wyświetlanie nowej karty wstążki po otwarciu dowolnego dokumentu.

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu dla programu Word. 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 dokumentu programu Word.

  • Dodawanie tekstu do dokumentu hostowanego w projektancie programu Visual Studio.

  • Pisanie kodu korzystającego z modelu obiektów programu Word w celu dodania tekstu do dostosowanego dokumentu po jego otwarciu.

  • Kompilowanie i uruchamianie projektu w celu jego przetestowania.

  • Czyszczenie projektu w celu usunięcia niepotrzebnych plików kompilacji i ustawień zabezpieczeń z komputera 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 dokumentu programu Word w programie Visual Studio

  1. Uruchom program Visual Studio.

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

  3. W oknie dialogowym Tworzenie nowego projektu wybierz projekt dokument programu Word VSTO.

    Uwaga

    Szablony można również wyszukać, wpisując nazwę produktu pakietu Office w polu tekstowym Wyszukaj w górnej części okna dialogowego Tworzenie nowego projektu . Na przykład wpisanie w programie Excel spowoduje wyświetlenie wszystkich szablonów projektów dla programu Excel. Listę szablonów można również filtrować, aby wyświetlić tylko szablony pakietu Office, wybierając pozycję Office w polu listy rozwijanej Typ projektu. Aby uzyskać więcej informacji, zobacz Tworzenie nowego projektu w programie Visual Studio.

  4. Kliknij przycisk Dalej.

  5. Wpisz FirstWorkbookCustomization w polu Nazwa w oknie dialogowym Konfigurowanie nowego projektu i kliknij przycisk Utwórz.

  6. Wybierz pozycję Utwórz nowy dokument z Kreatora projektu Visual Studio Tools dla pakietu Office, a następnie kliknij przycisk OK.

    • Program Visual Studio tworzy projekt FirstDocumentCustomization i dodaje do projektu dokument FirstDocumentCustomization oraz plik kodu ThisDocument. Dokument FirstDocumentCustomization jest otwierany automatycznie w projektancie.

Zamknij i otwórz ponownie dokument w projektancie

Jeśli podczas tworzenia projektu celowo lub przypadkowo zamkniesz dokument w projektancie, możesz go ponownie otworzyć.

Aby zamknąć i ponownie otworzyć dokument w projektancie

  1. Zamknij dokument, klikając przycisk Zamknij (X) dla okna projektanta.

  2. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy plik kodu ThisDocument, a następnie kliknij pozycję Wyświetl Projektant.

    - lub -

    W Eksplorator rozwiązań kliknij dwukrotnie plik kodu ThisDocument.

Dodawanie tekstu do dokumentu w projektancie

Interfejs użytkownika (UI) dostosowywania można zaprojektować, modyfikując dokument otwarty w projektancie. Można na przykład dodawać tekst, tabele lub kontrolki programu Word. Aby uzyskać więcej informacji na temat korzystania z projektanta, zobacz Projekty pakietu Office w środowisku programu Visual Studio.

Aby dodać tekst do dokumentu przy użyciu projektanta

  1. W dokumencie otwartym w projektancie wpisz następujący tekst.

    Ten tekst został dodany przy użyciu projektanta.

Programowe dodawanie tekstu do dokumentu

Następnie dodaj kod do pliku kodu ThisDocument. Nowy kod używa modelu obiektów programu Word do dodania drugiego akapitu tekstu do dokumentu. Domyślnie plik kodu ThisDocument zawiera następujący wygenerowany kod:

  • Częściowa definicja ThisDocument klasy, która reprezentuje model programowania dokumentu i zapewnia dostęp do modelu obiektów programu Word. Aby uzyskać więcej informacji, zobacz Omówienie elementu hosta dokumentu i modelu obiektów programu Word. Pozostała część ThisDocument klasy jest zdefiniowana w ukrytym pliku kodu, którego nie należy modyfikować.

  • Programy obsługi zdarzeń ThisDocument_Startup i ThisDocument_Shutdown . Te programy obsługi zdarzeń są wywoływane po otwarciu i zamknięciu dokumentu. Użyj tych procedur obsługi zdarzeń, aby zainicjować dostosowywanie po otwarciu dokumentu i wyczyścić zasoby używane przez dostosowanie po zamknięciu dokumentu. Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Aby dodać drugi akapit tekstu do dokumentu przy użyciu kodu

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy pozycję ThisDocument, a następnie kliknij polecenie Wyświetl kod.

    Plik kodu zostanie otwarty w programie Visual Studio.

  2. Zastąp ThisDocument_Startup program obsługi zdarzeń następującym kodem. Po otwarciu dokumentu ten kod dodaje drugi akapit tekstu do dokumentu.

    private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[2].Range.Text = "This text was added by using code.";
}

    Uwaga

    Ten kod używa wartości indeksu 1, aby uzyskać dostęp do pierwszego akapitu Paragraphs we właściwości . Mimo że język Visual Basic i Visual C# używają tablic opartych na 0, dolne granice tablic większości kolekcji w modelu obiektów programu Word to 1. Aby uzyskać więcej informacji, zobacz Pisanie kodu w rozwiązaniach pakietu Office.

Testowanie projektu

Aby przetestować dokument

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

    Podczas kompilowania projektu kod jest kompilowany w zestawie skojarzonym z dokumentem. Program Visual Studio umieszcza kopię dokumentu i zestawu w folderze danych wyjściowych kompilacji dla projektu i konfiguruje ustawienia zabezpieczeń na komputerze dewelopera, aby umożliwić uruchamianie dostosowania. Aby uzyskać więcej informacji, zobacz Tworzenie rozwiązań pakietu Office.

  2. W dokumencie sprawdź, czy zostanie wyświetlony następujący tekst.

    Ten tekst został dodany przy użyciu projektanta.

    Ten tekst został dodany przy użyciu kodu.

  3. Zamknij dokument.

Czyszczenie projektu

Po zakończeniu tworzenia projektu należy usunąć pliki w folderze wyjściowym kompilacji i ustawienia zabezpieczeń utworzone przez proces kompilacji.

Aby wyczyścić ukończony projekt na komputerze dewelopera

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

Następne kroki

Po utworzeniu podstawowego dostosowywania na poziomie dokumentu dla programu Word możesz dowiedzieć się więcej na temat opracowywania dostosowań z następujących tematów:

  • Ogólne zadania programistyczne, które można wykonać w dostosowaniach na poziomie dokumentu: Dostosowania na poziomie dokumentu programu.

  • Zadania programistyczne specyficzne dla dostosowań na poziomie dokumentu dla rozwiązań word: Word.

  • Korzystanie z modelu obiektów programu Word: Omówienie modelu obiektów programu Word.

  • Dostosowywanie interfejsu użytkownika programu Word, na przykład przez dodanie karty niestandardowej do wstążki lub utworzenie własnego okienka akcji: dostosowywanie interfejsu użytkownika pakietu Office.

  • Używanie rozszerzonych obiektów programu Word dostarczanych przez rozwiązania pakietu Office w programie Visual Studio do wykonywania zadań, które nie są możliwe przy użyciu modelu obiektów programu Word (na przykład hostowania zarządzanych kontrolek na dokumentach i wiązania kontrolek programu Word z danymi przy użyciu modelu powiązania danych formularzy systemu Windows): automatyzuj program Word przy użyciu obiektów rozszerzonych.

  • Kompilowanie i debugowanie dostosowań na poziomie dokumentu dla programu Word: tworzenie rozwiązań pakietu Office.

  • Wdrażanie dostosowań na poziomie dokumentu dla programu Word: wdrażanie rozwiązania pakietu Office.

Powiązana zawartość