GetTextExtentPointI 함수(wingdi.h)

아티클
08/27/2023

GetTextExtentPointI 함수는 지정된 문자 모양 인덱스 배열의 너비와 높이를 계산합니다.

구문

BOOL GetTextExtentPointI(
  [in]  HDC    hdc,
  [in]  LPWORD pgiIn,
  [in]  int    cgi,
  [out] LPSIZE psize
);

매개 변수

[in] hdc

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

[in] pgiIn

문자 모양 인덱스 배열에 대한 포인터입니다.

[in] cgi

문자 모양 인덱스의 수를 지정합니다.

[out] psize

논리 단위로 문자열의 차원을 수신하는 SIZE 구조체에 대한 포인터입니다.

반환 값

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

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

설명

GetTextExtentPointI 함수는 현재 선택한 글꼴을 사용하여 문자 모양 인덱스 배열의 차원을 계산합니다. 너비와 높이(논리 단위)는 클리핑을 고려하지 않고 계산됩니다.

이 함수는 텍스트 범위를 반환할 때 텍스트가 가로, 즉 이스케이프먼트가 항상 0이라고 가정합니다. 이는 텍스트의 가로 및 세로 측정 모두에 해당합니다. 0이 아닌 이스케이프먼트를 지정하는 글꼴을 사용하는 경우에도 이 함수는 텍스트 범위를 계산하는 동안 각도를 사용하지 않습니다. 앱은 명시적으로 변환해야 합니다. 그러나 그래픽 모드가 GM_ADVANCED 설정되고 문자 방향이 인쇄 방향에서 90도인 경우 이 함수가 반환하는 값은 이 규칙을 따르지 않습니다. 문자 방향과 인쇄 방향이 지정된 문자열과 일치하면 이 함수는 SIZE 구조의 문자열 크기를 { cx : 116, cy : 18 }로 반환합니다. 동일한 문자열에 대해 문자 방향과 인쇄 방향이 90도 떨어져 있으면 이 함수는 SIZE 구조의 문자열 크기를 { cx : 18, cy : 116 }로 반환합니다.

일부 디바이스 커닝 문자는 개별 문자 모양 인덱스의 익스텐트 합계가 전체 문자 모양 인덱스 배열의 범위와 같지 않을 수 있습니다.

계산된 문자열 너비는 SetTextCharacterExtra 함수에서 설정한 문자 간 간격을 고려합니다.

요구 사항


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