Uzyskiwanie dostępu do regionów formularzy w czasie wykonywania

Użycie Globals klasy do regionów formularzy dostęp z dowolnego miejsca w ramach projektu programu Outlook.Aby uzyskać więcej informacji o Globals klasy, zobacz Globalny dostęp do obiektów w projektach pakietu Office.

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.

Uzyskiwanie dostępu do regionów formularzy, które pojawiają się w określone okno inspektora programu Outlook

Dostęp do wszystkich regionów formularzy, które pojawiają się w konkretnych inspektora programu Outlook, call FormRegions właściwość Globals klasy i w Inspector obiekt, który reprezentuje inspektora.

Poniższy przykład pobiera zbiór regionów formularzy, które są wyświetlane w oknie Inspektora, który aktualnie ma fokus.W tym przykładzie następnie uzyskuje dostęp do regionu formularza w kolekcji o nazwie formRegion1 i ustawia tekst wyświetlany w polu tekstowym, aby 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";
}

Uzyskiwanie dostępu do regionów formularzy, które pojawiają się w określone okno Eksploratora programu Outlook

Dostęp do wszystkich regionów formularzy, które pojawiają się w konkretnych Explorer Outlook, call FormRegions właściwość Globals klasy i w Explorer obiekt, który reprezentuje Eksploratora.

Poniższy przykład pobiera zbiór regionów formularzy, które są wyświetlane w Eksploratorze, który aktualnie ma fokus.W tym przykładzie następnie uzyskuje dostęp do regionu formularza w kolekcji o nazwie formRegion1 i ustawia tekst wyświetlany w polu tekstowym, aby 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";
}

Dostęp do wszystkich regionów formularzy

Aby uzyskać dostęp do wszystkich regionów formularzy, które pojawiają się wszystkie eksploratorów i wszyscy inspektorzy, wywołanie FormRegions właściwość Globals klasy.

Poniższy przykład pobiera zbiór regionów formularzy, które pojawiają się wszystkie eksploratorów i wszyscy inspektorzy.W tym przykładzie następnie uzyskuje dostęp do regionu formularza o nazwie formRegion1 i ustawia tekst wyświetlany w polu tekstowym, aby 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";
        }
    }

}

Uzyskiwanie dostępu do formantów na Region formularza

Do kontroli dostępu do regionu formularza przy użyciu Globals klasy, należy formanty dostępne dla kodu poza plikiem kod regionu formularza.

Regiony formularzy zaprojektowane w Projektancie Region formularza

Język C# zmienić modyfikator każdego formantu, który chcesz uzyskać dostęp.Aby to zrobić, zaznacz każdy formant w Projektancie region formularza i zmienić modyfikatorów właściwość wewnętrzny lub publiczny w Właściwości okna.Na przykład, jeśli zmienisz modyfikatora właściwość textBox1 do wewnętrznego, można uzyskać dostęp textBox1 wpisując Globals.FormRegions.FormRegion1.textBox1.

Dla języka Visual Basic nie trzeba zmieniać modyfikatora.

Importowane regionów formularzy

Podczas importowania region formularza, który został zaprojektowany w programie Outlook, modyfikator dostępu do każdego formantu na region formularza staje się prywatne.Ponieważ projektant region formularza nie można używać do modyfikowania region formularza przywożonych, nie istnieje sposób zmienić modyfikator kontroli w Właściwości okna.

Aby włączyć dostęp do formantu z zewnątrz pliku kod regionu formularza, należy utworzyć właściwość w pliku kod regionu formularza do powrotu do tego formantu.

Aby uzyskać więcej informacji na temat tworzenia właściwości w C#, zobacz Porady: deklarowanie i użycie właściwości odczytu/zapisu (Przewodnik programowania w języku C#).

Aby uzyskać więcej informacji na temat tworzenia właściwości w języku Visual Basic, zobacz How to: Add Fields and Properties to a Class.

Zobacz też

Zadania

Wskazówki: projektowanie regionów formularzy programu Outlook

Porady: dodawanie regionu formularza do projektu dodatków w programie Outlook

Wskazówki: importowanie regionów formularzy zaprojektowanych w programie Outlook

Porady: ochrona programu Outlook przed wyświetlaniem regionów formularzy

Koncepcje

Wytyczne dotyczące tworzenia regionów formularzy w programie Outlook

Niestandardowe akcje w regionach formularzy programu Outlook

Kojarzenie regionu formularza z klasą wiadomości programu Outlook

Uzyskiwanie dostępu do wstążki w czasie wykonywania

Inne zasoby

Tworzenie regionów formularzy w programie Outlook