Acessar uma região de formulário em tempo de execução

Use o Globals classe para regiões de formulário de acesso de qualquer lugar dentro de seu projeto no Outlook. For more information about the Globals class, see Acesso global a objetos em projetos do Office.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Outlook 2007 e Outlook 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Acessando as regiões de formulário que aparecem em uma janela de Inspetor de propriedades específicas do Outlook

Para acessar todas as regiões de formulário que aparecem em um Inspetor de propriedades específicas do Outlook, chamar o FormRegions propriedade da Globals de classe e passar um Inspector objeto que representa o Inspetor de propriedades.

O exemplo a seguir obtém a coleção de regiões de formulário que aparecem no Inspetor de propriedades que atualmente tem foco. Este exemplo, em seguida, acessa uma região de formulário na coleção denominada formRegion1 e define o texto que aparece na caixa de texto para 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";
}

Acessando as regiões de formulário que aparecem em uma janela do Explorer Outlook específica

Para acessar todas as regiões de formulário que aparecem em um navegador específico do Outlook, chamar o FormRegions propriedade da Globals de classe e passar um Explorer objeto que representa o Explorer.

O exemplo a seguir obtém a coleção de regiões de formulário que aparecem no Explorer que atualmente tem foco. Este exemplo, em seguida, acessa uma região de formulário na coleção denominada formRegion1 e define o texto que aparece na caixa de texto para 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";
}

Acessar todas as regiões de formulário

Para acessar todas as regiões de formulário que aparecem em todos os Explorers e todos os inspetores, chamar o FormRegions propriedade da Globals classe.

O exemplo a seguir obtém a coleção de regiões de formulário que aparecem em todos os Explorers e todos os inspetores. Este exemplo, em seguida, acessa uma região de formulário chamada formRegion1 e define o texto que aparece na caixa de texto para 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";
        }
    }

}

Acessando controles em uma região de formulário

Para controles de acesso em uma região de formulário usando o Globals classe, você deve fazer os controles podem ser acessados por código fora do arquivo de código do formulário de região.

Regiões de formulário criados no Designer de região de formulário

C# altere o modificador de cada controle que você deseja acessar. Para fazer isso, selecione cada controle no designer de região de formulário e alterar o modificadores propriedade interna ou pública na Propriedades janela. Por exemplo, se você alterar o modificador propriedade de textBox1 interno, você pode acessar textBox1 digitando Globals.FormRegions.FormRegion1.textBox1.

Para Visual Basic, você não precisará alterar o modificador.

Regiões de formulário importado

Quando você importa uma região de formulário foi criada no Outlook, o modificador de acesso de cada controle na região do formulário se torna particular. Porque você não pode usar o designer de região de formulário para modificar uma região de formulário importado, não há nenhuma maneira de alterar o modificador de um controle na Propriedades janela.

Para habilitar o acesso a um controle de fora do arquivo de código de região de formulário, crie uma propriedade no arquivo de código de região de formulário para retornar o controle.

Para obter mais informações sobre como criar propriedades de C#, consulte How to: Declarar e usar de leitura/gravação Propriedades (guia de programação C#).

Para obter mais informações sobre como criar propriedades de Visual Basic, consulte How to: Add Fields and Properties to a Class.

Consulte também

Tarefas

Demonstra Passo a passo: A criação de uma região de formulário do Outlook

Como: Adicionar uma região de formulário a um projeto de suplemento do Outlook

Demonstra Passo a passo: A importação de uma região de formulário que é criada no Outlook

Como: Impedir a exibição de uma região de formulário do Outlook

Como: Acessar o Item do Outlook exibe a região de formulário

Conceitos

Diretrizes para criação de regiões de formulário do Outlook

Ações personalizadas nas regiões de formulário do Outlook

Associar uma região de formulário uma classe de mensagem do Outlook

Acessando a faixa de opções em tempo de execução

Outros recursos

Criação de regiões de formulário do Outlook