Instruktaż: Tworzenie na pierwszym poziomie aplikacji Add-in for Word

Artykuł
02/27/2013

W tym instruktażu wprowadzające pokazuje, jak utworzyć poziomu aplikacji dodatek dla programu Microsoft Office Word.Funkcje, które można tworzyć w tego rodzaju rozwiązanie są dostępne dla samej aplikacji, niezależnie od tego, które są otwarte dokumenty.

Dotyczy: Informacje przedstawione w tym temacie dotyczą projektów na poziomie aplikacji dla programów 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 dodatek programu Word.
Pisanie kodu, który używa modelu obiektów programu Word, aby dodać tekst do dokumentu po zapisaniu go.
Tworzenie i uruchamianie projektu, aby go przetestować.
Oczyszczanie zakończonych projektów tak, że dodatek nie działa automatycznie na komputerze dewelopera.

[!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ć nowe słowo-w projekt w 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, programu Word 2010 Add-in lub słowo 2013 Add-in.
W Nazwa wpisz FirstWordAddIn.
Kliknij przycisk OK.

Visual StudioTworzy FirstWordAddIn projekt i otwiera plik ThisAddIn kod w edytorze.

Pisanie kodu, aby dodać tekst zapisany dokument

Następnie należy dodać kod do pliku kod ThisAddIn.Nowy kod używa modelu obiektów programu Word, aby dodać tekst standardowy do każdego dokumentu zapisanego.Domyślnie plik kodu ThisAddIn zawiera następujący kod wygenerowany:

Częściowe definicja ThisAddIn klasy.Ta klasa zapewnia punktu wejścia dla kodu i zapewnia dostęp do modelu obiektu programu Word.Aby uzyskać więcej informacji, zobacz Programowanie aplikacji poziom dodatki.Pozostałą część ThisAddIn klasa jest zdefiniowana w pliku ukrytego kodu, który nie należy modyfikować.
ThisAddIn_Startup i ThisAddIn_Shutdown obsługi zdarzeń.Te programy obsługi zdarzeń są wywoływane, gdy program Word ładuje i wyładowuje dodatku.Zainicjowanie dodatku po załadowaniu i oczyścić zasoby używane przez dodatku, gdy jest zwalniany, należy użyć te programy obsługi zdarzeń.Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Aby dodać akapit tekstu do zapisany dokument

W pliku ThisAddIn kodu, Dodaj następujący kod do ThisAddIn klasy.Nowy kod definiuje obsługi zdarzenia DocumentBeforeSave zdarzenie, które jest wywoływane, gdy dokument jest zapisywany.

Gdy użytkownik zapisuje dokument, program obsługi zdarzeń dodaje nowy tekst na początku dokumentu.
```
Private Sub Application_DocumentBeforeSave(ByVal Doc As Word.Document, ByRef SaveAsUI As Boolean, _
    ByRef Cancel As Boolean) Handles Application.DocumentBeforeSave
    Doc.Paragraphs(1).Range.InsertParagraphBefore()
    Doc.Paragraphs(1).Range.Text = "This text was added by using code."
End Sub
```
```
void Application_DocumentBeforeSave(Word.Document Doc, ref bool SaveAsUI, ref bool Cancel)
{
    Doc.Paragraphs[1].Range.InsertParagraphBefore();
    Doc.Paragraphs[1].Range.Text = "This text was added by using code.";
}
```
[!UWAGA]

Ten kod zawiera wartość indeksu 1 akapit pierwszy w dostęp do Paragraphs kolekcji.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.
Jeśli używasz języka C#, Dodaj następujący kod wymagany do ThisAddIn_Startup programu obsługi zdarzeń.Kod ten jest używany do łączenia z Application_DocumentBeforeSave obsługi zdarzeń z DocumentBeforeSave zdarzenie.
```
this.Application.DocumentBeforeSave += 
    new Word.ApplicationEvents4_DocumentBeforeSaveEventHandler(Application_DocumentBeforeSave);
```

Do modyfikacji dokumentu zapisanej w poprzednich przykładach kodu Użyj następujących obiektów:

Application Pole ThisAddIn klasy.Application Zwraca wartość w polu Microsoft.Office.Interop.Word.Application obiekt, który reprezentuje w bieżącym wystąpieniu programu Word.
Doc Parametr programu obsługi zdarzeń dla DocumentBeforeSave zdarzenie.Doc Parametr jest Microsoft.Office.Interop.Word.Document obiekt, który reprezentuje zapisany dokument.Aby uzyskać więcej informacji, zobacz Program Word omówienie modelu obiektu.

Testowanie projektu

Aby przetestować projekt

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

Podczas budowania projektu, kod jest skompilowany w zespół, który znajduje się w folderze wyjściowym kompilacji projektu.Visual Studio również tworzy zestaw wpisów rejestru użytkownikom Odkryj i załadować dodatek i konfiguruje ustawienia zabezpieczeń na komputerze deweloperskim, aby włączyć dodatek do uruchomienia.Aby uzyskać więcej informacji, zobacz Konstruowanie rozwiązań pakietu Office.
W programie Word zapisać aktywny dokument.
Sprawdź, czy tekst jest dodany do dokumentu.

Tekst ten został dodany za pomocą kodu.
Zamknij program Word.

Czyszczenie projektu

Po zakończeniu opracowanie projektu,-w zestawie, wpisy rejestru i ustawienia zabezpieczeń należy usunąć z komputera rozwoju.W przeciwnym razie dodatek będzie wykonać za każdym razem po otwarciu programu Word na komputerze dewelopera.

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 podstawowy poziom aplikacji dodatek dla programu Word, można dowiedzieć się więcej o opracowanie dodatki z tych tematów:

Ogólnych zadań programistycznych, które można wykonywać w dodatków: Programowanie aplikacji poziom dodatki.
Zadania programistyczne, które są specyficzne dla programu Word dodatków: Rozwiązania programu Word.
Za pomocą modelu obiektów programu Word: Program Word omówienie modelu obiektu.
Dostosowywanie interfejsu użytkownika programu Word, na przykład przez dodawanie karty niestandardowej do Wstążki lub tworzenie własnych niestandardowych okienko zadań: Dodatek dostosowywania interfejsu użytkownika pakietu Office.
Budowanie i debugowanie aplikacji poziom dodatków dla programu Word: Konstruowanie rozwiązań pakietu Office.
Wdrażanie aplikacji poziom dodatków dla programu Word: Wdrażanie rozwiązania do pakietu Office.