Método IXpsOMPage::GetDictionary (xpsobjectmodel.h)
Obtiene un puntero a la interfaz IXpsOMDictionary resuelta asociada a esta página.
Sintaxis
HRESULT GetDictionary(
[out, retval] IXpsOMDictionary **resourceDictionary
);
Parámetros
[out, retval] resourceDictionary
Puntero a la interfaz IXpsOMDictionary resuelta asociada a esta página.
El valor que se devuelve en este parámetro depende del método al que se ha llamado más recientemente para establecer el diccionario.
| Método más reciente llamado | Objeto que se devuelve en resourceDictionary |
|---|---|
| Recurso de diccionario local establecido por SetDictionaryLocal. | |
| Diccionario compartido del recurso de diccionario establecido por SetDictionaryResource. | |
| Todavía no se ha llamado a SetDictionaryLocal ni SetDictionaryResource . | Puntero NULL. |
Valor devuelto
El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener información sobre los valores devueltos de la API de documentos XPS que no aparecen en esta tabla, vea Errores del documento XPS.
| Código devuelto | Descripción |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
resourceDictionary es NULL. |
|
El nombre de la clave de búsqueda establecido por SetStrokeBrushLookup hace referencia a un objeto que no es un pincel. |
|
No se encontró ningún objeto con un nombre de clave que coincida con el valor de búsqueda.
No se encontró ningún objeto con un nombre de clave que coincida con el valor pasado en la búsqueda. |
Comentarios
Tanto si el diccionario es local como si se encuentra dentro de un recurso de diccionario remoto, este método devuelve un puntero de interfaz IXpsOMDictionary . GetOwner determina si el diccionario es remoto.
Si una página contiene un diccionario remoto, GetDictionary deserializará el diccionario. Si la página contiene un diccionario remoto que no es válido, GetDictionary podría devolver un código de error de deserialización.
Después de cargar y analizar el recurso en el OM XPS, este método podría devolver un error que se aplica a otro recurso. Esto ocurre porque todas las relaciones se analizan cuando se carga un recurso.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | xpsobjectmodel.h |