Método IXpsOMDictionary::SetAt (xpsobjectmodel.h)
Reemplaza la entrada en una ubicación especificada del diccionario.
Sintaxis
HRESULT SetAt(
[in] UINT32 index,
[in] LPCWSTR key,
[in] IXpsOMShareable *entry
);
Parámetros
[in] index
Índice de base cero del diccionario en el que se va a reemplazar una entrada.
[in] key
Clave que se va a usar para la nueva entrada.
La cadena a la que hace referencia la clave debe ser única en el diccionario.
[in] entry
Puntero de interfaz IXpsOMShareable que reemplazará el contenido actual en la ubicación especificada por el índice.
Un diccionario no puede contener punteros de interfaz duplicados. Este parámetro debe contener un puntero de interfaz que aún no está en el diccionario.
Valor devuelto
El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener información sobre los valores devueltos de la API de documentos XPS que no aparecen en esta tabla, vea Errores del documento XPS.
Código devuelto | Descripción |
---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
entry no apunta a una implementación de interfaz reconocida. No se admite la implementación personalizada de interfaces de LA API de documentos XPS. |
Comentarios
En la ubicación especificada por el índice, este método libera la interfaz IXpsOMShareable a la que hace referencia el puntero existente y, a continuación, la reemplaza por el puntero de interfaz que se pasa en la entrada y le asigna la clave que se pasa en la clave.
Los punteros de interfaz almacenados en un diccionario suelen apuntar a interfaces, como IXpsOMBrush e IXpsOMVisual, que se derivan de la interfaz IXpsOMShareable . Para determinar el tipo de interfaz, llame al método GetType .
En la ilustración siguiente se muestra cómo cambia el diccionario el método SetAt .
Requisitos
Cliente mínimo compatible | Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
Servidor mínimo compatible | Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP] |
Plataforma de destino | Windows |
Encabezado | xpsobjectmodel.h |