IXpsOMTileBrush::GetViewbox 메서드(xpsobjectmodel.h)

타일에서 사용할 원본 이미지의 부분을 가져옵니다.

구문

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

매개 변수

[out, retval] viewbox

타일에서 사용할 원본 콘텐츠의 영역을 설명하는 XPS_RECT 구조체입니다.

반환 값

메서드가 성공하면 S_OK 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

반환 코드 Description
S_OK
메서드가 성공했습니다.
E_POINTER
viewboxNULL입니다.

설명

브러시의 보기 상자는 타일 이미지로 사용할 원본 이미지 또는 시각적 개체의 부분을 지정합니다.

브러시 보기 상자의 좌표는 원본 콘텐츠에 상대적이므로(0,0) 원본 콘텐츠의 왼쪽 위 모서리를 지정합니다. 이미지의 경우 브러시의 보기 상자에 지정된 차원이 1/96 단위로 표현됩니다. 원본 이미지의 해당 픽셀 좌표는 다음과 같이 계산됩니다.

다음 그림에서 왼쪽 이미지는 원본 이미지의 예이고, 가운데에 있는 이미지는 선택한 보기 상자를 표시하고, 오른쪽의 이미지는 결과 브러시를 표시합니다.

보기 상자 예제를 보여 주는 그림 원본 이미지 해상도가 인치당 96 x 96개이고 이미지 크기가 96 x 96픽셀인 경우 viewbox 매개 변수의 필드 값은 다음과 같습니다.

위의 매개 변수 값은 원본 이미지에 다음과 같습니다.

SourceLeft = 96× 48/96 = 왼쪽에서 48픽셀
SourceTop = 96 × 4/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

추가 정보

IXpsOMTileBrush

XML Paper Specification

XPS_RECT