GetCharABCWidthsI 함수(wingdi.h)

아티클
08/27/2023

GetCharABCWidthsI 함수는 현재 TrueType 글꼴에서 지정된 범위의 연속 문자 모양 인덱스의 너비를 논리 단위로 검색합니다. 이 함수는 TrueType 글꼴로만 성공합니다.

구문

BOOL GetCharABCWidthsI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPABC  pabc
);

매개 변수

[in] hdc

디바이스 컨텍스트에 대한 핸들입니다.

[in] giFirst

현재 글꼴의 연속 문자 모양 인덱스 그룹의 첫 번째 문자 모양 인덱스입니다. 이 매개 변수는 pgi 매개 변수가 NULL인 경우에만 사용됩니다.

[in] cgi

문자 모양 인덱스의 수입니다.

[in] pgi

문자 모양 인덱스가 포함된 배열에 대한 포인터입니다. 이 매개 변수가 NULL이면 giFirst 매개 변수가 대신 사용됩니다. cgi 매개 변수는 이 배열의 문자 모양 인덱스 수를 지정합니다.

[out] pabc

문자 너비를 논리 단위로 받는 ABC 구조체의 배열에 대한 포인터입니다. 이 배열에는 cgi 매개 변수로 지정된 문자 모양 인덱스만큼 ABC 구조가 적어도 많이 포함되어야 합니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다.

설명

TrueType 래스터라이저는 특정 지점 크기를 선택한 후 ABC 문자 간격을 제공합니다. 간격은 문자 모양을 배치하기 전에 현재 위치에 추가된 거리입니다. B 간격은 문자 모양에서 검은색 부분의 너비입니다. C 간격은 문자 모양 오른쪽에 공백을 제공하기 위해 현재 위치에 추가된 거리입니다. 전체 고급 너비는 A+B+C로 지정됩니다.

GetCharABCWidthsI 함수가 문자에 대한 음의 A 또는 C 너비를 검색하는 경우 해당 문자에는 언더행 또는 오버행이 포함됩니다.

ABC 너비를 글꼴 디자인 단위로 변환하려면 애플리케이션에서 OUTLINETEXTMETRIC 구조체의 otmEMSquare 멤버에 저장된 값을 사용해야 합니다. 이 값은 GetOutlineTextMetrics 함수를 호출하여 검색할 수 있습니다.

기본 문자의 ABC 너비는 현재 선택한 글꼴 범위를 벗어난 문자에 사용됩니다.

TrueType이 아닌 글꼴에서 문자 모양 인덱스의 너비를 검색하려면 애플리케이션에서 GetCharWidthI 함수를 사용해야 합니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	wingdi.h(Windows.h 포함)
라이브러리	Gdi32.lib
DLL	Gdi32.dll