Niestandardowe okienka zadań

Panele interfejsu użytkownika, które zazwyczaj są zadokowane po jednej stronie okna w aplikacji pakietu Microsoft Office są okienka zadań.Niestandardowe okienka zadań dać sposób, aby utworzyć własne okienko zadań i zapewnić użytkownikom znajomy interfejs na dostęp do funkcji swoje rozwiązanie.Na przykład interfejs może zawierać formanty, które uruchomić kod na modyfikowanie dokumentów lub wyświetlania danych ze źródła danych.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie aplikacji obsługiwanych w programach Outlook 2013 i Outlook 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.

[!UWAGA]

Niestandardowe okienko zadań różni się w okienku Akcje.W okienku akcji jest częścią dostosowania poziomie dokumentu dla programu Microsoft Office Word i Microsoft Office Excel.Aby uzyskać więcej informacji, zobacz Okienko akcji ― Omówienie.

Korzyści z niestandardowego okienka zadań

Niestandardowe okienka zadań pozwala zintegrować swoje funkcje interfejsu użytkownika.Szybko okienko zadań niestandardowe można utworzyć przy użyciu narzędzi Visual Studio.

Znajomy interfejs użytkownika

Użytkownicy aplikacji Microsoft Office System są dobrze zaznajomieni z przy użyciu okienka zadań, takich jak Style i formatowanie okienko zadań w programie Word.Niestandardowe okienka zadań zachowują się podobnie jak inne okienka zadań w systemie Microsoft Office.Użytkowników można zadokować niestandardowe okienka zadań na różnych stronach w oknie aplikacji lub ich przeciągnij niestandardowe okienka zadań, dowolne miejsce w oknie.Można utworzyć dodatku, który wyświetla wiele niestandardowych okienek zadań w tym samym czasie, a użytkownicy mogą kontrolować każdego okienko zadań indywidualnie.

Obsługa Windows Forms

Interfejs użytkownika niestandardowego okienko zadań, utworzony za pomocą narzędzi programistycznych pakietu Office w programie Visual Studio jest oparty na Windows Forms kontroli.Znane Projektant Windows Forms można użyć do projektowania interfejsu użytkownika dla niestandardowych okienko zadań.Umożliwia także obsługę powiązania danych w Windows Forms do źródła danych należy powiązać formanty na okienko zadań.

Tworzenie niestandardowego okienka zadań

Podstawowe okienko zadań niestandardowe można tworzyć w dwóch etapach:

  1. Tworzenie interfejsu użytkownika dla użytkownika niestandardowego okienko zadań poprzez dodawanie formantów, Windows Forms do UserControl obiektu.

  2. Przez przekazanie kontroli użytkownika do utworzenia wystąpienia niestandardowe okienko zadań CustomTaskPaneCollection obiektu w dodatku.Ta kolekcja zwraca nowy CustomTaskPane obiekt, który można zmodyfikować wygląd okienko zadań i reagowania na zdarzenia użytkownika.

Aby uzyskać więcej informacji, zobacz Porady: dodawanie niestandardowego okienka zadań do aplikacji.

Tworzenie interfejsu użytkownika

Wszystkie niestandardowe okienka zadań, które są tworzone za pomocą narzędzi programistycznych pakietu Office w programie Visual Studio zawiera UserControl obiektu.Ten formant użytkownika zapewnia interfejs użytkownika swoje niestandardowe okienko zadań.Można utworzyć formantu użytkownika w czasie projektowania lub w czasie wykonywania.Jeśli tworzysz formant użytkownika w czasie projektowania, można użyć projektanta Windows Forms zbudować interfejs użytkownika sieci okienko zadań.

Utworzenie wystąpienia niestandardowe okienko zadań

Po utworzeniu formant użytkownika, który zawiera okienko zadań niestandardowy interfejs użytkownika, musisz utworzyć wystąpienia CustomTaskPane.Aby to zrobić, należy przekazać formant użytkownika do CustomTaskPaneCollection w dodatku, wywołując jedną z Add metody.Ta kolekcja jest ujawniona jako CustomTaskPanes pole ThisAddIn klasy.Poniższy przykład kodu jest przeznaczony do uruchomienia z ThisAddIn klasy.

myUserControl1 = New MyUserControl
myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "My Task Pane")
myCustomTaskPane.Visible = True
myUserControl1 = new MyUserControl();
myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, "My Task Pane");
myCustomTaskPane.Visible = true;

Add Metody zwraca nowy CustomTaskPane obiektu.Aby zmodyfikować wygląd okienko zadań i reagowanie na zdarzenia użytkownika, można użyć tego obiektu.

Kontrolowanie w okienku zadań w wielu oknach

Niestandardowe okienka zadań są związane z okna ramki dokumentu, który przedstawia widok dokumentu lub elementu do użytkownika.Okienko zadań jest widoczna tylko wtedy, gdy okno skojarzone jest widoczne.

Aby określić, które okno wyświetla niestandardowych okienko zadań, posługując się odpowiednim Add metoda przeciążenia podczas tworzenia okienko zadań:

Niektóre aplikacje pakietu Office wymagają jednoznaczne instrukcje, gdy do tworzenia lub wyświetlania Twojej okienko zadań, gdy otwarte jest więcej niż jedno okno.To sprawia, że należy rozważyć, gdzie do uruchamiania niestandardowych okienko zadań w kodzie w celu zapewnienia, że okienko zadań pojawia się z odpowiednich dokumentów lub elementów w aplikacji.Aby uzyskać więcej informacji, zobacz Zarządzanie okienek zadań niestandardowych aplikacji systemu Windows.

Uzyskiwanie dostępu do aplikacji z okienka zadań

Chcesz zautomatyzować aplikacji z formantu użytkownika, można przejść bezpośrednio do modelu za pomocą Globals.ThisAddIn.Application w kodzie.Statycznego Globals klasa zapewnia dostęp do ThisAddIn obiektu.Application Pole tego obiektu jest punkt wejścia modelu aplikacji.

Aby uzyskać więcej informacji o Application pole ThisAddIn obiektów, zobacz Programowanie dodatków na poziomie aplikacji.Instruktaż, który pokazuje, jak do automatyzowania aplikacji z okienko zadań niestandardowych, zobacz Wskazówki: automatyzacja aplikacji z niestandardowego okienka zadań.Aby uzyskać więcej informacji o Globals klasy, zobacz Globalny dostęp do obiektów w projektach pakietu Office.

Interfejs użytkownika okienka zadań zarządzania

Po utworzeniu okienko zadań, można użyć właściwości i zdarzenia CustomTaskPane do sterowania interfejsem użytkownika, z okienko zadań i odpowiadać, gdy użytkownik zmieni okienko zadań obiektów.

Udostępnienie niestandardowe okienko zadań

Domyślnie okienko zadań nie jest widoczny.Aby wyświetlić okienko zadań, należy ustawić Visible właściwość, aby true.

Użytkownicy mogą zamknąć okienko zadań w dowolnym momencie, klikając zamknąć przycisk (X) w rogu okienko zadań.Istnieje jednak żaden sposób domyślnego dla użytkowników ponownie otworzyć okienko zadań niestandardowe.Jeśli użytkownik zamknie niestandardowe okienko zadań, że użytkownik nie może wyświetlić niestandardowego okienko zadań ponownie dopiero po podaniu sposób, aby go wyświetlić.

Tworzenia niestandardowych okienko zadań w dodatku, należy również utworzyć element interfejsu użytkownika, na przykład przycisk, który użytkownicy mogą kliknąć, aby wyświetlić lub ukryć swoje niestandardowe okienko zadań.Po utworzeniu niestandardowego okienko zadań w aplikacji pakietu Microsoft Office, obsługujący Dostosowywanie Wstążki, można dodać grupę formantów do wstążki, za pomocą przycisku, który wyświetla lub ukrywa swoje niestandardowe okienko zadań.Instruktaż, który pokazuje, jak to zrobić, zobacz Wskazówka: synchronizacja niestandardowego okienka zadań z przyciskiem wstążki.

Jeśli tworzenia niestandardowych okienko zadań w aplikacji pakietu Microsoft Office, który nie obsługuje Dostosowywanie Wstążki, można dodać CommandBarButton , wyświetla lub ukrywa swoje niestandardowe okienko zadań.

Modyfikowanie wyglądu okienka zadań

Można kontrolować za pomocą właściwości rozmiar i położenie niestandardowe okienko zadań CustomTaskPane obiektu.Można dokonywać wielu zmian innych wygląd okienko zadań niestandardowych za pomocą właściwości UserControl obiekt, który jest zawarty w okienko zadań niestandardowe.Na przykład, można określić obraz jako tło dla okienko zadań niestandardowych za pomocą BackgroundImage właściwość formantu użytkownika.

W poniższej tabeli wymieniono zmiany można wprowadzać niestandardowych okienko zadań za pomocą CustomTaskPane właściwości.

Zadanie

Właściwość

Aby zmienić rozmiar okienko zadań

Height

Width

Aby zmienić położenie okienko zadań

DockPosition

Aby ukryć okienko zadań lub stał się widoczny

Visible

Aby uniemożliwić użytkownikowi dokonywanie zmian w lokalizacji okienko zadań

DockPositionRestrict

Programowanie zdarzenia w okienku zadania niestandardowe

Możesz dodatek reagować, gdy użytkownik zmodyfikuje niestandardowe okienko zadań.Na przykład jeśli użytkownik zmieni orientacji okienka z pionowej na poziomą, można zmienić położenie formantów.

Poniższa tabela zawiera listę zdarzeń, może obsłużyć do reagowania na zmiany, które użytkownik wprowadza okienko zadań niestandardowe.

Zadanie

Zdarzenie

Aby reagować, gdy użytkownik zmienia położenie okienko zadań.

DockPositionChanged

Aby reagować, gdy użytkownik ukrywa okienko zadań lub sprawia, że widoczne.

VisibleChanged

Czyszczenie zasoby używane przez okienko zadań

Po utworzeniu niestandardowego okienko zadań, CustomTaskPane obiekt pozostaje w pamięci, tak długo, jak długo jest uruchomiony dodatek.Obiekt pozostaje w pamięci, nawet po kliknięciu przez użytkownika Zamknij przycisk (X) w rogu okienko zadań.

Aby oczyścić zasoby używane przez okienko zadań, podczas gdy nadal jest uruchomiony dodatek, należy użyć Remove lub RemoveAt metody.Te metody usuwania określonego CustomTaskPane obiekt z CustomTaskPanes kolekcji i mogą wywoływać Dispose metody obiektu.

Visual Studio Tools for Office Runtime Automatycznie czyści zasoby używane przez niestandardowe okienko zadań, gdy dodatek jest zwalniana.Nie wywołuj Remove lub RemoveAt metody w ThisAddIn_Shutdown obsługi zdarzeń w projekcie.Metody te będą rzucać ObjectDisposedException, bo Visual Studio Tools for Office Runtime czyści zasoby używane przez CustomTaskPane obiekt przed ThisAddIn_Shutdown nazywa się.Aby uzyskać więcej informacji o ThisAddIn_Shutdown, zobaczZdarzenia w projektach pakietu Office

Zarządzanie niestandardowe okienka zadań w wielu aplikacji systemu Windows.

Podczas tworzenia niestandardowych okienko zadań w aplikacji, która korzysta z wielu okien do wyświetlania dokumentów i innych elementów, należy podjąć dodatkowe kroki w celu zapewnienia, że okienko zadań jest widoczna, gdy użytkownik oczekuje się.

Niestandardowe okienka zadań we wszystkich aplikacjach są związane z okna ramki dokumentu, który przedstawia widok dokumentu lub elementu do użytkownika.Okienko zadań jest widoczna tylko wtedy, gdy okno skojarzone jest widoczne.Jednak nie wszystkie aplikacje używają windows ramce dokument ten sam sposób.

Następujące grupy aplikacji mają wymagania różnych rozwoju:

  • Program Outlook

  • Program Word, program InfoPath i PowerPoint

łącze do wideo Aby wyświetlić pokrewne wideo demonstracyjne, zobacz jak zrobić I: zarządzać okienek zadań w dodatki programu Word?.

Program Outlook

Podczas tworzenia niestandardowych okienko zadań dla programu Outlook, okienko zadań niestandardowy jest skojarzony z określone okno Eksploratora lub Inspektora.Badacze są windows umożliwiające wyświetlanie zawartości folderu, a inspektorzy są okien wyświetlających element taki jak wiadomość e-mail lub zadanie.

Aby wyświetlić niestandardowe okienko zadań z wieloma Eksploratora lub Inspektora, windows, należy utworzyć nową instancję niestandardowej okienko zadań, gdy otwiera się okno Eksploratora lub Inspektora.Aby to zrobić, obsługiwać zdarzenie jest wywoływane, gdy jest tworzony w oknie Eksploratora lub Inspektora, a następnie utwórz okienko zadań programu obsługi zdarzeń.Może również obsługiwać zdarzenia Explorer i Inspektor, aby ukryć lub wyświetlanie okienek zadań w zależności od tego, które okno jest widoczny.

Aby skojarzyć okienko zadań z konkretnych Eksploratora lub Inspektora, użyj CustomTaskPaneCollection.Add(UserControl, String, Object) do tworzenia okienko zadań i przekazać Explorer lub Inspector obiekt do window parametru.Aby uzyskać więcej informacji na temat tworzenia niestandardowych okienek zadań, zobacz Niestandardowe okienka zadań.

Instruktaż, który pokazuje, jak utworzyć okienko zadań dla każdej wiadomości e-mail, który jest otwarty, zobacz Wskazówki: wyświetlanie niestandardowych okienek zadań z wiadomościami e-mail w programie Outlook.

Zdarzenia programu Outlook

Aby monitorować stan Eksploratora windows, może obsługiwać następujące zdarzenia związane z Explorer:

Do monitorowania stanu okna Inspektora, może obsługiwać następujące zdarzenia związane z Inspektor:

Zapobieganie wielu wystąpień niestandardowe okienko zadań w programie Outlook

Aby uniemożliwić wyświetlanie wielu wystąpień niestandardowe okienko zadań windows program Outlook, jawnie usunąć niestandardowy okienko zadań z CustomTaskPanes Kolekcja ThisAddIn klasy po zamknięciu każdego okna.Wywołanie Remove metoda w przypadku, gdy jest wywoływane, gdy okno jest zamknięte, takich jak ExplorerEvents_10_Event.Close lub InspectorEvents_10_Event.Close.

Nie usuwaj jawnie okienko zadań niestandardowe, windows program Outlook może zawierać wiele wystąpień okienko zadań niestandardowe.Program Outlook przetwarza Czasami system windows i windows recyklingu zachować odwołania do wszelkich niestandardowych okienek zadań, które zostały dołączone do nich.

Program Word, program InfoPath i PowerPoint

Program Word, program InfoPath i PowerPoint wyświetlanie każdego dokumentu, w oknie ramki inny dokument.Podczas tworzenia niestandardowych okienko zadań dla tych aplikacji niestandardowej okienko zadań jest skojarzony tylko z określonego dokumentu.Jeśli użytkownik otwiera inny dokument, niestandardowe okienko zadań jest ukryty, dopóki ponownie wcześniejszego dokumentu jest widoczny.

Jeśli chcesz wyświetlić niestandardowe okienko zadań z wielu dokumentów, utworzyć nową instancję niestandardowej okienko zadań, gdy użytkownik tworzy nowy dokument lub otwiera istniejący dokument.Aby to zrobić, obsługi zdarzeń, które są wywoływane, gdy dokument zostanie utworzone lub otwarte, a następnie utwórz okienko zadań w procedurach obsługi zdarzeń.Mogą również obsługiwać zdarzenia dokumentu ukrywanie lub wyświetlanie okienek zadań w zależności od tego, który dokument jest wyświetlany.

Aby skojarzyć okienko zadań z okna konkretnego dokumentu, należy użyć CustomTaskPaneCollection.Add(UserControl, String, Object) do tworzenia okienko zadań i przekazać Window (dla programu Word), WindowObject (dla programu InfoPath), lub DocumentWindow (dla programu PowerPoint) do window parametru.

Zdarzenia programu Word

Do monitorowania stanu okna dokumentu programu Word, może obsługiwać następujące zdarzenia:

Zdarzenia programu InfoPath

Do monitorowania stanu okna dokumentu w programie InfoPath, mogą obsługiwać następujące zdarzenia:

Zdarzenia programu PowerPoint

Do monitorowania stanu okna dokumentu w programie PowerPoint, może obsługiwać następujące zdarzenia:

Zobacz też

Zadania

Porady: dodawanie niestandardowego okienka zadań do aplikacji

Wskazówki: automatyzacja aplikacji z niestandardowego okienka zadań

Wskazówka: synchronizacja niestandardowego okienka zadań z przyciskiem wstążki

Wskazówki: wyświetlanie niestandardowych okienek zadań z wiadomościami e-mail w programie Outlook