Метод IXpsOMTileBrush::SetViewbox (xpsobjectmodel.h)
Задает часть исходного содержимого, которая будет использоваться в качестве изображения плитки.
Синтаксис
HRESULT SetViewbox(
[in] const XPS_RECT *viewbox
);
Параметры
[in] viewbox
Структура XPS_RECT , описывающая часть исходного содержимого, которая будет использоваться в качестве изображения плитки.
Возвращаемое значение
Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Сведения о возвращаемых значениях API документов XPS, не перечисленных в этой таблице, см. в статье Ошибки документа XPS.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
|
viewbox имеет значение NULL. |
|
Прямоугольник, описанный в поле просмотра, был недопустимым. |
Комментарии
Поле просмотра кисти указывает часть исходного изображения или визуального элемента, которая будет использоваться в качестве изображения плитки.
Координаты поля просмотра кисти находятся относительно исходного содержимого, так что (0,0) указывает левый верхний угол исходного содержимого. Для изображений измерения, заданные полем просмотра кисти, выражаются в единицах 1/96". Соответствующие пиксельные координаты на исходном изображении вычисляются следующим образом:
На рисунке ниже изображение слева является примером исходного изображения, а справа — исходное изображение с выбранным полем просмотра для кисти в виде красного прямоугольника. В этом примере часть исходного изображения, которая используется в качестве содержимого для кисти плитки, представляет собой область в красном прямоугольнике. Затеняемая область изображения не используется кистью.
Если исходное разрешение изображения составляет 96 х 96 точек на дюйм, а размеры изображения — 96 х 96 пикселей, то значения полей в параметре viewbox будут следующими:Предыдущие значения параметров соответствуют исходному изображению следующим образом:
- SourceLeft = 96 * 48 / 96 = 48 пикселей с левой стороны
- SourceTop = 96 * 24 / 96 = 24 пикселя сверху
- SourceWidth = 96 * 24 / 96 = 24 пикселей в ширину
- SourceHeight = 96 * 48 / 96 = 48 пикселей в высоту
Требования
| Минимальная версия клиента | 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 |