ScriptApplyLogicalWidth 함수(usp10.h)

아티클
03/03/2024

실행에 대한 사전 너비 배열을 사용하고 조정된 사전 문자 모양 너비의 배열을 생성합니다.

구문

HRESULT ScriptApplyLogicalWidth(
  [in]                const int             *piDx,
  [in]                int                   cChars,
  [in]                int                   cGlyphs,
  [in]                const WORD            *pwLogClust,
  [in]                const SCRIPT_VISATTR  *psva,
  [in]                const int             *piAdvance,
  [in]                const SCRIPT_ANALYSIS *psa,
  [in, out, optional] ABC                   *pABC,
  [out]               int                   *piJustify
);

매개 변수

[in] piDx

코드 포인트당 하나씩 논리 순서로 진행 너비 배열에 대한 포인터입니다.

[in] cChars

실행의 논리 코드 포인트 수입니다.

[in] cGlyphs

문자 모양 수입니다.

[in] pwLogClust

ScriptShape의 논리 클러스터 배열에 대한 포인터입니다.

[in] psva

ScriptShape에서 SCRIPT_VISATTR 구조체에 대한 포인터이며 ScriptPlace에서 업데이트됩니다.

[in] piAdvance

ScriptPlace에서 문자 모양 사전 너비 배열에 대한 포인터입니다.

[in] psa

ScriptItemize의 SCRIPT_ANALYSIS 구조체에 대한 포인터이며 ScriptShape 및 ScriptPlace에 의해 업데이트됩니다.

[in, out, optional] pABC

실행의 전체 ABC 너비 에 대한 포인터입니다. 입력에서 매개 변수에는 ScriptPlace에서 검색한 실행 ABC 너비가 포함되어야 합니다. 출력에서 매개 변수는 새 너비와 일치하도록 업데이트된 ABC 너비를 나타냅니다.

[out] piJustify

함수가 문자 모양 사전 너비를 검색하는 배열에 대한 포인터입니다. 이 배열은 ScriptTextOut의 piJustify 매개 변수에 전달하는 데 적합합니다.

반환 값

정상적으로 실행되는 경우 0을 반환합니다. 함수는 성공하지 못하면 0이 아닌 HRESULT 값을 반환합니다. 애플리케이션은 SUCCEEDED 및 FAILED 매크로를 사용하여 반환 값을 테스트 할 수 있습니다.

설명

이 함수는 ScriptGetLogicalWidths를 사용하여 얻은 논리적 너비를 다시 적용하는 데 사용할 수 있습니다. 메타파일링과 같은 상황에서 유용할 수 있습니다. 이 경우 사전 너비 정보를 글꼴 독립적 방식으로 기록하고 다시 적용해야 하며 문자 모양 대체(예: 합자화)와 무관합니다.

중요 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 이상