Graphics::MeasureString(constWCHAR*,INT,constFont*,constPointF&,constStringFormat*,RectF*) 메서드(gdiplusgraphics.h)

Graphics::MeasureString 메서드는 지정된 글꼴, 형식 및 레이아웃 사각형에서 문자열의 범위를 측정합니다.

구문

Status MeasureString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const Font         *font,
  [in, ref] const PointF &     origin,
  [in]      const StringFormat *stringFormat,
  [out]     RectF              *boundingBox
);

매개 변수

[in] string

형식: const WCHAR*

측정할 와이드 문자열에 대한 포인터입니다.

중요 아랍어와 같은 양방향 언어의 경우 문자열 길이가 2046자를 초과하면 안 됩니다.
 

[in] length

형식: INT

문자열 배열의 문자 수를 지정하는 정수입니다. 문자열이 null로 종료되면 length 매개 변수를 –1로 설정할 수 있습니다.

[in] font

형식: const 글꼴*

문자열에 적용되는 글꼴 의 패밀리 이름, 크기 및 스타일을 지정하는 Font 개체에 대한 포인터입니다.

[in, ref] origin

형식: const PointF

문자열이 시작되는 지점에 대한 참조입니다.

[in] stringFormat

형식: const StringFormat*

맞춤, 트리밍, 탭 중지 등과 같은 레이아웃 정보를 지정하는 StringFormat 개체에 대한 포인터입니다.

[out] boundingBox

형식: RectF*

문자열을 바인딩하는 사각형을 수신하는 RectF 개체에 대한 포인터입니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 OK를 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

요구 사항

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

추가 정보

DrawString 메서드

글꼴

그래픽

Pointf

StringFormat