Metodo IXpsOMDictionary::SetAt (xpsobjectmodel.h)
Sostituisce la voce in una posizione specificata nel dizionario.
Sintassi
HRESULT SetAt(
[in] UINT32 index,
[in] LPCWSTR key,
[in] IXpsOMShareable *entry
);
Parametri
[in] index
Indice in base zero nel dizionario in cui deve essere sostituita una voce.
[in] key
Chiave da utilizzare per la nuova voce.
La stringa a cui fa riferimento la chiave deve essere univoca nel dizionario.
[in] entry
Puntatore all'interfaccia IXpsOMShareable che sostituirà il contenuto corrente nella posizione specificata dall'indice.
Un dizionario non può contenere puntatori di interfaccia duplicati. Questo parametro deve contenere un puntatore all'interfaccia che non è già presente nel dizionario.
Valore restituito
Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non solo, quelli nella tabella che segue. Per informazioni sui valori restituiti dell'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
la voce non punta a un'implementazione dell'interfaccia riconosciuta. L'implementazione personalizzata delle interfacce API documento XPS non è supportata. |
Commenti
Nel percorso specificato dall'indice, questo metodo rilascia l'interfaccia IXpsOMShareable a cui fa riferimento il puntatore esistente, quindi lo sostituisce con il puntatore di interfaccia passato nella voce e lo assegna alla chiave passata.
I puntatori di interfaccia archiviati in un dizionario puntano in genere alle interfacce, ad esempio IXpsOMBrush e IXpsOMVisual, derivate dall'interfaccia IXpsOMShareable . Per determinare il tipo di interfaccia, chiamare il metodo GetType .
La figura seguente illustra come il dizionario viene modificato dal metodo SetAt .
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 |