Метод IXpsOMVisual::SetClipGeometryLookup (xpsobjectmodel.h)
Задает имя ключа подстановки общей геометрии клипа в словаре ресурсов.
Синтаксис
HRESULT SetClipGeometryLookup(
[in] LPCWSTR key
);
Параметры
[in] key
Имя ключа поиска геометрии клипа в словаре. Указатель NULL очищает ранее назначенное имя ключа.
Возвращаемое значение
Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Сведения о возвращаемых значениях API документов XPS, не перечисленных в этой таблице, см. в статье Ошибки документа XPS.
Код возврата | Описание |
---|---|
|
Метод выполнен успешно. |
|
Согласно спецификации документа XML значение поиска не является допустимой строкой ключа подстановки. |
|
Имя ключа подстановки в key ссылается на объект, который не является геометрией. |
|
Не удалось найти объект с именем ключа, совпадающим со значением, переданным в ключе. |
Комментарии
После вызова SetClipGeometryLookup локальная геометрия клипа освобождается, а GetClipGeometryLocal возвращает указатель NULL в параметре clipGeometry . В следующей таблице объясняется связь между локальными значениями и значениями подстановки этого свойства.
Самый последний вызываемый метод | Объект, возвращаемый в clipGeometryметодом GetClipGeometry | Объект, возвращаемый в clipGeometryметодом GetClipGeometryLocal | Строка, возвращаемая в ключеметодом GetClipGeometryLookup |
---|---|---|---|
Локальная геометрия клипа, заданная setClipGeometryLocal. | Локальная геометрия клипа, заданная setClipGeometryLocal. | Указатель NULL . | |
SetClipGeometryLookup (этот метод) | Извлекаемая геометрия общего клипа с ключом подстановки, который соответствует ключу, заданному SetClipGeometryLookup, из каталога ресурсов. | Указатель NULL . | Ключ подстановки, заданный setClipGeometryLookup. |
Ни SetClipGeometryLookup , ни SetClipGeometryLocal пока не были вызваны. | Указатель NULL . | Указатель NULL . | Указатель NULL . |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | 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 |