IXpsOMVisualBrush::GetVisual 메서드(xpsobjectmodel.h)

브러시의 소스로 사용할 확인된 시각적 개체의 인터페이스에 대한 포인터를 가져옵니다.

구문

HRESULT GetVisual(
  [out, retval] IXpsOMVisual **visual
);

[out, retval] visual

브러시의 소스로 사용되는 확인된 시각적 개체의 IXpsOMVisual 인터페이스에 대한 포인터입니다. 시각적 개체가 설정되지 않은 경우 NULL 포인터가 반환됩니다.

이 매개 변수에서 반환되는 값은 시각적 개체를 설정하기 위해 가장 최근에 호출된 메서드에 따라 달라집니다.

호출된 가장 최근의 메서드	시각적 개체에서 반환되는 개체
SetVisualLocal	SetVisualLocal에서 설정한 시각적 개체입니다.
SetVisualLookup	리소스 디렉터리에서 SetVisualLookup에서 설정한 키와 일치하는 조회 키를 사용하여 검색되는 시각적 개체입니다.
SetVisualLocal 또는 SetVisualLookup은 아직 호출되지 않았습니다.	NULL 포인터입니다.

이 메서드는 HRESULT를 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 이에 국한되지 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_POINTER	시각적 개체 가 NULL입니다.
XPS_E_LOOKUP_INVALID_TYPE	SetStrokeBrushLookup에서 설정한 조회 키 이름은 브러시가 아닌 개체를 참조합니다.
XPS_E_LOOKUP_NOT_FOUND	조회 값과 일치하는 키 이름을 가진 개체를 찾을 수 없습니다.

이 메서드는 IXpsOMVisual 인터페이스 포인터를 반환합니다. 그러나
반환되는 인터페이스는 IXpsOMCanvas, IXpsOMPath 및 IXpsOMGlyphs와 같이 IXpsOMVisual에서 상속되는 모든 인터페이스일 수 있습니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	xpsobjectmodel.h