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

Se aplica a
As informações contidas em este tópico se aplicam somente aos seguintes tipos de projeto e versões do Microsoft Office.Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto. Tipo de Projeto projetos de nível de aplicativo Versão do Microsoft Office Outlook 2010

Use a classe de Globals para acessar dentro regiões do formulário em qualquer lugar do projeto do Outlook.Para obter mais informações sobre a classe Globals, consulte 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 2013 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 do formulário que aparecem em uma janela específica do Outlook de inspector

Para acessar todas as regiões do formulário que aparecem em um inspector específico do Outlook, chamam a propriedade de FormRegions da classe de Globals e passe em um objeto de Inspector que representa inspector.

O exemplo a seguir obtém a coleção de regiões do formulário que aparecem em inspector que atualmente tem o foco.Este exemplo então acessa uma região de formulário na coleção chamada formRegion1 e define o texto que aparece em uma caixa de texto a 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 do formulário que aparecem em uma janela específica do Outlook Explorer

Para acessar todas as regiões do formulário que aparecem no Outlook específico Explorer, chamam a propriedade de FormRegions da classe de Globals e passe em um objeto de Explorer que representa Explorer.

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

Acessando todas as regiões do formulário

Para acessar todas as regiões do formulário que aparecem em todos os exploradores e todos os inspectores, chame a propriedade de FormRegions da classe de Globals .

O exemplo a seguir obtém a coleção de regiões do formulário que aparecem em todos os exploradores e todos os inspectores.Este exemplo então acessa uma região de chamada formRegion1 formulário e defina o texto que aparece em uma caixa de texto a 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 área do formulário

Os controles de acesso em uma área do formulário usando a classe de Globals , você deve fazer os controles acessíveis para o código fora do arquivo de código de área do formulário.

Regiões do formulário criadas no designer da região de formulário

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

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

Regiões importados do formulário

Quando você importar uma região de formulário que foi criado no Outlook, o modificador de acesso de cada controle para a área do formulário fica particular.Porque você não pode usar o designer da região do formulário para alterar uma região importado do formulário, não há nenhuma maneira para alterar o modificador de um controle na janela de Propriedades .

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

Para obter mais informações sobre como criar propriedades em C#, consulte Como: declarar e usar propriedades de leitura/gravação (guia de programação do C#).

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

Consulte também

Tarefas

Passo a passo: Criando uma região de formulário do Outlook

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

Passo a passo: 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

Conceitos

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

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

A associação de uma região de formulário com 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