Método IXpsOMDictionary::InsertAt (xpsobjectmodel.h)

Inserta una interfaz IXpsOMShareable en una ubicación especificada del diccionario y establece la clave para identificar la interfaz.

Sintaxis

HRESULT InsertAt(
  [in] UINT32          index,
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

Parámetros

[in] index

Índice de base cero del diccionario donde se va a insertar la interfaz IXpsOMShareable .

[in] key

Clave que se va a usar para identificar la interfaz IXpsOMShareable en el diccionario.

La cadena a la que hace referencia la clave debe ser única en el diccionario.

[in] entry

Puntero de interfaz IXpsOMShareable que se va a insertar en la ubicación especificada por í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

Los punteros de interfaz almacenados en el diccionario suelen ser punteros a interfaces, como IXpsOMBrush e IXpsOMVisual, que se derivan de la interfaz IXpsOMShareable . Para determinar el tipo de interfaz, llame al método IXpsOMShareable::GetType .

En la ubicación especificada por índice, este método inserta el puntero de interfaz IXpsOMShareable y establece la clave; el puntero de interfaz y la clave se pasan en el valor y la clave, respectivamente. Antes de insertar el valor y la clave , el puntero de interfaz y la clave en esta y todas las ubicaciones posteriores se mueven por un índice.

En la ilustración siguiente se muestra cómo cambia el diccionario el método InsertAt .

Requisitos

Requisito	Value
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