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

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de aplicativo Versão do Microsoft Office Outlook 2007 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

Projetos de nível de aplicativo

Versão do Microsoft Office

Outlook 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Você pode Gravar código para mostrar, ocultar, ou modificar controles em uma região de formulário e permitir que os usuários executar o código de Outro áreas em seu projeto, usando a classe Globals.

For more information about the Globals class, see Global Acessar a objetos no Visual Studio Tools para projetos do Office.

Usar a classe Globals a regiões de formulário de Acessar que Aparecerr em Inspectors e Explorers de qualquer lugar dentro do projeto.Um Inspector é uma janela aberta no Outlook quando os usuários executar determinadas tarefas, como a criação de mensagens de email.Um Explorer é uma janela que exibe o conteúdo de uma pasta que contém itens como mensagens de email, tarefas ou compromissos.

Acessar áreas de formulário que Aparecerr em uma janela específicos de inspetor do Outlook

Para acessar todas as regiões de formulário que Aparecerr em um inspetor do Outlook específico, chame a propriedade FormRegions da classe Globals e passar em um objeto de Inspector que representa o Inspector.

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

Acessar áreas de formulário que Aparecerr em uma janela de Explorer Outlook específicos

Para acessar todas as regiões de formulário que Aparecerr em um Explorer específico do Outlook, chame a propriedade FormRegions da classe Globals e passar em um objeto de Explorer 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 chamada formRegion1 e define o texto que aparece em uma 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";
}

Acesso a Tudo as regiões de formulário

Para acessar todas as regiões de formulário que Aparecerr em todos os Explorers e todos os Inspectors, chame a propriedade FormRegions da classe Globals.

O exemplo a seguir obtém a coleção de regiões de formulário que Aparecerr em Tudo Explorers e Tudo Inspectors.Este exemplo, em seguida, acessa uma região de formulário chamada formRegion1 e define o texto que aparece em uma 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 acessar controles em uma região de formulário usando a classe de Globals, você deve disponibilizar os controles a código fora do arquivo de código de região de formulário.

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

Para o C#, Alterar o modificador de cada Controlarar que você deseja acessar.Para fazer isso, Selecionar cada Controlarar no designer de região de formulário e alterar Modificadores propriedade para interna ou Público em janelaProperties.Por exemplo, se você alterar o modificador de propriedade textBox1 para interna, você pode acessar textBox1 digitando Globals.FormRegions.FormRegion1.textBox1.

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

Regiões de formulário importado

Quando você Importara uma região de formulário que foi criada no Outlook, o modificador de Acessar de cada Controlarar na região do formulário se torna particular.Como você não pode usar o designer de região do formulário para modificar uma região de formulário importado, não há nenhuma maneira de alterar o modificador de um Controlarar na janela Properties.

Para habilitar o Acessar a um Controlarar de fora o arquivo de código de região de formulário, criar uma propriedade no arquivo de código de região de formulário para retornar a esse Controlarar.

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

Para obter mais informações sobre como criar propriedades no Visual Basic, consulte Como: Adicionar campos e propriedades a uma classe.