Tworzenie regionów formularzy programu Outlook
Regiony formularzy umożliwiają dostosowywanie formularzy programu Microsoft Office Outlook. Program Visual Studio udostępnia zaawansowane narzędzia, które ułatwiają projektowanie, opracowywanie i debugowanie regionów formularzy.
Dotyczy: informacje w tym temacie dotyczą projektów dodatków VSTO dla programu Outlook. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.
Ten temat zawiera następujące informacje:
Zalety korzystania z regionów formularzy
Regiony formularzy oferują wiele ulepszeń w przypadku tradycyjnego tworzenia formularzy programu Outlook:
Dostosuj domyślną stronę dowolnego formularza standardowego.
Dodaj maksymalnie 12 dodatkowych stron do dowolnego formularza standardowego.
Zastąp lub ulepsz dowolny standardowy formularz.
Wyświetlanie niestandardowego interfejsu użytkownika w okienku do czytania i w inspektorach.
Aby uzyskać więcej informacji, zobacz Dostosowywanie stron formularzy i regionów formularzy.
Dodawanie regionu formularza programu Outlook do projektu
Za pomocą kreatora Nowy region formularza programu Outlook można zaprojektować nowy region formularza lub zaimportować region formularza zaprojektowany w programie Outlook. Ponadto jeśli masz region formularza używany w innym projekcie dodatku programu Outlook VSTO, możesz ponownie użyć istniejącego regionu formularza.
Tworzenie nowego regionu formularza przy użyciu kreatora
Aby utworzyć region formularza, dodaj element Region formularza programu Outlook do projektu dodatku VSTO programu Outlook. Spowoduje to uruchomienie kreatora Nowy region formularza programu Outlook.
Użyj kreatora, aby wskazać, czy chcesz zaprojektować nowy region formularza, czy zaimportować region formularza zaprojektowany w programie Outlook. Aby uzyskać więcej informacji na temat projektowania nowego regionu formularza, zobacz Używanie projektanta regionów formularzy. Aby uzyskać więcej informacji na temat korzystania z regionu formularza zaprojektowanego w programie Outlook, zobacz Importowanie regionu formularza zaprojektowanego w programie Outlook.
Użyj kreatora, aby określić typ regionu formularza, który chcesz utworzyć. W poniższej tabeli opisano każdy typ regionu formularza.
| Typ regionu | opis |
|---|---|
| Rozdziel | Dodaje region formularza jako nową stronę w formularzu programu Outlook. |
| Sąsiadujących | Dołącza region formularza do dołu strony domyślnej formularza programu Outlook. |
| Zastąpienie | Dodaje region formularza jako nową stronę, która zastępuje domyślną stronę formularza programu Outlook. |
| Zamień wszystko | Zastępuje cały formularz programu Outlook regionem formularza. |
Możesz również użyć kreatora, aby określić warunki wyświetlania i wybrać typ formularza do rozszerzenia. Aby uzyskać więcej informacji, zobacz How to: Add a form region to an Outlook Add-in project (Instrukcje: dodawanie regionu formularza do projektu dodatku programu Outlook).
Wybrane opcje w kreatorze mają wpływ na opcje dostępne na innych stronach kreatora. Na przykład w przypadku wybrania pozycji Przyleganie lub Oddzielenie na stronie Tworzenie nowego regionu formularza programu Outlook pola Tytuł i Opis są niedostępne w tekście opisowym Podaj i wybierz stronę preferencji wyświetlania. Dzieje się tak, ponieważ program Outlook nie używa tych pól podczas wyświetlania przylegającego lub oddzielnego regionu formularza.
Pliki regionów formularza
Po zakończeniu pracy kreatora Nowy region formularzy programu Outlook program Visual Studio automatycznie dodaje następujące pliki do projektu:
Plik kodu regionu formularza. Ten plik ma nazwę określaną dla elementu Region formularza programu Outlook w oknie dialogowym Dodawanie nowego elementu . Dodaj kod do obsługi zdarzeń regionu formularza do tego pliku.
Plik kodu projektanta regionu formularza. Ten plik zawiera kod wygenerowany przez projektanta regionów formularza i nie powinien być edytowany bezpośrednio.
Plik magazynu formularzy programu Outlook (.ofs).
Uwaga
Ten plik jest dodawany tylko do projektu, jeśli importujesz region formularza zaprojektowany w programie Outlook.
Klasa fabryki regionów formularzy
Plik kodu regionu formularza zawiera klasę częściową, która implementuje IFormRegionFactory interfejs. Jest to klasa fabryki regionów formularzy. Klasa fabryki regionów formularzy jest odpowiedzialna za tworzenie nowych wystąpień regionu formularza.
Tę klasę można znaleźć, rozwijając region fabryki regionów formularzy .
Kreator Nowy region formularza programu Outlook dodaje atrybuty do tej klasy, które określają wewnętrzną nazwę regionu formularza i klasy komunikatów, które wyświetlają region formularza. Te atrybuty można modyfikować ręcznie po dodaniu pliku do projektu.
Większość klasy fabryki regionów formularzy jest implementowana w pliku projektanta regionów formularzy. Jednak FormRegionInitializing program obsługi zdarzeń jest uwidoczniony w pliku kodu regionu formularza. Tego programu obsługi zdarzeń można użyć do określenia, czy program Outlook powinien wyświetlać region formularza. Aby uzyskać więcej informacji, zobacz Handle form region events (Obsługa zdarzeń w regionie formularza).
Dodawanie istniejącego regionu formularza do projektu
Jeśli masz region formularza programu Outlook używany w innym projekcie programu Outlook, możesz użyć go ponownie w bieżącym projekcie dodatku programu Outlook VSTO za pomocą okna dialogowego Dodawanie istniejącego elementu .
Istniejący region formularza musi mieć plik kodu (vb lub cs); nie można dodawać plików magazynu formularzy programu Outlook (.ofs) przy użyciu okna dialogowego Dodawanie istniejącego elementu. Można jednak utworzyć nowy region formularza, importując plik magazynu formularzy programu Outlook. Aby uzyskać więcej informacji, zobacz How to: Add a form region to an Outlook Add-in project (Instrukcje: dodawanie regionu formularza do projektu dodatku programu Outlook).
Korzystanie z projektanta regionów formularzy
Projektant regionów formularzy ułatwia projektowanie układu i wyglądu regionu formularza. Możesz przeciągnąć kontrolki zarządzane na powierzchnię projektanta, kliknąć dwukrotnie kontrolki, aby otworzyć programy obsługi zdarzeń i ustawić właściwości w oknie Właściwości .
Uwaga
Właściwości wpływające na sposób wyświetlania regionu formularza w programie Outlook pod węzłem Manifest w oknie Właściwości .
Projektant regionów formularzy jest dostępny tylko wtedy, gdy w kreatorze Nowy region formularza programu Outlook wybierzesz pozycję Projekt nowego regionu formularza .
Istnieją trzy sposoby otwierania projektanta regionów formularzy:
W Eksplorator rozwiązań kliknij dwukrotnie plik kodu regionu formularza.
W Eksplorator rozwiązań kliknij prawym przyciskiem myszy plik kodu regionu formularza, a następnie kliknij polecenie Wyświetl Projektant.
W Eksplorator rozwiązań wybierz plik kodu regionu formularza, a następnie w menu Widok kliknij Projektant.
Projektant regionów formularzy obsługuje tylko zarządzane kontrolki. Nie można dodać natywnych kontrolek programu Outlook.
Importowanie regionu formularza zaprojektowanego w programie Outlook
Podczas projektowania w programie Outlook można dodawać natywne kontrolki programu Outlook do regionu formularza. Natywne kontrolki programu Outlook umożliwiają powiązanie z danymi programu Outlook w czasie projektowania. Nie można jednak użyć projektanta regionów formularzy, aby dodać kontrolki zarządzane lub zmienić projekt regionu formularza.
Regiony formularzy można zaimportować do projektu dodatku VSTO programu Outlook za pomocą kreatora Nowy region formularza programu Outlook. Na stronie Wybieranie sposobu tworzenia regionu formularza wybierz pozycję Importuj plik magazynu formularzy programu Outlook (.ofs). Następnie możesz przejść do lokalizacji pliku magazynu formularzy programu Outlook (.ofs). (Program Outlook zapisuje regiony formularza jako pliki .ofs ).
Kreator Nowy region formularza programu Outlook kopiuje plik .ofs do katalogu projektu i dodaje odwołania sterujące do pliku projektanta regionów formularzy. Następnie można obsługiwać zdarzenia sterujące w pliku kodu regionu formularza.
Aby obsłużyć zdarzenia w projekcie Visual Basic, wybierz zdarzenie z listy nazw metod w górnej części Edytora kodu.
Aby obsługiwać zdarzenia w projekcie języka C#, subskrybuj zdarzenia sterujące w metodzie FormRegionShowing . Aby uzyskać więcej informacji, zobacz Instrukcje: subskrybowanie i anulowanie subskrypcji zdarzeń (przewodnik programowania w języku C#).
Właściwości regionu formularza można zmienić w InitializeManifest metodzie klasy fabryki regionów formularzy.
Uwaga
Aby zaimportować region formularza, musisz pracować w projekcie przeznaczonym dla tej samej wersji programu Outlook zainstalowanej na komputerze deweloperskim. Jeśli na przykład masz zainstalowany program Outlook 2010, importowanie regionu formularza będzie działać tylko w projekcie przy użyciu szablonu projektu dodatku programu Outlook 2010.
Aktualizowanie projektu zaimportowanego regionu formularza
Kontrolki można dodawać, usuwać lub zmieniać w regionie formularza. Przed wykonaniem tej czynności utwórz kopię zapasową dowolnego kodu dodanego do pliku kodu regionu formularza. Następnie otwórz plik .ofs w programie Outlook, zmodyfikuj region formularza, a następnie zapisz zmiany. Za pomocą kreatora Nowy region formularza programu Outlook zaimportuj zmodyfikowany plik ofs. Następnie możesz wkleić kod do nowego pliku kodu regionu formularza.
Dodawanie kodu niestandardowego do regionu formularza
Microsoft.Office.Tools.Outlook Przestrzeń nazw zapewnia dostęp do klas reprezentujących region formularza, element programu Outlook, który wyświetla region formularza i inne przydatne elementy. Element Region formularza programu Outlook automatycznie dodaje odwołanie do tego zestawu w projekcie i wstawia odpowiednią instrukcję using lub Import w górnej części pliku kodu regionu formularza.
Aby wykonać większość zadań programistycznych programu Outlook, można użyć klas, metod i właściwości w Microsoft.Office.Interop.Outlook przestrzeni nazw. Aby uzyskać więcej informacji na temat modelu obiektów programu Outlook, zobacz Omówienie modelu obiektów programu Outlook. Przykłady typowych zadań, które korzystają z modelu obiektów programu Outlook, zobacz Rozwiązania programu Outlook.
Obsługa zdarzeń w regionie formularza
Element Region formularza programu Outlook automatycznie dodaje następujące trzy programy obsługi zdarzeń do pliku kodu regionu formularza.
| Wydarzenie | opis |
|---|---|
| FormRegionInitializing | Występuje przed zainicjowanym regionem formularza. Możesz sprawdzić warunki w tym programie obsługi zdarzeń, aby określić, czy program Outlook powinien wyświetlać region formularza. Aby uzyskać więcej informacji, zobacz How to: Prevent Outlook from displaying a form region (Instrukcje: uniemożliwianie programowi Outlook wyświetlania regionu formularza). |
| FormRegionPokażanie | Występuje po utworzeniu wystąpienia obszaru formularza, ale przed pojawieniem się obszaru formularza. |
| FormRegionClosed | Występuje przed zamknięciem obszaru formularza. |
Kompilowanie projektu
Podczas tworzenia projektu dodatku programu Outlook VSTO zawierającego region formularza program Visual Studio dodaje następujące informacje do rejestru:
Klucz dla każdej klasy komunikatów, który jest skojarzony z co najmniej jednym regionem formularza.
Wpis dla każdego regionu formularza i skojarzona wartość reprezentująca nazwę dodatku programu Outlook VSTO.
Program Outlook używa tych informacji do ładowania regionów formularza.
Debugowanie regionu formularza
Możesz debugować dodatek programu Outlook VSTO zawierający region formularza tak samo jak w przypadku debugowania innych projektów programu Visual Studio. Po uruchomieniu debugera programu Visual Studio program Visual Studio automatycznie uruchamia program Outlook.
Aby wyświetlić region formularza, musisz otworzyć odpowiedni element programu Outlook. Jeśli na przykład przylegający region formularza jest dołączany do dolnej części elementu poczty, otwórz element poczty.
Wdrażanie regionu formularza
Regiony formularzy są wdrażane automatycznie wraz ze skojarzonym dodatkiem programu Outlook VSTO. W związku z tym nie trzeba wykonywać żadnych specjalnych zadań w celu wdrożenia regionu formularza. Aby uzyskać więcej informacji na temat wdrażania dodatków VSTO, zobacz Wdrażanie rozwiązania pakietu Office.
Powiązane tematy
| Nazwa | opis |
|---|---|
| Wskazówki dotyczące tworzenia regionów formularzy programu Outlook | Zawiera informacje ułatwiające optymalizowanie regionów formularzy i unikanie potencjalnych problemów. |
| Instrukcje: dodawanie regionu formularza do projektu dodatku programu Outlook | Pokazuje, jak utworzyć region formularza w celu rozszerzenia standardowego lub niestandardowego formularza programu Microsoft Office Outlook przy użyciu kreatora Nowy region formularza programu Outlook. |
| Kojarzenie regionu formularza z klasą wiadomości programu Outlook | Wyjaśnia, jak określić, które elementy programu Microsoft Office Outlook wyświetlają region formularza, kojarząc region formularza z klasą komunikatów każdego elementu. |
| Przewodnik: projektowanie regionu formularza programu Outlook | Pokazuje, jak zaprojektować niestandardowy region formularza, który jest wyświetlany jako nowa strona w oknie Inspector (Inspektor) elementu kontaktu. |
| Przewodnik: importowanie regionu formularza zaprojektowanego w programie Outlook | Pokazuje, jak zaprojektować region formularza w programie Microsoft Office Outlook, a następnie zaimportować region formularza do projektu dodatku VSTO programu Outlook przy użyciu kreatora Nowy region formularza programu Outlook. |
| Uzyskiwanie dostępu do regionu formularza w czasie wykonywania | Opisuje sposób pisania kodu w celu wyświetlania, ukrywania lub modyfikowania kontrolek w regionie formularza oraz umożliwienia użytkownikom uruchamiania kodu z innych obszarów w projekcie przy użyciu Globals klasy . |
| Instrukcje: zapobieganie wyświetlaniu regionu formularza przez program Outlook | Pokazuje, jak uniemożliwić programowi Microsoft Office Outlook wyświetlanie regionu formularza dla określonego elementu. |
| Pokazuje, jak uzyskać dostęp do elementu programu Outlook, w którym jest wyświetlany region formularza. | |
| Akcje niestandardowe w regionach formularzy programu Outlook | W tym artykule opisano, jak umożliwić użytkownikom reagowanie na element programu Outlook. |