Udostępnij za pośrednictwem

Instruktaż: Tworzenie pierwszej dostosowań poziomie dokumentu programu Word

  • Artykuł

W tym instruktażu wprowadzające pokazuje, jak utworzyć dostosowywania poziomie dokumentu dla programu Microsoft Office Word.Funkcje, które można tworzyć w tego rodzaju rozwiązanie są dostępne tylko wtedy, gdy określony dokument jest otwarty.Nie umożliwia dostosowania poziomu dokumentu do wprowadzania zmian w całej aplikacji, na przykład wyświetlanie na nowej karcie wstążki, gdy każdy dokument jest otwarty.

Dotyczy: Informacje przedstawione w tym temacie dotyczą projektów na poziomie dokumentu dla programu Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacji pakietu Office i typ projektu.

W tym instruktażu przedstawiono następujące zadania:

  • Tworzenie projektu dokumentu programu Word.

  • Dodawanie tekstu do dokumentu, który jest obsługiwany w programie Visual Studio designer.

  • Pisanie kodu, który używa modelu obiektów programu Word, aby dodać tekst do dokumentu dostosowany po jego otwarciu.

  • Tworzenie i uruchamianie projektu, aby go przetestować.

  • Oczyszczanie projektu, usunąć budować niepotrzebne pliki i ustawienia zabezpieczeń na komputerze projektowym.

[!UWAGA]

Na danym komputerze mogą być używane inne nazwy lub lokalizacje pewnych elementów interfejsu użytkownika programu Visual Studio, które są używane w poniższych instrukcjach. Używana wersja programu Visual Studio oraz jej ustawienia określają te elementy. Aby uzyskać więcej informacji, zobacz Visual Studio, ustawienia.

Wymagania wstępne

Potrzebne do przeprowadzenia tego instruktażu następujące składniki:

-

Wersja Visual Studio 2012 zawierająca narzędzia dla deweloperów pakietu Microsoft Office. Aby uzyskać więcej informacji, zobacz [Konfigurowanie komputera do opracowywania rozwiązań pakietu Office](bb398242\(v=vs.110\).md).
  • Word 2013or Word 2010.

Tworzenie projektu

Aby utworzyć nowy projekt dokumentu programu Word w programie Visual Studio

  1. Start Visual Studio.

  2. Na pliku menu, wskaż Nowa, a następnie kliknij przycisk Projekt.

  3. W okienku szablony, rozwiń węzeł Visual C# lub programu Visual Basic, a następnie rozwiń węzeł Office i SharePoint.

  4. W obszarze rozszerzony Office i SharePoint węzła, zaznacz Dodatki pakietu Office węzła.

  5. Zaznacz na liście szablonów projektu, Dokument programu Word 2010 lub Dokument programu Word 2013.

  6. W Nazwa wpisz FirstDocumentCustomization.

  7. Kliknij przycisk OK.

    Visual Studio Tools for Office Project kreatora otwiera.

  8. Wybierz Utwórz nowy dokumenti kliknij przycisk OK.

    Visual StudioTworzy FirstDocumentCustomization projektu i dodaje FirstDocumentCustomization dokument i plik kodu ThisDocument projektu.FirstDocumentCustomization dokument jest otwierany automatycznie w projektancie.

Zamknąć i ponownie otworzyć dokument w Projektancie

Jeśli celowo lub przypadkowo zamknąć dokument w Projektancie podczas opracowywania projektu, można go ponownie otworzyć.

Zamknąć i ponownie otworzyć dokument w Projektancie

  1. Zamknij dokument, klikając Zamknij przycisk (X) w oknie projektanta.

  2. W Solution Explorer, kliknij prawym przyciskiem myszy ThisDocument kod pliku, a następnie kliknij przycisk Projektanta widoku.

    - lub -

    W Solution Explorer, kliknij dwukrotnie ThisDocument kod pliku.

Dodawanie tekstu do dokumentu w Projektancie

Modyfikując dokument, który jest otwarty w projektancie, można zaprojektować interfejs użytkownika (UI) z opcji dostosowania.Na przykład można dodać tekst, tabele lub formantów programu Word.Aby uzyskać więcej informacji na temat używania projektanta, zobacz Office projektów w środowisku Visual Studio.

Aby dodać tekst do dokumentu przy użyciu projektanta

  • W dokumencie, który jest otwarty w Projektancie wpisz następujący tekst.

    Tekst ten został dodany za pomocą projektanta.

Dodawanie tekstu do dokumentu programowego

Następnie należy dodać kod do pliku kod ThisDocument.Nowy kod używa modelu obiektów programu Word, aby dodać drugi akapit tekstu do dokumentu.Domyślnie plik kodu ThisDocument zawiera wygenerowany następujący kod:

  • Częściowe definicja ThisDocument klasy, która reprezentuje model programowania dokumentu i zapewnia dostęp do modelu obiektu programu Word.Aby uzyskać więcej informacji, zobacz Element hosta dokumentu i Program Word omówienie modelu obiektu.Pozostałą część ThisDocument klasa jest zdefiniowana w pliku ukrytego kodu, który nie należy modyfikować.

  • ThisDocument_Startup i ThisDocument_Shutdown obsługi zdarzeń.Te programy obsługi zdarzeń są wywoływane, gdy dokument jest otwarty i zamknięty.Użyj tych programów obsługi zdarzeń zainicjować dostosowań, gdy dokument jest otwarty i oczyścić zasoby używane przez dostosowań, gdy dokument jest zamykany.Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

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

  1. W Solution Explorer, kliknij prawym przyciskiem myszy ThisDocument, a następnie kliknij przycisk Widok Kod.

    Otwiera plik kodu w programie Visual Studio.

  2. Zamień ThisDocument_Startup obsługi zdarzeń z następującego kodu.Gdy dokument jest otwarty, ten kod dodaje się akapit drugi tekstu do dokumentu.

    Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(2).Range.Text = "This text was added by using code."
End Sub

    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 akapit pierwszy w dostęp do Paragraphs właściwość.Visual Basic i Visual C# należy używać tablic oparte na 0, ale niższe granice tablicy większość zbiorów w modelu obiektów programu Word jest 1.Aby uzyskać więcej informacji, zobacz Pisania kodu w rozwiązania dla pakietu Office.

Testowanie projektu

Aby przetestować dokument

  1. Naciśnij F5 Aby skompilować i uruchomić projekt.

    Podczas budowania projektu, kod jest skompilowany do złożenia, który jest skojarzony z dokumentem.Visual Studio umieszcza kopię dokumentu i zgromadzenia w docelowym folderze kompilacji projektu i konfiguruje ustawienia zabezpieczeń na komputerze deweloperskim, aby włączyć dostosowania do uruchomienia.Aby uzyskać więcej informacji, zobacz Konstruowanie rozwiązań pakietu Office.

  2. W dokumencie należy sprawdzić, że aby zobaczyć następujący tekst.

    Tekst ten został dodany za pomocą projektanta.

    Tekst ten został dodany za pomocą kodu.

  3. Zamknij dokument.

Czyszczenie projektu

Po zakończeniu opracowanie projektu, należy usunąć pliki w folderze wyjściowym budować i ustawienia zabezpieczeń, utworzonych przez proces budowania.

Aby oczyścić zakończonych projektów na komputerze dewelopera

  • W programie Visual Studio na budować menu, kliknij przycisk Rozwiązanie.

Następne kroki

Teraz, że utworzono podstawowe dostosowania poziomie dokumentu dla programu Word, można dowiedzieć się więcej o opracowanie dostosowania następujących tematów:

Zobacz też

Koncepcje

Przegląd rozwoju rozwiązań pakietu Office

Automatyzowanie programu Word przy użyciu obiektów rozszerzony

Inne zasoby

Rozwiązania programu Word

Dostosowania poziomu dokument programowania

Program Word omówienie modelu obiektu

Dodatek dostosowywania interfejsu użytkownika pakietu Office

Konstruowanie rozwiązań pakietu Office

Wdrażanie rozwiązania do pakietu Office

Omówienie szablonów programu Office Project