Acessar uma região de formulário em tempo de execução
Applies to |
|---|
|
As informações contidas neste tópico se aplicam somente aos tipos e versões de projetos do Microsoft Office. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto. Project type
Versão de Microsoft Office
|
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