Метод IXpsOMVisualBrush::GetVisual (xpsobjectmodel.h)

Статья
08/28/2023

Возвращает указатель на интерфейс разрешенного визуального элемента, используемого в качестве источника для кисти.

Синтаксис

HRESULT GetVisual(
  [out, retval] IXpsOMVisual **visual
);

Параметры

[out, retval] visual

Указатель на интерфейс IXpsOMVisual разрешенного визуального объекта, используемого в качестве источника для кисти. Если визуальный элемент не задан, возвращается указатель NULL .

Значение, возвращаемое в этом параметре, зависит от того, какой метод был вызван последним для задания визуального объекта.

Самый последний вызываемый метод	Объект, возвращаемый в визуальном элементе
SetVisualLocal	Визуальный элемент, заданный setVisualLocal.
SetVisualLookup	Полученный визуальный элемент с ключом подстановки, который соответствует ключу, заданному SetVisualLookup, из каталога ресурсов.
Ни SetVisualLocal , ни SetVisualLookup пока не были вызваны.	Указатель NULL .

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	Visual имеет значение NULL.
XPS_E_LOOKUP_INVALID_TYPE	Имя ключа подстановки, заданное SetStrokeBrushLookup , ссылается на объект, который не является кистью.
XPS_E_LOOKUP_NOT_FOUND	Не удалось найти объект с именем ключа, соответствующим значению поиска.

Этот метод возвращает указатель интерфейса IXpsOMVisual . Однако командлет
Возвращаемым интерфейсом может быть любой интерфейс, наследующий от IXpsOMVisual, например IXpsOMCanvas, IXpsOMPath и IXpsOMGlyphs.

Требования

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