Метод IXpsOMDictionary::InsertAt (xpsobjectmodel.h)
Вставляет интерфейс IXpsOMShareable в указанное расположение в словаре и задает ключ для идентификации интерфейса.
Синтаксис
HRESULT InsertAt(
[in] UINT32 index,
[in] LPCWSTR key,
[in] IXpsOMShareable *entry
);
Параметры
[in] index
Отсчитываемый от нуля индекс в словаре, в который должен быть вставлен интерфейс IXpsOMShareable .
[in] key
Ключ, используемый для идентификации интерфейса IXpsOMShareable в словаре.
Строка, на которую ссылается ключ, должна быть уникальной в словаре.
[in] entry
Указатель интерфейса IXpsOMShareable для вставки в расположение, указанное индексом.
Словарь не может содержать повторяющиеся указатели интерфейса. Этот параметр должен содержать указатель интерфейса, который еще не находится в словаре.
Возвращаемое значение
Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Сведения о возвращаемых значениях API документов XPS, не перечисленных в этой таблице, см. в разделе Ошибки документа XPS.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
|
запись не указывает на реализацию распознанного интерфейса. Пользовательская реализация интерфейсов API документов XPS не поддерживается. |
Комментарии
Указатели интерфейса, хранящиеся в словаре, обычно являются указателями на интерфейсы, такие как IXpsOMBrush и IXpsOMVisual, которые являются производными от интерфейса IXpsOMShareable . Чтобы определить тип интерфейса, вызовите метод IXpsOMShareable::GetType .
В расположении, указанном индексом, этот метод вставляет указатель интерфейса IXpsOMShareable и задает ключ; указатель интерфейса и ключ передаются в значении и ключе соответственно. Перед вставками значения и ключа указатель интерфейса и ключ в этом и всех последующих расположениях перемещаются вверх на один индекс.
На рисунке ниже показано изменение словаря методом InsertAt .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | xpsobjectmodel.h |