Uso de un complemento para especificar iconos para un área de formulario

Use un complemento para especificar los iconos personalizados que desea usar para ayudar a identificar el estado de un elemento en el explorador, el inspector y la cinta de opciones. Mediante el archivo de manifiesto XML del área de formulario que usa para registrar el área del formulario, puede especificar el complemento que extiende el área del formulario y las circunstancias para las cuales se quiere el icono personalizado. Cuando se producen las circunstancias especificadas, Outlook obtiene el icono apropiado desde el complemento.

Usar un complemento para especificar un icono para un área del formulario

1. Implemente la interfaz FormRegionStartup .

   Todos los complementos que extienden las regiones de formulario deben implementar la interfaz FormRegionStartup . Outlook llama a la interfaz para obtener los datos de almacenamiento del diseño para un área del formulario. Para obtener más información sobre los complementos para regiones de formulario, consulte Extensión de un área de formulario con un complemento.

   En concreto, para especificar iconos personalizados, el complemento implementa los métodos GetFormRegionManifest y GetFormRegionIcon de la interfaz FormRegionStartup , especificando un archivo XML de manifiesto de área de formulario y las circunstancias en las que Outlook debe mostrar iconos personalizados en el explorador, el inspector o la cinta de opciones. Por ejemplo, puede crear un área del formulario para mostrar un tipo de tarea que se produce solamente en el ámbito doméstico, y estas tareas domésticas pertenecen a una clase de mensaje, IPM.Task.Household, que se deriva de IPM.Task. Puede extender el área del formulario con un complemento que especifique en el método GetFormRegionIcon un icono periódico especial que Outlook debe mostrar junto a tareas domésticas periódicas en el explorador.

2. En el archivo XML de manifiesto del área de formulario, especifique en el elemento icons el valor addin de cada uno de los elementos secundarios en los que desea usar un icono personalizado.

   Cuando Outlook muestra elementos en el explorador o el inspector, Outlook buscaría en la memoria caché los manifiestos del área de formulario que están asociados a elementos de clases de mensajes específicas. Donde un elemento secundario del elemento icons tiene el valor addin, Outlook llama a GetFormRegionIcon para obtener el icono correspondiente y lo muestra en consecuencia para los elementos de esa clase de mensaje.

   Como extensión del último ejemplo, en el archivo XML de manifiesto del área de formulario para el área de formulario asociada a IPM. Task.Household, puede especificar en el elemento icons el valor addin del elemento secundario periódico . Cuando Outlook muestra todas las tareas en el explorador, buscará el manifiesto del área del formulario en caché para los elementos que pertenecen a IPM.Task.Household. Cuando Outlook se da cuenta de que el elemento periódico tiene el valor addin, Outlook llamará a GetFormRegionIcon para obtener el icono para las tareas domésticas recurrentes y mostrará en el explorador el icono recurrente especial adyacente a este tipo de tarea. Para obtener más información sobre los elementos secundarios del elemento icons, consulte el tema sobre los procedimientos para especificar iconos para mostrar en un área del formulario.

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.