Método FormRegionStartup.GetFormRegionManifest (Outlook)
Obtiene el manifiesto XML para un área del formulario.
Sintaxis
expresión. GetFormRegionManifest( _FormRegionName_ , _LCID_ )
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. |
Valor devuelto
Variant que representa el manifiesto XML para un área de formulario. Esta cadena XML incluye las características del área de formulario, como el nombre para mostrar (según lo especificado por el elemento de título), cualquier archivo asociado de diseño o complemento, las acciones de usuario compatibles y cualquier cadena de localización. El XML debe cumplir el esquema XML de área de formulario. Para obtener más información sobre el esquema XML de área de formulario, vea la referencia del esquema XML de Microsoft Outlook 2010 en MSDN Library.
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 GetFormRegionIcon 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 que un complemento para proporcionar el manifiesto XML para un área de formulario, especifique la ProgID del complemento al registrar el área de formulario en el registro de Windows. Para obtener más información sobre el registro de un área del formulario, consulte el tema sobre cómo especificar áreas del formulario en el Registro de Windows. El complemento debe implementar el método GetFormRegionManifest de la interfaz FormRegionStartup. Tenga en cuenta que si no especifica ningún ProgID en el Registro de Windows, Outlook no llamará a este método.
Confiar en un complemento para proporcionar que el manifiesto XML para un área de formulario también significa que se permite el complemento proporcionar los iconos del área de formulario. El complemento también debe implementar la GetFormRegionIcon de la interfaz FormRegionStartup. Outlook llamará a GetFormRegionIcon para obtener el complemento especificados iconos para el área de formulario. Si desea obtener más información sobre el modo de usar un complemento para especificar iconos, consulte el tema sobre los procedimientos para usar un complemento para especificar iconos para un área del formulario.
Cuando se inicia Outlook, lee la lista de áreas de formulario en el registro de Windows y almacena en caché los datos. En función de estos datos, si Outlook se advierte que un complemento se ha especificado para proporcionar el manifiesto XML para un área de formulario, Outlook utilizará la ProgID proporcionada en los datos almacenados en caché y la llamada al método GetFormRegionManifest implementado por este complemento que se va a obtener el XML que se debe mostrar el área de formulario. Si el manifiesto XML no es válido y no se ajusta al esquema XML de área de formulario, Outlook no podrán cargar el área de formulario. Además, si no especifica ningún ProgID en el Registro de Windows, Outlook no llamará a los métodos GetFormRegionManifest y GetFormRegionIcon .
Outlook ignora los siguientes elementos cuando el complemento proporciona el manifiesto XML:
name : Outlook omite el valor especificado para este elemento y usará el nombre especificado para el área de formulario en el Registro.
layoutFile : Outlook omite este elemento porque un complemento extiende este área de formulario.
addin : Outlook usa el valor precedido por un signo igual (=) en el Registro como progID del complemento.
atributo file de stringOverride: Outlook omite cualquier archivo de localización secundario especificado por el elemento stringOverride. El complemento puede implementar GetFormRegionManifest para devolver el manifiesto XML insertado para la localización de cadenas para el LCID especificado o administrar la localización de cadenas de otra manera, por ejemplo, mediante la localización de .NET Framework y, a continuación, devolver el manifiesto XML adecuado para el LCID especificado.
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.