Přístup k oblasti formuláře za běhu

Použití Globals třídy oblastí formuláře přístup z libovolného místa v rámci projektu aplikace Outlook.Další informace o Globals třídy naleznete v tématu Globální přístup k objektům v projektech pro systém Office.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni aplikace v Outlooku 2013 a v Outlooku 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

Přístup k oblasti formulářů, které se zobrazí v okně Inspektor konkrétní aplikace Outlook

Přístup všech oblastí formulářů v konkrétní Kontrola aplikace Outlook, volat FormRegions vlastnost Globals třídy a předat Inspector objekt, který představuje inspektor.

Následující příklad získá kolekci oblastí formulářů, které se zobrazí v okně Inspektor, který má aktuálně fokus.V tomto příkladu se pak přistupuje k oblasti formuláře v kolekci s názvem formRegion1 a nastaví text, který se zobrazí v textovém poli na Hello World.

Private Sub Access_Form_Regions_ByInspector()
        Dim formRegions As WindowFormRegionCollection = Globals.FormRegions _
            (Globals.ThisAddIn.Application.ActiveInspector())
        formRegions.FormRegion1.textBox1.Text = "Hello World" 
    End Sub

private void Access_Form_Regions_ByInspector()
{
    WindowFormRegionCollection formRegions = 
        Globals.FormRegions
            [Globals.ThisAddIn.Application.ActiveInspector()];
    formRegions.FormRegion1.textBox1.Text = "Hello World";
}

Přístup k oblasti formulářů, které se zobrazí v okně Průzkumník konkrétní aplikace Outlook

Přístup všech oblastí formulářů v konkrétní aplikace Outlook Explorer, volat FormRegions vlastnost Globals třídy a předat Explorer objekt, který představuje aplikace Explorer.

Následující příklad získá kolekci oblastí formuláře, které se zobrazí v Průzkumníku, který má aktuálně fokus.V tomto příkladu se pak přistupuje k oblasti formuláře v kolekci s názvem formRegion1 a nastaví text, který se zobrazí v textovém poli na Hello World.

Private Sub Access_Form_Regions_ByExplorer()
    Dim formRegions As WindowFormRegionCollection = Globals.FormRegions _
        (Globals.ThisAddIn.Application.ActiveExplorer())
    formRegions.FormRegion1.textBox1.Text = "Hello World" 
End Sub

private void Access_Form_Regions_ByExplorer()
{
    WindowFormRegionCollection formRegions =
        Globals.FormRegions
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    formRegions.FormRegion1.textBox1.Text = "Hello World";
}

Přístup všech oblastí formulářů

Přístup všech oblastí formulářů, které se zobrazí v programu Průzkumník všechny a Všichni inspektoři, volat FormRegions vlastnost Globals třídy.

Následující příklad získá kolekci oblastí formuláře, které jsou v programu Průzkumník všechny a Všichni inspektoři.V tomto příkladu pak přistupuje oblast formuláře s názvem formRegion1 a nastaví text, který se zobrazí v textovém poli na Hello World.

Friend Sub Access_All_Form_Regions()
    Dim formRegion As Microsoft.Office.Tools.Outlook.IFormRegion
    For Each formRegion In Globals.FormRegions
        If TypeOf formRegion Is FormRegion1 Then 
            Dim formRegion1 As FormRegion1 = _
                CType(formRegion, FormRegion1)
            formRegion1.textBox1.Text = "Hello World" 
        End If 
    Next formRegion
End Sub

internal void Access_All_Form_Regions()
{
    foreach (Microsoft.Office.Tools.Outlook.IFormRegion formRegion 
        in Globals.FormRegions)
    {
        if (formRegion is FormRegion1)
        {
            FormRegion1 formRegion1 = (FormRegion1)formRegion;
            formRegion1.textBox1.Text = "Hello World";
        }
    }

}

Přístup ovládacích prvků na oblast formuláře

Do oblasti formuláře pomocí řízení přístupu Globals třídy, je nutné provést ovládací prvky přístupné kódu mimo soubor kódu oblasti formuláře.

Oblasti formulářů v oblasti návrháře formuláře

Pro C# změňte modifikátor každého ovládacího prvku, který chcete získat přístup.Vyberte každého ovládacího prvku v návrháři formuláře oblast a změnit Modifikátory vnitřní nebo ve veřejné vlastnosti Vlastnosti okna.Změníte-li například Modifikátor vlastnost textBox1 na interní, přístup k textBox1 zadáním Globals.FormRegions.FormRegion1.textBox1.

V jazyce Visual Basic není nutné změnit modifikátor.

Importované oblastí formulářů

Při importu oblast formuláře, která byla navržena v aplikaci Outlook bude soukromý modifikátor přístupu pro každý ovládací prvek ve formuláři oblasti.Protože oblast Návrhář formuláře nelze použít k úpravě oblasti dovozu, je způsob, jak změnit modifikátor ovládacího prvku v Vlastnosti okna.

Povolit přístup k ovládací prvek mimo soubor kódu oblasti formuláře, vytvořte vlastnost v souboru kódu oblasti formuláře vrátit ovládacího prvku.

Další informace o vytvoření vlastnosti v jazyce C# naleznete Postupy: Deklarování a použití vlastností čtení/zápisu (Průvodce programováním v C#).

Další informace o vytvoření vlastnosti v jazyce Visual Basic naleznete v How to: Add Fields and Properties to a Class.

Viz také

Úkoly

Návod: Návrh oblasti formuláře aplikace Outlook

Postupy: Přidání oblasti formuláře do projektu doplňku pro Outlook

Návod: Import oblasti formuláře navržené v aplikaci Outlook

Postupy: Zabránění zobrazení oblasti formuláře v aplikaci Outlook

Koncepty

Pokyny pro vytváření oblastí formulářů aplikace Outlook

Vlastní akce v oblastech formulářů aplikace Outlook

Přidružení oblasti formuláře k třídě zpráv aplikace Outlook

Přístup k pásu karet za běhu

Další zdroje

Vytváření oblastí formulářů aplikace Outlook