Usar um suplemento para especificar ícones para uma região de formulário

Use um suplemento para especificar os ícones personalizados que você gostaria de usar para ajudar a identificar o estado de um item no explorador, inspetor e faixa de opções. Por meio do arquivo XML de manifesto da região do formulário que você usa para registrar a região do formulário, você pode especificar o suplemento que estende a região do formulário e as circunstâncias para as quais o ícone personalizado é destinado. Quando as cirsumstances especificadas ocorrerem, o Outlook obterá o ícone apropriado do suplemento.

Para usar um suplemento para especificar um ícone em uma área de formulário

1. Implemente a interface FormRegionStartup .

   Todos os suplementos que estendem regiões de formulário devem implementar a interface FormRegionStartup . O Outlook chama essa interface para obter dados de repositório de layout de uma área de formulário. Para obter mais informações sobre suplementos para regiões de formulário, consulte Estendendo uma região de formulário com um suplemento.

   Em particular, para especificar ícones personalizados, o suplemento implementa os métodos GetFormRegionManifest e GetFormRegionIcon da interface FormRegionStartup , especificando um arquivo XML de manifesto da região do formulário e as circunstâncias em que o Outlook deve exibir ícones personalizados no explorador, inspetor ou faixa de opções. Por exemplo, você pode criar uma região de formulário para exibir um tipo de tarefa que ocorre somente no domicílio e essas tarefas domésticas pertencem a uma classe de mensagem, IPM. Task.Household, que é derivado do IPM. Tarefa. Você pode estender a região do formulário com um suplemento que especifica no método GetFormRegionIcon um ícone recorrente especial que o Outlook deve exibir ao lado de tarefas domésticas recorrentes no explorador.

2. No arquivo XML do manifesto da região do formulário, especifique no elemento ícones , o valor addin para cada um dos elementos filho em que você gostaria de usar um ícone personalizado.

   Quando o Outlook exibe itens no explorador ou inspetor, o Outlook procuraria no cache os manifestos da região do formulário associados a itens de classes de mensagem específicas. Quando um elemento filho do elemento icons tem o valor addin, o Outlook chama GetFormRegionIcon para obter o ícone correspondente e o exibe de acordo com os itens dessa classe de mensagem.

   Como uma extensão do último exemplo, no arquivo XML do manifesto da região do formulário para a região do formulário associada ao IPM. Task.Household, você pode especificar no elemento ícones , o valor addin do elemento filho recorrente . Quando o Outlook exibe todas as tarefas no gerenciador, ele pode examinar o manifesto de área de formulário em cache para procurar itens que pertencem a IPM.Task.Household. Quando o Outlook perceber que o elemento recorrente tem o valor addin, o Outlook chamará GetFormRegionIcon para obter o ícone para tarefas domésticas recorrentes e exibirá no explorador o ícone recorrente especial adjacente a esse tipo de tarefa. Para obter mais informações sobre elementos filhos do elemento icons, consulte Como especificar a exibição de ícones em uma área de formulário.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.