GetCharWidthI 함수(wingdi.h)

아티클
08/27/2023

GetCharWidthI 함수는 현재 글꼴에서 지정된 범위의 연속 문자 모양 인덱스의 너비를 논리적 좌표로 검색합니다.

구문

BOOL GetCharWidthI(
  [in]  HDC    hdc,
  [in]  UINT   giFirst,
  [in]  UINT   cgi,
  [in]  LPWORD pgi,
  [out] LPINT  piWidths
);

매개 변수

[in] hdc

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

[in] giFirst

연속 문자 모양 인덱스 그룹의 첫 번째 문자 모양 인덱스입니다.

[in] cgi

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

[in] pgi

문자 모양 인덱스 배열에 대한 포인터입니다. 이 매개 변수가 NULL이 아닌 경우 giFirst 매개 변수 대신 사용됩니다.

[out] piWidths

논리 좌표로 너비를 받는 버퍼에 대한 포인터입니다.

반환 값

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

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

설명

처리할 첫 번째 문자 모양 인덱스를 나타내는 giFirst 매개 변수와 처리할 문자 모양 인덱스 수를 나타내는 cgi 매개 변수를 사용하여 pgi 매개 변수가 NULL인 경우 GetCharWidthI 함수는 연속 문자 모양 인덱스를 처리합니다. 그렇지 않으면 GetCharWidthI 함수는 처리할 문자 모양 인덱스 수를 나타내는 cgi 매개 변수를 사용하여 pgi 매개 변수가 가리키는 문자 모양 인덱스 배열을 처리합니다.

현재 글꼴에 문자가 없으면 기본 문자의 너비가 할당됩니다.

요구 사항


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