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:
Edycja programu Visual Studio 2013, która oferuje narzędzia deweloperskie pakietu Microsoft Office. Aby uzyskać więcej informacji, zobacz Konfigurowanie komputera do opracowywania rozwiązań pakietu Office.
Word 2013or Word 2010.
Tworzenie projektu
Aby utworzyć nowy projekt dokumentu programu Word w programie Visual Studio
Start Visual Studio.
Na pliku menu, wskaż Nowa, a następnie kliknij przycisk Projekt.
W okienku szablony, rozwiń węzeł Visual C# lub programu Visual Basic, a następnie rozwiń węzeł Office i SharePoint.
W obszarze rozszerzony Office i SharePoint węzła, zaznacz Dodatki pakietu Office węzła.
Zaznacz na liście szablonów projektu, Dokument programu Word 2010 lub Dokument programu Word 2013.
W Nazwa wpisz FirstDocumentCustomization.
Kliknij przycisk OK.
Visual Studio Tools for Office Project kreatora otwiera.
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
Zamknij dokument, klikając Zamknij przycisk (X) w oknie projektanta.
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
W Solution Explorer, kliknij prawym przyciskiem myszy ThisDocument, a następnie kliknij przycisk Widok Kod.
Otwiera plik kodu w programie Visual Studio.
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
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.
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.
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:
Ogólnych zadań programistycznych, które można wykonywać w dostosowań na poziomie dokumentu: Programowanie dostosowań na poziome dokumentu.
Zadania programistyczne, które są specyficzne dla dostosowania poziomie dokumentu dla programu Word: Rozwiązania programu Word.
Za pomocą modelu obiektów programu Word: Model obiektu Word — Omówienie.
Dostosowywanie interfejsu użytkownika programu Word, na przykład przez dodanie niestandardowych kartę do Wstążki lub stworzenie okienka akcji: Dostosowywanie interfejsu użytkownika pakietu Office.
Za pomocą rozszerzone obiektów programu Word, świadczone 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 hosting zarządzany kontrole dokumentów i powiązaniem formantów programu Word do danych przy użyciu modelu wiązania danych Windows Forms): Automatyzowanie programu Word za pomocą obiektów rozszerzonych.
Budowanie i debugowanie dostosowania poziomie dokumentu dla programu Word: Kompilowanie rozwiązań pakietu Office.
Wdrażanie dostosowania poziomie dokumentu dla programu Word: Wdrażanie rozwiązania do pakietu Office.
Zobacz też
Koncepcje
Rozwój rozwiązań Office ― Omówienie
Automatyzowanie programu Word za pomocą obiektów rozszerzonych
Inne zasoby
Programowanie dostosowań na poziome dokumentu
Model obiektu Word — Omówienie
Dostosowywanie interfejsu użytkownika pakietu Office
Kompilowanie rozwiązań pakietu Office