ScriptStringXtoCP 함수(usp10.h)
x 좌표를 문자 위치로 변환합니다.
구문
HRESULT ScriptStringXtoCP(
[in] SCRIPT_STRING_ANALYSIS ssa,
[in] int iX,
[out] int *piCh,
[out] int *piTrailing
);
매개 변수
[in] ssa
문자열에 대한 SCRIPT_STRING_ANALYSIS 구조체입니다.
[in] iX
x 좌표입니다.
[out] piCh
이 함수가 x 좌표에 해당하는 문자 위치를 검색하는 변수에 대한 포인터입니다.
[out] piTrailing
이 함수가 x 좌표가 문자 위치의 선행 가장자리 또는 후행 가장자리에 대한 것인지 여부를 나타내는 값을 검색하는 변수에 대한 포인터입니다. 자세한 내용은 주의 섹션을 참조하세요.
반환 값
성공하면 S_OK 반환합니다. 함수는 성공하지 못하면 0이 아닌 HRESULT 값을 반환합니다. 애플리케이션은 SUCCEEDED 및 FAILED 매크로를 사용하여 반환 값을 테스트 할 수 있습니다.
설명
x 좌표가 문자의 선행 가장자리에 해당하는 경우 piTrailing 값은 0입니다. x 좌표가 문자의 후행 가장자리에 해당하는 경우 piTrailing 값은 양의 정수입니다. ScriptXtoCP의 경우 자체적으로 렌더링할 수 있는 문자의 값은 1입니다. 문자가 클러스터 내에 커서가 배치되지 않은 스크립트에서 클러스터의 일부인 경우 값은 1보다 큽니다. 이는 다음 합법적인 논리 커서 위치에 대한 오프셋을 나타냅니다.
x 좌표가 줄의 시작 앞에 있는 경우 함수는 piCh 의 경우 -1, 피트레일링의 경우 1을 검색하여 줄 앞에 존재하지 않는 문자의 후행 가장자리를 나타냅니다. x 좌표가 줄의 끝 다음에 있으면 함수는 piCh 에 대해 줄 길이를 초과하는 첫 번째 인덱스를 검색하고 piTrailing의 경우 0을 검색합니다. 0 값은 줄 뒤에 존재하지 않는 문자의 선행 가장자리를 나타냅니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | usp10.h |
| 라이브러리 | Usp10.lib |
| DLL | Usp10.dll |
| 재배포 가능 파일 | Windows Me/98/95의 인터넷 Explorer 5 이상 |