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 8 시작: Windows 7에서 실행되는 기능을 유지하려면 Uniscribe를 사용하는 모듈에서 라이브러리 목록에서 gdi32.lib 전에 Usp10.lib를 지정해야 합니다.

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	usp10.h
라이브러리	Usp10.lib
DLL	Usp10.dll
재배포 가능 파일	Windows Me/98/95의 인터넷 Explorer 5 이상

추가 정보

SCRIPT_ANALYSIS

SCRIPT_VISATTR

ScriptXtoCP

Uniscribe

Uniscribe 함수