Programowanie dodatków na poziomie aplikacji
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.
Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie aplikacji obsługiwanych w pakietach Microsoft Office 2013 i Microsoft Office 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach 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 Pisanie kodu dla rozwiązań 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 Rozwój rozwiązań Office ― Omówienie.
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 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 |
|
Program Microsoft Office InfoPath |
|
Microsoft Office Outlook |
|
Program Microsoft Office PowerPoint |
|
Program Microsoft Office Project |
Microsoft.Office.Interop.MSProject.Application |
Program Microsoft Office Visio |
Microsoft.Office.Interop.Visio.Application |
Program Microsoft Office Word |
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
private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
this.Application.DocumentOpen +=
new Word.ApplicationEvents4_DocumentOpenEventHandler(WorkWithDocument);
((Word.ApplicationEvents4_Event)this.Application).NewDocument +=
new Word.ApplicationEvents4_NewDocumentEventHandler(WorkWithDocument);
}
private void WorkWithDocument(Microsoft.Office.Interop.Word.Document Doc)
{
try
{
Word.Range rng = Doc.Range(0, 0);
rng.Text = "New Text";
rng.Select();
}
catch (Exception ex)
{
// Handle exception if for some reason the document is not available.
}
}
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.
|
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ływanie kodu w dodatkach na 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 korzystając z rozszerzalności interfejsów.
|
Opis projektu klasy ThisAddIn
W projektach z programem Program .NET Framework 4, AddIn jest interfejsem.ThisAddIn Klasa pochodzi od AddInBase klasy.Ta klasa podstawowa przekierowuje wywołania do swoich członków do wykonania wewnętrznego AddIn interfejsu w Visual Studio 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 OutlookAddInBase w projektach z programem Program .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 w programie 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 Dostosowywanie 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 w programie 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 korzystając z rozszerzalności interfejsów.
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 dokumentów programu Word i skoroszytów w programie Excel w czasie wykonywania w dodatkach na poziomie aplikacji.
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ływanie kodu w dodatkach na poziomie aplikacji z innych rozwiązań pakietu Office.
Zobacz też
Zadania
Wskazówki: wywoływanie kodu w dodatkach na poziomie aplikacji z VBA
Porady: tworzenie projektów Office w Visual Studio
Koncepcje
Wywoływanie kodu w dodatkach na poziomie aplikacji z innych rozwiązań pakietu Office
Dostosowywanie funkcji interfejsu użytkownika korzystając z rozszerzalności interfejsów
Architektura dodatków na poziomie aplikacji
Pisanie kodu dla rozwiązań pakietu Office