ScriptPlace 함수(usp10.h)
ScriptShape의 출력에서 문자 모양 사전 너비 및 2차원 오프셋 정보를 생성합니다.
구문
HRESULT ScriptPlace(
[in] HDC hdc,
[in, out] SCRIPT_CACHE *psc,
[in] const WORD *pwGlyphs,
[in] int cGlyphs,
[in] const SCRIPT_VISATTR *psva,
[in, out] SCRIPT_ANALYSIS *psa,
[out] int *piAdvance,
[out] GOFFSET *pGoffset,
[out] ABC *pABC
);
매개 변수
[in] hdc
선택 사항입니다. 디바이스 컨텍스트에 대한 핸들입니다. 자세한 내용은 캐싱합니다.
[in, out] psc
스크립트 캐시를 식별하는 SCRIPT_CACHE 구조체에 대한 포인터입니다.
[in] pwGlyphs
ScriptShape 함수에 대한 이전 호출에서 가져온 문자 모양 버퍼에 대한 포인터입니다.
[in] cGlyphs
문자 모양 버퍼의 문자 모양 수입니다.
[in] psva
시각적 특성을 나타내는 SCRIPT_VISATTR 구조체 배열에 대한 포인터입니다.
[in, out] psa
SCRIPT_ANALYSIS 구조체에 대한 포인터입니다. 입력 시 이 구조체는 ScriptItemize에 대한 이전 호출에서 가져옵니다. 출력에서 이 구조체에는 ScriptPlace에서 검색한 값이 포함됩니다.
[out] piAdvance
이 함수가 고급 너비 정보를 검색하는 배열에 대한 포인터입니다.
[out] pGoffset
선택 사항입니다. 이 함수가 문자 모양 결합의 x 및 y 오프셋을 검색하는 GOFFSET 구조체 배열에 대한 포인터입니다. 이 배열은 cGlyphs로 표시된 길이여야 합니다.
[out] pABC
이 함수가 전체 실행에 대한 ABC 너비를 검색하는 ABC 구조체에 대한 포인터입니다.
반환 값
정상적으로 실행되는 경우 0을 반환합니다. 함수가 성공하지 못하면 0이 아닌 HRESULT 값을 반환합니다. 애플리케이션은 SUCCEEDED 및 FAILED 매크로를 사용하여 반환 값을 테스트 할 수 있습니다.
psc 매개 변수에 지정된 스크립트 캐시에 문자 모양을 배치하기에 충분한 정보가 포함되어 있지 않고 함수가 배치 프로세스를 완료할 수 없도록 hdc 매개 변수가 NULL로 설정된 경우 함수는 E_PENDING 반환합니다. 애플리케이션은 실행에 대해 올바른 디바이스 컨텍스트를 설정하고 적절한 디바이스 컨텍스트와 다른 모든 매개 변수를 동일하게 사용하여 이 함수를 다시 호출해야 합니다.
설명
이 함수가 일반적으로 호출되는 컨텍스트에 대한 설명은 유니스크립을 사용하여 텍스트 표시 를 참조하세요.
전체 항목에 대한 복합 ABC 너비는 문자 모양이 시작 위치의 왼쪽과 앞 너비의 합계에 의해 암시된 길이의 오른쪽에 얼마나 많은 양으로 돌출 되는지를 식별합니다. 선의 전체 선 너비는 정확히 abcA+abcB+abcC입니다. abcA 및 abcC 값은 8비트로 표시되는 셀 높이의 비율로 유지되므로 대략 +/-1%입니다. piAdvance로 표시된 abcA+abcB+abcC 값의 합계인 검색된 총 너비는 TrueType 셰이핑 엔진의 해상도에 정확합니다.
fLogicalOrder 멤버가 psa 매개 변수로 표시된 SCRIPT_ANALYSIS 구조체에서 설정되지 않는 한 모든 배열은 시각적 순서로 표시됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | usp10.h |
| 라이브러리 | Usp10.lib |
| DLL | Usp10.dll |