Udostępnij za pośrednictwem


Wskazówki: tworzenie pierwszego dostosowania na poziomie dokumentu dla programu Word

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.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu obsługiwanych w programach Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach 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 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 Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Wymagania wstępne

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

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 Projekty pakietu Office 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 Model obiektu Word — Omówienie.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 Pisanie kodu dla rozwiązań 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 Kompilowanie 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

Rozwój rozwiązań Office ― Omówienie

Automatyzowanie programu Word za pomocą obiektów rozszerzonych

Inne zasoby

Rozwiązania programu Word

Programowanie dostosowań na poziome dokumentu

Model obiektu Word — Omówienie

Dostosowywanie interfejsu użytkownika pakietu Office

Kompilowanie rozwiązań pakietu Office

Wdrażanie rozwiązania do pakietu Office

Szablony projektów pakietu Office ― Omówienie