Поделиться через

Метод IXpsOMTileBrush::GetViewbox (xpsobjectmodel.h)

  • Статья

Возвращает часть исходного изображения, используемую плиткой.

Синтаксис

HRESULT GetViewbox(
  [out, retval] XPS_RECT *viewbox
);

Параметры

[out, retval] viewbox

Структура XPS_RECT , описывающая область исходного содержимого, используемого плиткой.

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

Если метод завершается успешно, он возвращает S_OK; В противном случае возвращается код ошибки HRESULT .

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_POINTER
 viewbox имеет значение NULL.

Комментарии

Поле просмотра кисти указывает часть исходного изображения или визуального элемента, которая будет использоваться в качестве изображения плитки.

Координаты поля просмотра кисти относительно исходного содержимого, так что (0,0) указывает верхний левый угол исходного содержимого. Для изображений размеры, заданные полем просмотра кисти, выражаются в единицах 1/96". Соответствующие координаты пикселей на исходном изображении вычисляются следующим образом:

На следующем рисунке слева показан пример исходного изображения, на изображении в центре отображается выбранное поле просмотра, а на изображении справа — результирующая кисть.

Иллюстрация с примером окна просмотра Если разрешение исходного изображения составляет 96 х 96 точек на дюйм, а размеры изображения — 96 х 96 пикселей, значения полей в параметре окна просмотра будут следующими:

Приведенные выше значения параметров соответствуют исходному изображению следующим образом:

SourceLeft = 96 × 48 / 96 = 48 пикселей слева
SourceTop = 96 × 4 / 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

См. также раздел

IXpsOMTileBrush

XPS

XPS_RECT