IXpsOMGradientBrush::GetTransformLookup 메서드(xpsobjectmodel.h)
브러시에 사용할 공유 행렬 변환 인터페이스의 조회 키 이름을 가져옵니다.
키 이름은 리소스 사전에서 공유 리소스를 식별합니다.
구문
HRESULT GetTransformLookup(
[out, retval] LPWSTR *key
);
매개 변수
[out, retval] key
브러시에 사용할 공유 행렬 변환 인터페이스의 조회 키 이름입니다. 조회 키 이름이 설정되지 않았거나 로컬 행렬 변환이 설정된 경우 NULL 포인터가 반환됩니다.
이 매개 변수에서 반환되는 값은 조회 키 또는 변환을 설정하기 위해 가장 최근에 호출된 메서드에 따라 달라집니다.
| 호출된 가장 최근의 메서드 | 키에 반환되는 문자열 |
|---|---|
| NULL 포인터입니다. | |
| SetTransformLookup에서 설정한 키입니다. | |
| SetTransformLocal 또는 SetTransformLookup은 아직 호출되지 않았습니다. | NULL 포인터입니다. |
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 이에 국한되지 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.
| 반환 코드 | 설명 |
|---|---|
|
메서드가 성공했습니다. |
|
키 는 NULL입니다. |
설명
이 메서드는 IXpsOMMatrixTransform 인터페이스 포인터를 반환하지 않습니다. 사전에서 이 포인터를 검색하려면 IXpsOMDictionary::GetByKey를 호출합니다.
변환은 그라데이션이 변환되는 방법을 결정합니다. 궁극적으로 이미지에서 렌더링되는 그라데이션의 표시 부분은 그라데이션 브러시를 사용하는 경로, 스트로크 또는 문자 모양에 따라 결정됩니다.
이 메서드는 키에 반환되는 문자열에서 사용하는 메모리를 할당합니다. 키가NULL이 아닌 경우 CoTaskMemFree 함수를 사용하여 메모리를 해제합니다.
요구 사항
| 지원되는 최소 클라이언트 | 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 |