ScriptCPtoX 함수(usp10.h)
실행의 왼쪽 끝 또는 선행 가장자리에서 논리 문자 클러스터의 선행 또는 후행 가장자리로 x 오프셋을 생성 합니다.
구문
HRESULT ScriptCPtoX(
[in] int iCP,
[in] BOOL fTrailing,
[in] int cChars,
[in] int cGlyphs,
[in] const WORD *pwLogClust,
[in] const SCRIPT_VISATTR *psva,
[in] const int *piAdvance,
[in] const SCRIPT_ANALYSIS *psa,
[out] int *piX
);
매개 변수
[in] iCP
실행의 논리적 문자 위치입니다. 이 매개 변수는 클러스터에 있는 논리 문자의 오프셋에 해당합니다.
[in] fTrailing
TRUE 이면 논리 문자 클러스터의 후행 가장자리를 사용하여 오프셋을 계산합니다. 이 매개 변수는 논리 문자 클러스터의 선행 가장자리를 사용하기 위해 FALSE 로 설정됩니다.
[in] cChars
실행 중인 문자 수입니다.
[in] cGlyphs
실행 중인 문자 모양 수입니다.
[in] pwLogClust
논리 클러스터에 대한 포인터입니다.
[in] psva
시각적 특성의 SCRIPT_VISATTR 배열에 대한 포인터입니다.
[in] piAdvance
고급 너비 값에 대한 포인터입니다.
[in] psa
SCRIPT_ANALYSIS 구조체에 대한 포인터입니다. fLogicalOrder 멤버는 오프셋을 측정할 실행의 끝을 지정합니다. 플래그가 설정되면 실행의 선행 가장자리가 사용됩니다. 플래그가 설정되지 않은 경우 실행의 왼쪽 끝이 사용됩니다.
[out] piX
함수가 caret의 x 위치를 검색하는 버퍼에 대한 포인터입니다.
반환 값
정상적으로 실행되는 경우 0을 반환합니다. 이 함수는 성공하지 못하면 0이 아닌 HRESULT 값을 반환합니다. 애플리케이션은 SUCCEEDED 및 FAILED 매크로를 사용하여 반환 값을 테스트 할 수 있습니다.
설명
문자의 선행 또는 후행 가장자리와 실행의 선행 가장자리는 실행에서 텍스트 방향에 따라 달라집니다.
캐럿이 종래 클러스터 중간에 배치되는 스크립트(예: 아랍어 및 히브리어)의 경우 캐럿의 검색된 x 위치는 줄의 모든 코드 지점에 대해 보간된 위치일 수 있습니다.
일반적으로 캐리트가 클러스터의 경계(예: 태국어 및 인도)에 스냅되는 스크립트의 경우 x 위치는 iCP로 표시된 논리적 문자 위치를 포함하는 클러스터의 요청된 가장자리에 스냅됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | usp10.h |
| 라이브러리 | Usp10.lib |
| DLL | Usp10.dll |
| 재배포 가능 파일 | Windows Me/98/95의 인터넷 Explorer 5 이상 |