Метод IXpsOMDictionary::Append (xpsobjectmodel.h)

Статья
08/28/2023

Добавляет интерфейс IXpsOMShareable вместе с его ключом в конец словаря.

Синтаксис

HRESULT Append(
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

Параметры

[in] key

Ключ, используемый для этой записи.

Строка, на которую ссылается ключ, должна быть уникальной в словаре.

[in] entry

Указатель на интерфейс IXpsOMShareable, добавляемый в словарь.

Словарь не может содержать повторяющиеся указатели интерфейса. Этот параметр должен содержать указатель интерфейса, который еще не находится в словаре.

Возвращаемое значение

Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Сведения о возвращаемых значениях API документов XPS, не перечисленных в этой таблице, см. в разделе Ошибки документа XPS.

Код возврата	Описание
S_OK	Метод выполнен успешно.
XPS_E_NO_CUSTOM_OBJECTS	запись не указывает на реализацию распознанного интерфейса. Пользовательская реализация интерфейсов API документов XPS не поддерживается.

Указатели интерфейса, хранящиеся в словаре, обычно указывают на интерфейсы, такие как IXpsOMBrush и IXpsOMVisual, которые являются производными от интерфейса IXpsOMShareable . Чтобы определить тип интерфейса, вызовите метод IXpsOMShareable::GetType .

На рисунке ниже показано изменение словаря методом Append .

Рисунок, показывающий, как Добавление добавляет запись в словарь

Требования


Минимальная версия клиента	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