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