GetCharABCWidthsA 함수(wingdi.h)

아티클
08/27/2023

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

구문

BOOL GetCharABCWidthsA(
  [in]  HDC   hdc,
  [in]  UINT  wFirst,
  [in]  UINT  wLast,
  [out] LPABC lpABC
);

매개 변수

[in] hdc

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

[in] wFirst

현재 글꼴에서 연속된 문자 그룹의 첫 번째 문자입니다.

[in] wLast

현재 글꼴에서 연속된 문자 그룹의 마지막 문자입니다.

[out] lpABC

문자 너비를 논리적 단위로 받는 ABC 구조체 배열에 대한 포인터입니다. 이 배열은 uFirstChar 및 uLastChar 매개 변수로 지정된 범위에 문자가 있는 만큼의 ABC 구조를 포함해야 합니다.

반환 값

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

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

설명

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

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

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

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

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

참고

wingdi.h 헤더는 GETCharABCWidths를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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