Метод IXpsOMPage::GetDictionary (xpsobjectmodel.h)
Возвращает указатель на разрешенный интерфейс IXpsOMDictionary , связанный с этой страницей.
Синтаксис
HRESULT GetDictionary(
[out, retval] IXpsOMDictionary **resourceDictionary
);
Параметры
[out, retval] resourceDictionary
Указатель на разрешенный интерфейс IXpsOMDictionary , связанный с этой страницей.
Значение, возвращаемое в этом параметре, зависит от того, какой метод был вызван последний раз для задания словаря.
| Самый последний метод с именем | Объект, возвращаемый в resourceDictionary |
|---|---|
| Локальный ресурс словаря, заданный SetDictionaryLocal. | |
| Общий словарь в ресурсе словаря, который задается setDictionaryResource. | |
| Пока не были вызваны ни SetDictionaryLocal , ни SetDictionaryResource . | Указатель NULL . |
Возвращаемое значение
Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Сведения о возвращаемых значениях API документов XPS, не перечисленных в этой таблице, см. в разделе Ошибки документа XPS.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
|
resourceDictionary имеет значение NULL. |
|
Имя ключа подстановки, заданное SetStrokeBrushLookup , ссылается на объект, который не является кистью. |
|
Не удалось найти объект с именем ключа, соответствующим значению поиска.
Не удалось найти объект с именем ключа, совпадающим со значением, переданным при поиске. |
Комментарии
Независимо от того, является ли словарь локальным или содержится в удаленном ресурсе словаря, этот метод возвращает указатель интерфейса IXpsOMDictionary . GetOwner определяет, является ли словарь удаленным.
Если страница содержит удаленный словарь, GetDictionary десериализует словарь. Если страница содержит недопустимый удаленный словарь, GetDictionary может вернуть код ошибки десериализации.
После загрузки и анализа ресурса в XPS OM этот метод может возвращать ошибку, которая применяется к другому ресурсу. Это происходит потому, что все связи анализируются при загрузке ресурса.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | 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 |