IXpsOMTileBrush::SetViewbox 메서드(xpsobjectmodel.h)
타일 이미지로 사용할 원본 콘텐츠의 부분을 설정합니다.
구문
HRESULT SetViewbox(
[in] const XPS_RECT *viewbox
);
매개 변수
[in] viewbox
타일 이미지로 사용할 원본 콘텐츠의 부분을 설명하는 XPS_RECT 구조체입니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표의 값이 포함되지만 이에 국한되지는 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.
| 반환 코드 | 설명 |
|---|---|
|
메서드가 성공했습니다. |
|
viewbox 가 NULL입니다. |
|
보기 상자에 설명된 사각형이 잘못되었습니다. |
설명
브러시의 보기 상자는 타일 이미지로 사용할 원본 이미지 또는 시각적 개체의 부분을 지정합니다.
브러시 보기 상자의 좌표는 원본 콘텐츠에 상대적이므로(0,0) 원본 콘텐츠의 왼쪽 위 모서리를 지정합니다. 이미지의 경우 브러시의 보기 상자에 지정된 차원이 1/96 단위로 표현됩니다. 원본 이미지의 해당 픽셀 좌표는 다음과 같이 계산됩니다.
다음 그림에서는 왼쪽의 이미지가 원본 이미지의 예이고 오른쪽은 빨간색 사각형으로 표시된 브러시에 대해 선택한 보기 상자가 있는 원본 이미지입니다. 이 예제에서 타일 브러시의 콘텐츠로 사용되는 원본 이미지의 부분은 빨간색 사각형 내의 영역입니다. 이미지의 음영 영역은 브러시에서 사용되지 않습니다.
원본 이미지 해상도가 인치당 96 x 96개이고 이미지 크기가 96 x 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 SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | xpsobjectmodel.h |