Přehled objektového modelu Outlooku

Pokud chcete vyvíjet doplňky VSTO pro aplikace Microsoft Office Outlook, můžete pracovat s objekty, které poskytuje objektový model Outlooku. Objektový model Aplikace Outlook poskytuje třídy a rozhraní, které představují položky v uživatelském rozhraní. Například objekt Application představuje celou aplikaci, Folder objekt představuje složku, která obsahuje e-mailové zprávy nebo jiné položky a MailItem objekt představuje e-mailovou zprávu.

Toto téma obsahuje stručný přehled některých hlavních objektů v objektovém modelu Outlooku. Další informace o celém objektovém modelu Outlooku najdete v dokumentaci k objektovém modelu Outlooku.

Platí pro: Informace v tomto tématu platí pro projekty doplňků VSTO pro Outlook. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Přístup k objektům v projektu Aplikace Outlook

Outlook poskytuje mnoho objektů, se kterými můžete pracovat. Pokud chcete objektový model efektivně používat, měli byste být obeznámeni s následujícími objekty nejvyšší úrovně:

• Application

• Explorer

• Inspector

• Folder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

Objekt aplikace

Objekt Application představuje aplikaci Outlook a je to objekt nejvyšší úrovně v objektovém modelu Aplikace Outlook. Mezi nejdůležitější členy tohoto objektu patří:

• CreateItem metoda, kterou můžete použít k vytvoření nové položky, jako je e-mailová zpráva, úkol nebo událost.

• Vlastnost Explorers , kterou můžete použít pro přístup k okny, která zobrazují obsah složky v uživatelském rozhraní aplikace Outlook.

• Vlastnost Inspectors , kterou můžete použít pro přístup k okny, která zobrazují obsah jedné položky, například e-mailovou zprávu nebo žádost o schůzku.

  Pokud chcete získat instanci objektu Application , použijte pole ThisAddIn Aplikace třídy v projektu. Další informace naleznete v tématu Program VSTO Doplňky.

Objekt Průzkumníka

Objekt Explorer představuje okno, které zobrazuje obsah složky, která obsahuje položky, jako jsou e-mailové zprávy, úkoly nebo události. Objekt Explorer obsahuje metody a vlastnosti, které můžete použít k úpravě okna, a události, které jsou vyvolány při změně okna.

Pokud chcete získat Explorer objekt, udělejte jednu z těchto věcí:

• Explorers Vlastnost objektu Application použijte pro přístup ke všem Explorer objektům v Outlooku.

• ActiveExplorer Použijte metodu objektu Application k získání aktuálně fokusuExplorer.

• GetExplorer K získání aktuální složky použijte metodu Folder objektuExplorer.

Objekt inspektoru

Objekt Inspector představuje okno, které zobrazuje jednu položku, například e-mailovou zprávu, úkol nebo událost. Objekt Inspector obsahuje metody a vlastnosti, které můžete použít k úpravě okna, a události, které jsou vyvolány při změně okna.

Pokud chcete získat Inspector objekt, udělejte jednu z těchto věcí:

• Inspectors Vlastnost objektu Application použijte pro přístup ke všem Inspector objektům v Outlooku.

• ActiveInspector Použijte metodu objektu Application k získání aktuálně fokusuInspector.

• GetInspector Použijte metodu konkrétní položky, například MailItem nebo AppointmentItem, k načtení inspektoru, který je k němu přidružený.

Objekt složky

Objekt Folder představuje složku, která obsahuje e-mailové zprávy, kontakty, úkoly a další položky. Outlook poskytuje 16 výchozích Folder objektů.

Výchozí Folder objekty jsou definovány hodnotami výčtu OlDefaultFolders . Příklad:

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox odpovídá složce Doručená pošta v Outlooku.

Příklad, který ukazuje, jak získat přístup k výchozímu Folder nastavení a vytvořit novou Folder, naleznete v tématu Postupy: Programové vytváření vlastních položek složek.

Objekt MailItem

Objekt MailItem představuje e-mailovou zprávu. MailItem objekty jsou obvykle ve složkách, jako je Doručená pošta, Odeslaná pošta a Pošta k odeslání. MailItem zveřejňuje vlastnosti a metody, které lze použít k vytváření a odesílání e-mailových zpráv.

Příklad, který ukazuje, jak vytvořit e-mailovou zprávu, najdete v tématu Postupy: Vytvoření e-mailové položky prostřednictvím kódu programu.

Objekt AppointmentItem

Objekt AppointmentItem představuje schůzku, jednorázovou událost nebo opakovanou událost nebo schůzku ve složce Kalendář . Objekt AppointmentItem obsahuje metody, které provádějí akce, jako jsou reakce na žádosti o schůzku nebo jejich přeposílání, a vlastnosti, které určují podrobnosti schůzky, jako je umístění a čas.

Příklad, který ukazuje, jak vytvořit událost, viz Postupy: Programové vytvoření žádosti o schůzku.

TaskItem – objekt

Objekt TaskItem představuje úlohu, která se má provést v zadaném časovém rámci. TaskItem objekty jsou umístěny ve složce Úkoly .

Chcete-li vytvořit úlohu, použijte CreateItem metoda Application objektu a předejte hodnotu olTaskItem parametru.

ContactItem – objekt

Objekt ContactItempředstavuje kontakt ve složce Kontakty . ContactItem objekty obsahují řadu kontaktních informací pro osoby, které představují, například poštovní adresy, e-mailové adresy a telefonní čísla.

Příklad znázorňující, jak vytvořit nový kontakt, najdete v tématu Postupy: Přidání položky do kontaktů Outlooku prostřednictvím kódu programu. Příklad, který ukazuje, jak vyhledat existující kontakt, najdete v tématu Postupy: Hledání konkrétního kontaktu prostřednictvím kódu programu.

Použití dokumentace k objektovém modelu Outlooku

Úplné informace o objektovém modelu Aplikace Outlook naleznete v referenční dokumentaci k primárnímu sestavení interop aplikace Outlook (PIA) a odkaz na objektový model jazyka VBA.

Referenční dokumentace primárního sestavení vzájemné spolupráce

Aplikace Outlook PIA odkazuje na typy v primárních sestaveních vzájemné spolupráce pro Aplikaci Outlook 2010. Další informace najdete v tématu Referenční informace k primárnímu sestavení vzájemné spolupráce aplikace Outlook 2010.

Kromě poskytování informací pro všechny typy piA poskytuje tato dokumentace také další informace o struktuře PIA a příkladů kódu pro běžné úlohy automatizace Outlooku.

Referenční dokumentace k objektového modelu jazyka VBA

Referenční model objektu VBA dokumentuje objektový model Outlooku, protože je vystavený kódu jazyk Visual Basic for Application (VBA). Další informace najdete v referenčních informacích k objektového modelu Aplikace Outlook 2010.

Všechny objekty a členy v odkazu na objektový model jazyka VBA odpovídají typům a členům v aplikaci Outlook PIA. Například objekt inspektoru v odkazu na objektový model jazyka VBA odpovídá Inspector objektu v aplikaci Outlook PIA. I když odkaz na objektový model jazyka VBA poskytuje příklady kódu pro většinu vlastností, metod a událostí, musíte kód jazyka VBA v tomto odkazu přeložit do jazyka Visual Basic nebo Visual C#, pokud je chcete použít v projektu doplňku VSTO aplikace Outlook, který vytvoříte pomocí sady Visual Studio.

Příbuzná témata