GetTextExtentExPointI 함수(wingdi.h)

  • 아티클

GetTextExtentExPointI 함수는 지정된 공백 내에 들어갈 지정된 문자열의 문자 수를 검색하고 각 문자에 대한 텍스트 범위로 배열을 채웁니다. 텍스트 범위는 공백의 시작 부분과 공백에 맞는 문자 사이의 거리입니다. 이 정보는 단어 줄 바꿈 계산에 유용합니다.

구문

BOOL GetTextExtentExPointI(
  [in]  HDC    hdc,
  [in]  LPWORD lpwszString,
  [in]  int    cwchString,
  [in]  int    nMaxExtent,
  [out] LPINT  lpnFit,
  [out] LPINT  lpnDx,
  [out] LPSIZE lpSize
);

매개 변수

[in] hdc

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

[in] lpwszString

익스텐트를 검색할 문자 모양 인덱스 배열에 대한 포인터입니다.

[in] cwchString

pgiIn 매개 변수가 가리키는 배열의 문자 모양 수입니다.

[in] nMaxExtent

서식이 지정된 문자열의 허용 가능한 최대 너비(논리 단위)입니다.

[out] lpnFit

nMaxExtent 매개 변수로 지정된 공간에 맞는 최대 문자 수를 받는 정수에 대한 포인터입니다. lpnFit 매개 변수가 NULL이면 nMaxExtent 매개 변수가 무시됩니다.

[out] lpnDx

부분 문자 모양 익스텐트를 수신하는 정수 배열에 대한 포인터입니다. 배열의 각 요소는 문자 모양 인덱스 배열의 시작 부분과 nMaxExtent 매개 변수로 지정된 공간에 맞는 문자 모양 중 하나 사이의 거리를 논리 단위로 제공합니다. 이 배열에는 cgi 매개 변수에 지정된 문자 모양 인덱스만큼 많은 요소가 있어야 하지만, 함수는 lpnFit 매개 변수에 지정된 만큼의 문자 모양 인덱스에 대해서만 배열을 익스텐트로 채웁니다. lpnFit이 NULL인 경우 함수는 부분 문자열 너비를 계산하지 않습니다.

[out] lpSize

문자 모양 인덱스 배열의 차원을 논리 단위로 받는 SIZE 구조체에 대한 포인터입니다. 이 값은 NULL일 수 없습니다.

반환 값

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

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

설명

lpnFit 및 alpDx 매개 변수가 모두 NULL인 경우 GetTextExtentExPointI 함수를 호출하는 것은 GetTextExtentPointI 함수를 호출하는 것과 같습니다.

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

요구 사항

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

추가 정보

글꼴 및 텍스트 함수

글꼴 및 텍스트 개요

GetTextExtentPoint

SIZE