Metodo IXpsOMDictionary::Append (xpsobjectmodel.h)

Articolo
03/15/2023

Aggiunge un'interfaccia IXpsOMShareable insieme alla relativa chiave alla fine del dizionario.

Sintassi

HRESULT Append(
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

Parametri

[in] key

Chiave da usare per questa voce.

La stringa a cui fa riferimento per chiave deve essere univoca nel dizionario.

[in] entry

Puntatore all'interfaccia IXpsOMShareable che deve essere aggiunta al dizionario.

Un dizionario non può contenere puntatori di interfaccia duplicati. Questo parametro deve contenere un puntatore dell'interfaccia non già presente nel dizionario.

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.
XPS_E_NO_CUSTOM_OBJECTS	la voce non punta a un'implementazione dell'interfaccia riconosciuta. L'implementazione personalizzata delle interfacce API documento XPS non è supportata.

Commenti

I puntatori di interfaccia archiviati in un dizionario puntano in genere a interfacce, ad esempio IXpsOMBrush e IXpsOMVisual, derivate dall'interfaccia IXpsOMShareable. Per determinare il tipo di interfaccia, chiamare il metodo IXpsOMShareable::GetType .

La figura seguente illustra il modo in cui il dizionario viene modificato dal metodo Append .

Figura che mostra come Accodare aggiunge una voce al dizionario

Requisiti


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