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
S_OK	El método se ha llevado a cabo de forma correcta.
XPS_E_NO_CUSTOM_OBJECTS	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

Consulte también

IXpsOMDictionary

IXpsOMShareable

XML Paper Specification

Errores del documento XPS