Método IXpsOMPage::GetDictionary (xpsobjectmodel.h)
Obtém um ponteiro para a interface IXpsOMDictionary resolvida associada a esta página.
Sintaxe
HRESULT GetDictionary(
[out, retval] IXpsOMDictionary **resourceDictionary
);
Parâmetros
[out, retval] resourceDictionary
Um ponteiro para a interface IXpsOMDictionary resolvida associada a esta página.
O valor retornado nesse parâmetro depende de qual método foi chamado mais recentemente para definir o dicionário.
| Método mais recente chamado | Objeto retornado em resourceDictionary |
|---|---|
| O recurso de dicionário local definido por SetDictionaryLocal. | |
| O dicionário compartilhado no recurso de dicionário definido por SetDictionaryResource. | |
| Nem SetDictionaryLocal nem SetDictionaryResource ainda foram chamados. | Ponteiro NULL . |
Retornar valor
O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam, aqueles na tabela a seguir. Para obter informações sobre valores retornados da API de documento XPS que não estão listados nesta tabela, consulte Erros de documento XPS.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
resourceDictionary é NULL. |
|
O nome da chave de pesquisa definido por SetStrokeBrushLookup faz referência a um objeto que não é um pincel. |
|
Nenhum objeto pôde ser encontrado com um nome de chave que corresponda ao valor de pesquisa.
Nenhum objeto pôde ser encontrado com um nome de chave que corresponda ao valor passado na pesquisa. |
Comentários
Se o dicionário é local ou está contido em um recurso de dicionário remoto, esse método retorna um ponteiro de interface IXpsOMDictionary . GetOwner determina se o dicionário é remoto.
Se uma página contiver um dicionário remoto, GetDictionary desserializará o dicionário. Se a página contiver um dicionário remoto que não seja válido, GetDictionary poderá retornar um código de erro de desserialização.
Depois de carregar e analisar o recurso no OM XPS, esse método pode retornar um erro que se aplica a outro recurso. Isso ocorre porque todas as relações são analisadas quando um recurso é carregado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | xpsobjectmodel.h |