Udostępnij za pośrednictwem

Omówienie modelu obiektów programu Outlook

  • Artykuł

Aby opracować dodatki VSTO dla programu Microsoft Office Outlook, można wchodzić w interakcje z obiektami udostępnianymi przez model obiektów programu Outlook. Model obiektów programu Outlook udostępnia klasy i interfejsy reprezentujące elementy w interfejsie użytkownika. Na przykład Application obiekt reprezentuje całą aplikację, Folder obiekt reprezentuje folder zawierający wiadomości e-mail lub inne elementy, a MailItem obiekt reprezentuje wiadomość e-mail.

Ten temat zawiera krótkie omówienie niektórych głównych obiektów w modelu obiektów programu Outlook. Aby uzyskać więcej informacji na temat całego modelu obiektów programu Outlook, zobacz Korzystanie z dokumentacji modelu obiektów programu Outlook.

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.

Uzyskiwanie dostępu do obiektów w projekcie programu Outlook

Program Outlook udostępnia wiele obiektów, z którymi można korzystać. Aby efektywnie korzystać z modelu obiektów, należy zapoznać się z następującymi obiektami najwyższego poziomu:

Obiekt aplikacji

Obiekt Application reprezentuje aplikację outlook i jest to obiekt najwyższego poziomu w modelu obiektów programu Outlook. Oto niektóre z najważniejszych elementów członkowskich tego obiektu:

  • Metoda CreateItem , której można użyć do utworzenia nowego elementu, takiego jak wiadomość e-mail, zadanie lub termin.

  • Właściwość Explorers , której można użyć do uzyskiwania dostępu do okien, które wyświetlają zawartość folderu w interfejsie użytkownika programu Outlook.

  • Właściwość Inspectors , której można użyć do uzyskiwania dostępu do okien, które wyświetlają zawartość pojedynczego elementu, takie jak wiadomość e-mail lub żądanie spotkania.

    Aby uzyskać wystąpienie Application obiektu, użyj pola ThisAddIn Aplikacja klasy w projekcie. Aby uzyskać więcej informacji, zobacz Program VSTO Add-ins (Dodatki programu VSTO).

Uwaga

Aby uniknąć ostrzeżeń dotyczących zabezpieczeń podczas używania właściwości i metod, które są blokowane przez ochronę modelu obiektów programu Outlook, pobierz obiekty programu Outlook z pola ThisAddIn Aplikacja klasy . Aby uzyskać więcej informacji, zobacz Konkretne zagadnienia dotyczące zabezpieczeń dla rozwiązań pakietu Office.

Obiekt Eksploratora

Obiekt Explorer reprezentuje okno, w którym jest wyświetlana zawartość folderu zawierającego elementy, takie jak wiadomości e-mail, zadania lub terminy. Obiekt Explorer zawiera metody i właściwości, których można użyć do modyfikowania okna oraz zdarzeń zgłaszanych podczas zmiany okna.

Aby uzyskać Explorer obiekt, wykonaj jedną z następujących czynności:

Obiekt Inspector

Obiekt Inspector reprezentuje okno, które wyświetla pojedynczy element, taki jak wiadomość e-mail, zadanie lub termin. Obiekt Inspector zawiera metody i właściwości, których można użyć do modyfikowania okna oraz zdarzeń zgłaszanych podczas zmiany okna.

Aby uzyskać Inspector obiekt, wykonaj jedną z następujących czynności:

Obiekt folderu

Obiekt Folder reprezentuje folder zawierający wiadomości e-mail, kontakty, zadania i inne elementy. Program Outlook udostępnia 16 obiektów domyślnych Folder .

Folder Domyślne obiekty są definiowane przez OlDefaultFolders wartości wyliczenia. Przykład:

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox odpowiada folderowi Skrzynka odbiorcza w programie Outlook.

Przykład pokazujący, jak uzyskać dostęp do domyślnego Folder i utworzyć nowy Folderelement , zobacz Instrukcje: Programowe tworzenie niestandardowych elementów folderów.

MailItem, obiekt

Obiekt MailItem reprezentuje wiadomość e-mail. MailItem obiekty są zwykle w folderach, takich jak Skrzynka odbiorcza, Elementy wysłane i Skrzynka nadawcza. MailItem Uwidacznia właściwości i metody, których można użyć do tworzenia i wysyłania wiadomości e-mail.

Aby zapoznać się z przykładem tworzenia wiadomości e-mail, zobacz Instrukcje: Programowe tworzenie elementu wiadomości e-mail.

Obiekt AppointmentItem

Obiekt AppointmentItem reprezentuje spotkanie, termin jednorazowy lub termin cykliczny lub spotkanie w folderze Kalendarz . Obiekt AppointmentItem zawiera metody, które wykonują akcje, takie jak odpowiadanie na żądania spotkań lub przekazywanie ich do nich, oraz właściwości określające szczegóły spotkania, takie jak lokalizacja i godzina.

Przykład pokazujący, jak utworzyć termin, zobacz Instrukcje: Programowe tworzenie żądania spotkania.

TaskItem, obiekt

Obiekt TaskItem reprezentuje zadanie do wykonania w określonym przedziale czasu. TaskItem obiekty znajdują się w folderze Tasks .

Aby utworzyć zadanie, użyj metody Application CreateItem obiektu i przekaż wartość olTaskItem parametru .

ContactItem, obiekt

Obiekt ContactItemreprezentuje kontakt w folderze Kontakty . ContactItem obiekty zawierają różne informacje kontaktowe dla osób, które reprezentują, takich jak adresy uliczne, adresy e-mail i numery telefonów.

Przykład pokazujący, jak utworzyć nowy kontakt, zobacz Instrukcje: Programowe dodawanie wpisu do kontaktów programu Outlook. Przykład pokazujący, jak wyszukać istniejący kontakt, zobacz Instrukcje: Programowe wyszukiwanie określonego kontaktu.

Korzystanie z dokumentacji modelu obiektów programu Outlook

Aby uzyskać pełne informacje na temat modelu obiektów programu Outlook, możesz zapoznać się z dokumentacją podstawowego zestawu międzyoperacowego programu Outlook i dokumentacją modelu obiektów VBA.

Dokumentacja podstawowego zestawu międzyoperajowego

Usługa Outlook PIA odwołuje się do dokumentów typów w podstawowych zestawach międzyoperacyjnych dla programu Outlook 2010. Aby uzyskać więcej informacji, zobacz Podstawowe informacje o zestawie międzyoperajności programu Outlook 2010.

Oprócz udostępniania informacji dla wszystkich typów w usługach PIA, ta dokumentacja zawiera również dodatkowe informacje na temat struktury umów PIA i przykładów kodu typowych zadań automatyzacji programu Outlook.

Dokumentacja modelu obiektów VBA

Model obiektów VBA odwołuje się do dokumentów modelu obiektów programu Outlook, który jest uwidaczniony w kodzie języka Visual Basic for Applications (VBA). Aby uzyskać więcej informacji, zobacz Dokumentacja modelu obiektów programu Outlook 2010.

Wszystkie obiekty i elementy członkowskie w odwołaniu do modelu obiektów VBA odpowiadają typom i członkom w usłudze Outlook PIA. Na przykład obiekt Inspector w odwołaniu do modelu obiektów VBA odpowiada Inspector obiektowi w usłudze Outlook PIA. Mimo że odwołanie do modelu obiektów VBA zawiera przykłady kodu dla większości właściwości, metod i zdarzeń, należy przetłumaczyć kod VBA w tym odwołaniu do języka Visual Basic lub Visual C#, jeśli chcesz ich używać w projekcie dodatku VSTO programu Outlook utworzonym przy użyciu programu Visual Studio.

Nazwa opis
Praca z elementami kontaktów Zawiera tematy pokazujące sposób wykonywania zadań z kontaktami.
Praca z elementami poczty Zawiera tematy pokazujące sposób wykonywania zadań za pomocą elementów poczty.
Praca z folderami Zawiera tematy pokazujące sposób wykonywania zadań z folderami.
Praca z elementami kalendarza Zawiera tematy pokazujące sposób wykonywania zadań z elementami kalendarza.
Instrukcje: Programowe określanie bieżącego elementu programu Outlook Pokazuje, jak wyświetlić nazwę bieżącego folderu i niektóre informacje o wybranym elemencie.