Metodo IXpsOMDictionary::InsertAt (xpsobjectmodel.h)
Inserisce un'interfaccia IXpsOMShareable in una posizione specificata nel dizionario e imposta la chiave per identificare l'interfaccia.
Sintassi
HRESULT InsertAt(
[in] UINT32 index,
[in] LPCWSTR key,
[in] IXpsOMShareable *entry
);
Parametri
[in] index
Indice in base zero nel dizionario in cui deve essere inserita l'interfaccia IXpsOMShareable .
[in] key
Chiave da usare per identificare l'interfaccia IXpsOMShareable nel dizionario.
La stringa a cui fa riferimento per chiave deve essere univoca nel dizionario.
[in] entry
Puntatore dell'interfaccia IXpsOMShareable da inserire nella posizione specificata dall'indice.
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 |
|---|---|
|
Il metodo è riuscito. |
|
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 nel dizionario in genere saranno puntatori a interfacce, ad esempio IXpsOMBrush e IXpsOMVisual, derivate dall'interfaccia IXpsOMShareable. Per determinare il tipo di interfaccia, chiamare il metodo IXpsOMShareable::GetType .
Nella posizione specificata dall'indice, questo metodo inserisce il puntatore dell'interfaccia IXpsOMShareable e imposta la chiave; il puntatore e la chiave dell'interfaccia vengono passati rispettivamente in valore e chiave. Prima di inserire valore e chiave , il puntatore dell'interfaccia e la chiave in questo modo e tutte le posizioni successive vengono spostate da un indice.
La figura seguente illustra il modo in cui il dizionario viene modificato dal metodo InsertAt .
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 |