Programowanie aplikacji poziom dodatki

Artykuł
02/27/2013

Przez tworzenie na poziomie aplikacji dodatek rozszerzenie aplikacji pakietu Microsoft Office, możesz napisać kod bezpośrednio przed ThisAddIn klasy do projektu.Ta klasa służy do wykonywania zadań, takich jak dostęp do modelu obiektu hosta aplikacji Microsoft Office, dostosowywanie interfejsu użytkownika (UI), aplikacji i narazić obiektów w dodatku do innych rozwiązań pakietu Office.

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

Niektóre aspekty pisania kodu w dodatku projektów różnią się od innych typów projektów w programie Visual Studio.Wiele z tych różnic są spowodowana przez sposób Office modeli obiektów są narażone na kod zarządzany.Aby uzyskać więcej informacji, zobacz Pisania kodu w rozwiązania dla pakietu Office.

Aby uzyskać ogólne informacje o poziomie aplikacji dodatków i innych rodzajów rozwiązań, można utworzyć za pomocą narzędzi programistycznych pakietu Office w programie Visual Studio, zobacz Przegląd rozwoju rozwiązań pakietu Office.

Za pomocą klasy ThisAddIn

Można zacząć pisać kod w ThisAddIn klasy.Visual Studio automatycznie generuje tej klasy w ThisAddIn.vb (w Visual Basic) lub pliku kod ThisAddIn.cs (w języku C#) w projekcie dodatek.Visual Studio 2010 Tools for Office Runtime Automatycznie tworzy tej klasy, załadowaniu dodatku aplikacji Microsoft Office.

Istnieją dwa programy obsługi zdarzeń domyślne w ThisAddIn klasy.Aby uruchomić kod, gdy dodatek jest załadowany, Dodaj kod, aby ThisAddIn_Startup programu obsługi zdarzeń.Uruchomienie kodu przed dodatek jest zwalniany, Dodaj kod, aby ThisAddIn_Shutdown programu obsługi zdarzeń.Aby uzyskać więcej informacji na temat tych programów obsługi zdarzeń, zobacz Zdarzenia w projektach pakietu Office.

[!UWAGA]

W programie Outlook domyślnie ThisAddIn_Shutdown programu obsługi zdarzeń nie jest zawsze wywoływane, gdy dodatek jest zwalniana.Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.

Uzyskiwanie dostępu do modelu obiektu hosta aplikacji

Aby uzyskać dostęp do modelu obiektu aplikacji hosta, należy użyć Application pole ThisAddIn klasy.To pole zwraca obiekt, który reprezentuje bieżącą instancję aplikacji hosta.W poniższej tabeli przedstawiono typ zwracanej wartości dla Application pole w każdym projekcie dodatek.

Aplikacja hosta	Zwraca wartość typu
Program Microsoft Office Excel	Microsoft.Office.Interop.Excel.Application
Program Microsoft Office InfoPath	Microsoft.Office.Interop.InfoPath.Application
Microsoft Office Outlook	Microsoft.Office.Interop.Outlook.Application
Program Microsoft Office PowerPoint	Microsoft.Office.Interop.PowerPoint.Application
Program Microsoft Office Project	Microsoft.Office.Interop.MSProject.Application
Program Microsoft Office Visio	Microsoft.Office.Interop.Visio.Application
Program Microsoft Office Word	Microsoft.Office.Interop.Word.Application

Poniższy przykład kodu pokazuje, jak używać Application polu, aby utworzyć nowy skoroszyt w dodatek dla programu Microsoft Office Excel.W tym przykładzie jest przeznaczony do uruchomienia z ThisAddIn klasy.

Dim newWorkbook As Excel.Workbook = Me.Application.Workbooks.Add()

Excel.Workbook newWorkbook = this.Application.Workbooks.Add(System.Type.Missing);

Aby zrobić to samo z zewnątrz ThisAddIn klasy, użyj Globals obiekt do dostępu do ThisAddIn klasy.Aby uzyskać więcej informacji o Globals obiektów, zobacz Globalny dostęp do obiektów w projektach pakietu Office.

Dim newWorkbook As Excel.Workbook = Globals.ThisAddIn.Application.Workbooks.Add()

Excel.Workbook newWorkbook = Globals.ThisAddIn.Application.Workbooks.Add(System.Type.Missing);

Aby uzyskać więcej informacji na temat modeli obiektów aplikacje Microsoft Office zobacz następujące tematy:

Uzyskiwanie dostępu do dokumentu podczas uruchamiania aplikacji pakietu Office

Nie wszystkie Office 2010 aplikacji automatycznie otworzyć dokument podczas uruchamiania je, a żaden z Office 2013 aplikacji otwórz dokument, po ich uruchomieniu.W związku z tym, nie należy dodawać kod w ThisAdd-In_Startup programu obsługi zdarzeń, jeśli kod wymaga dokument być otwarty.Zamiast tego należy dodać kod do zdarzenia, które wywołuje aplikacji pakietu Office, gdy użytkownik tworzy lub otwiera dokument.W ten sposób można zagwarantować, że dokument jest otwarty, zanim kod wykonuje operacje na nim.

Poniższy przykład kodu działa z dokumentu programu Word, tylko wtedy, gdy użytkownik tworzy dokument lub otwiera istniejący dokument.

Private Sub ThisAddIn_Startup() Handles Me.Startup

    AddHandler Application.NewDocument, AddressOf WorkWithDocument

End Sub

Private Sub WorkWithDocument(ByVal Doc As Microsoft.Office.Interop.Word.Document) _
    Handles Application.DocumentOpen

    Dim rng As Word.Range = Doc.Range(Start:=0, End:=0)
    rng.Text = " New Text "
    rng.Select()

End Sub

Członkowie ThisAddIn się do innych zadań

Poniższa tabela opisuje innych typowych zadań i pokazuje, co członkowie ThisAddIn klasy można używać do wykonywania zadań.

Zadanie	Członkowski
Uruchamianie kodu w celu inicjowania dodatku, gdy dodatek jest załadowany.	Dodawanie kodu do ThisAddIn_Startup metoda.Jest to domyślna obsługa zdarzeń dla Startup zdarzenie.Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.
Uruchom kod, aby oczyścić zasoby używane przez dodatek, zanim dodatek jest zwalniana.	Dodawanie kodu do ThisAddIn_Shutdown metoda.Jest to domyślna obsługa zdarzeń dla Shutdown zdarzenie.Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office. Uwaga W programie Outlook domyślnie ThisAddIn_Startup programu obsługi zdarzeń nie jest zawsze wywoływane, gdy dodatek jest zwalniana.Aby uzyskać więcej informacji, zobacz Zdarzenia w projektach pakietu Office.
Wyświetlanie niestandardowych okienko zadań.	Użycie CustomTaskPanes pole.Aby uzyskać więcej informacji, zobacz Niestandardowe okienka zadań.
Wystawiać przedmiotów w dodatku do innych rozwiązań Microsoft Office.	Zastąpić RequestComAddInAutomationService metoda.Aby uzyskać więcej informacji, zobacz Wywołanie kodu w dodatki poziomie aplikacji z innych rozwiązań pakietu Office.
Aby dostosować funkcja w systemie Microsoft Office implementacji interfejsów rozszerzeń.	Zastąpić RequestService metoda zwraca instancji klasy, która implementuje interfejs.Aby uzyskać więcej informacji, zobacz Dostosowywanie funkcji interfejsu użytkownika przy użyciu interfejsów rozszerzalności. Uwaga Aby dostosować na wstążce interfejsu użytkownika, można także zastąpić CreateRibbonExtensibilityObject metoda.

Opis projektu klasy ThisAddIn

W projektach z programem .NET Framework 4, Microsoft.Office.Tools.AddIn jest interfejsem.ThisAddIn Klasa pochodzi od Microsoft.Office.Tools.AddInBase klasy.Ta klasa podstawowa przekierowuje wywołania do swoich członków do wykonania wewnętrznego Microsoft.Office.Tools.AddIn interfejsu w Visual Studio 2010 Tools for Office Runtime.

W projektach dodatek dla programu Outlook ThisAddIn klasa pochodzi od Microsoft.Office.Tools.Outlook.OutlookAddIn klasy w przedsięwzięciami 3.5.NET Framework i z Microsoft.Office.Tools.Outlook.OutlookAddInBase w projektach z programem .NET Framework 4.Te klasy podstawowej zapewniają kilka dodatkowych funkcji w celu wspierania regionów formularzy.Aby uzyskać więcej informacji na temat regionów formularzy, zobacz Tworzenie regionów formularzy programu Outlook.

Dostosowywanie interfejsu użytkownika aplikacji pakietu Microsoft Office

Aplikacje interfejsu użytkownika pakietu Microsoft Office można dostosować programowo przy użyciu dodatku poziomie aplikacji.Na przykład Dostosowywanie Wstążki, wyświetlanie niestandardowych okienko zadań lub tworzenia regionu niestandardowego formularza w programie Outlook.Aby uzyskać więcej informacji, zobacz Dodatek dostosowywania interfejsu użytkownika pakietu Office.

Visual Studio zapewnia projektantom i klas, których można używać do tworzenia niestandardowych okienek zadań, dostosowania Wstążki i regionów formularzy programu Outlook.Te projektantów i klas pomagają uprościć proces dostosowywania tych funkcji.Aby uzyskać więcej informacji, zobacz Niestandardowe okienka zadań, Projektant wstążki, i Tworzenie regionów formularzy programu Outlook.

Jeśli chcesz dostosować jeden z tych funkcji w sposób, który nie jest obsługiwany przez klasy i projektantów, można również dostosować te funkcje, implementując rozszerzalności interfejsu w dodatku.Aby uzyskać więcej informacji, zobacz Dostosowywanie funkcji interfejsu użytkownika przy użyciu interfejsów rozszerzalności.

Ponadto dokumenty interfejsu użytkownika programu Word i skoroszytów programu Excel można zmodyfikować przez generowanie elementów hosta rozszerzających zachowanie dokumentów i skoroszytów.Dzięki temu można dodać formanty zarządzane do dokumentów i arkuszy.Aby uzyskać więcej informacji, zobacz Rozszerzanie dokumenty programu Word oraz skoroszyty programu Excel w dodatki poziomie aplikacji w czasie wykonywania.

Wywołanie kodu w poziomie aplikacji dodatków z innych rozwiązań

Obiekty można wystawiać w dodatku do innych rozwiązań, w tym innych rozwiązań pakietu Office.Jest to przydatne, jeśli Twój zapewnia usługi, które chcesz włączyć inne rozwiązania użyć.Na przykład jeśli dodatek dla programu Microsoft Office Excel wykonuje obliczenia na danych finansowych z usługi sieci web, inne rozwiązania można wykonać te obliczenia dzwoniąc do dodatku Excel w czasie wykonywania.

Aby uzyskać więcej informacji, zobacz Wywołanie kodu w dodatki poziomie aplikacji z innych rozwiązań pakietu Office.

Zobacz też

Udostępnij za pośrednictwem

Programowanie aplikacji poziom dodatki

Za pomocą klasy ThisAddIn

Uzyskiwanie dostępu do modelu obiektu hosta aplikacji

Uzyskiwanie dostępu do dokumentu podczas uruchamiania aplikacji pakietu Office

Członkowie ThisAddIn się do innych zadań

Opis projektu klasy ThisAddIn

Dostosowywanie interfejsu użytkownika aplikacji pakietu Microsoft Office

Wywołanie kodu w poziomie aplikacji dodatków z innych rozwiązań

Zobacz też

Zadania

Koncepcje

Inne zasoby

Dodatkowe zasoby