IXpsOMGradientBrush::SetTransformLookup 메서드(xpsobjectmodel.h)
브러시에 사용할 공유 행렬 변환의 조회 키 이름을 설정합니다.
키 이름은 리소스 사전에서 공유 리소스를 식별합니다.
구문
HRESULT SetTransformLookup(
[in] LPCWSTR key
);
매개 변수
[in] key
브러시에 사용할 행렬 변환의 조회 키 이름입니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표의 값이 포함되지만 이에 국한되지는 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.
| 반환 코드 | Description |
|---|---|
|
메서드가 성공했습니다. |
|
XML 용지 사양에 따르면 조회 값은 유효한 조회 키 문자열이 아닙니다. |
|
키의 조회 키 이름은 기하 도형이 아닌 개체를 참조합니다. |
|
키에 전달된 값과 일치하는 키 이름을 가진 개체를 찾을 수 없습니다. |
설명
SetTransformLookup을 호출하면 로컬 변환이 해제되고 GetTransformLocal이 변환 매개 변수에 NULL 포인터를 반환합니다. 다음 표에서는 이 속성의 로컬 값과 조회 값 간의 관계를 설명합니다.
| 호출된 가장 최근의 메서드 | GetTransform에 의해 변환에서 반환되는 개체 | GetTransformLocal에 의해 변환에서 반환되는 개체 | GetTransformLookup에서 키에 반환되는 개체 |
|---|---|---|---|
| SetTransformLocal에 의해 설정된 로컬 변환입니다. | SetTransformLocal에 의해 설정된 로컬 변환입니다. | NULL 포인터입니다. | |
| SetTransformLookup (이 메서드) | 리소스 디렉터리에서 SetTransformLookup에서 설정한 키와 일치하는 조회 키를 사용하여 검색된 공유 변환입니다. | NULL 포인터입니다. | SetTransformLookup에서 설정한 조회 키입니다. |
| SetTransformLocal 또는 SetTransformLookup이 아직 호출되지 않았습니다. | NULL 포인터입니다. | NULL 포인터입니다. | NULL 포인터입니다. |
키에서 참조하는 변환은 그라데이션이 변환되는 방법을 결정합니다. 궁극적으로 이미지에서 렌더링되는 그라데이션의 표시되는 부분은 브러시를 사용하는 경로, 스트로크 또는 문자 모양에 따라 결정됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | xpsobjectmodel.h |