Condividi tramite


Metodo IXpsOMPage::GetDictionary (xpsobjectmodel.h)

Ottiene un puntatore all'interfaccia IXpsOMDictionary risolta associata a questa pagina.

Sintassi

HRESULT GetDictionary(
  [out, retval] IXpsOMDictionary **resourceDictionary
);

Parametri

[out, retval] resourceDictionary

Puntatore all'interfaccia IXpsOMDictionary risolta associata a questa pagina.

Il valore restituito in questo parametro dipende da quale metodo è stato chiamato più di recente per impostare il dizionario.

Metodo più recente chiamato Oggetto restituito in resourceDictionary

SetDictionaryLocal

Risorsa del dizionario locale impostata da SetDictionaryLocal.

SetDictionaryResource

Dizionario condiviso nella risorsa dizionario impostata da SetDictionaryResource.
Non è ancora stato chiamato SetDictionaryLocalSetDictionaryResource . Puntatore NULL.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a quelli della tabella che segue. Per informazioni sui valori restituiti dall'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

Codice restituito Descrizione
S_OK
Il metodo è riuscito.
E_POINTER
resourceDictionary è NULL.
XPS_E_LOOKUP_INVALID_TYPE
Il nome della chiave di ricerca impostato da SetStrokeBrushLookup fa riferimento a un oggetto che non è un pennello.
XPS_E_LOOKUP_NOT_FOUND
Non è possibile trovare alcun oggetto con un nome di chiave corrispondente al valore di ricerca.

Non è possibile trovare alcun oggetto con un nome di chiave corrispondente al valore passato nella ricerca.

Commenti

Se il dizionario è locale o è contenuto all'interno di una risorsa del dizionario remoto, questo metodo restituisce un puntatore dell'interfaccia IXpsOMDictionary . GetOwner determina se il dizionario è remoto.

Se una pagina contiene un dizionario remoto, GetDictionary deserializzerà il dizionario. Se la pagina contiene un dizionario remoto non valido, GetDictionary potrebbe restituire un codice di errore di deserializzazione.

Dopo il caricamento e l'analisi della risorsa nell'OM XPS, questo metodo potrebbe restituire un errore che si applica a un'altra risorsa. Ciò si verifica perché tutte le relazioni vengono analizzate quando viene caricata una risorsa.

Requisiti

Requisito Valore
Client minimo supportato Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione xpsobjectmodel.h

Vedi anche

IXpsOMDictionary

IXpsOMPage

XML Paper Specification

Errori del documento XPS