Método FormRegionStartup.GetFormRegionIcon (Outlook)
Obtiene una imagen de icono que se mostrará para un tipo particular de icono para el área del formulario.
Sintaxis
expresión. GetFormRegionIcon( _FormRegionName_ , _LCID_ , _Icon_ )
Expresión Variable que representa un objeto "FormRegionStartup".
Parameters
| Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
|---|---|---|---|
| FormRegionName | Obligatorio | String | El nombre del área del formulario que se usa cuando se registra dicha área en el Registro de Windows. |
| LCID | Obligatorio | Long | El identificador de configuración regional que identifica el idioma que Outlook está usando actualmente. Este valor se usa para obtener las cadenas de localización que corresponden a este idioma para el área del formulario. |
| Icon | Obligatorio | OlFormRegionIcon | Una constante que identifica el tipo de icono. |
Valor devuelto
Variant que es una matriz de bytes que representa los bytes originales del archivo de imagen o un objeto IPictureDisp.
Comentarios
Este método está destinado a su implementación por parte de un complemento y para que Outlook lo llame. Como parte de la interfaz FormRegionStartup, este método y el método GetFormRegionManifest brindan un mecanismo mediante el cual un complemento puede registrar un área del formulario y proporcionar un manifiesto XLM a Outlook, como también, los iconos para el área del formulario.
Si desea proporcionar iconos para un área de formulario con un complemento, especifique el ProgID del complemento al registrar el área de formulario en el registro de Windows. Para obtener más información acerca de cómo registrar un área de formulario, vea Especificar áreas de formulario en el registro de Windows. El complemento debe implementar la GetFormRegionManifest y los métodos de GetFormRegionIcon de la interfaz FormRegionStartup.
En el manifiesto XML para el área de formulario, en el elemento icons, especifique el valor addin para cada uno de los elementos secundarios que se desea utilizar un icono personalizado. Implemente GetFormRegionIcon de modo que cuando Outlook pase ese tipo de icono como argumento para Icon , GetFormRegionIcon devuelve la imagen del icono personalizado. Si quiere que Outlook muestre el icono predeterminado, implemente GetFormRegionIcon de modo que devuelva null (Nothing en Visual Basic) para ese tipo de icono. GetFormRegionIcon también debe devolver null (Nothing en Visual Basic) cuando Icon es olFormRegionIconDefault.
Cuando se inicia Outlook, lee la lista de áreas de formulario en el registro de Windows y almacena en caché los datos asociados con las áreas de formulario. Si un área de formulario se ha registrado con un ProgID, Outlook recurrirá llamando a su implementación de GetFormRegionIcon para cualquier icono en el manifiesto XML que tiene addin como el valor de un elemento secundario del elemento de iconos para el complemento correspondiente. Tenga en cuenta que si no especifica ningún ProgID en el Registro de Windows, Outlook no llamará a los métodos GetFormRegionManifest y GetFormRegionIcon .
Consulte también
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.