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