Graphics::MeasureDriverString 메서드(gdiplusgraphics.h)
Graphics::MeasureDriverString 메서드는 지정된 문자와 해당 위치에 대한 경계 상자를 측정합니다.
구문
Status MeasureDriverString(
[in] const UINT16 *text,
[in] INT length,
[in] const Font *font,
[in] const PointF *positions,
[in] INT flags,
[in] const Matrix *matrix,
[out] RectF *boundingBox
);
매개 변수
[in] text
형식: const UINT16*
16비트 값 배열에 대한 포인터입니다. DriverStringOptionsCmapLookup 플래그가 설정된 경우 각 값은 표시할 유니코드 문자를 지정합니다. 그렇지 않으면 각 값은 표시할 문자를 정의하는 글꼴 문자 모양에 대한 인덱스를 지정합니다.
[in] length
형식: INT
텍스트 배열의 값 수를 지정하는 정수입니다. 문자열이 null로 종료되면 length 매개 변수를 –1로 설정할 수 있습니다.
[in] font
형식: const 글꼴*
문자열에 적용할 글꼴의 패밀리 이름, 크기 및 스타일을 지정하는 Font 개체에 대한 포인터입니다.
[in] positions
형식: const PointF*
DriverStringOptionsRealizedAdvance 플래그가 설정된 경우 positions 는 첫 번째 문자 모양 위치를 지정하는 PointF 개체에 대한 포인터입니다. 그렇지 않으면 위치 는 PointF 개체의 배열이며, 각 개체는 개별 문자 모양의 원점을 지정합니다.
[in] flags
형식: INT
문자열의 모양에 대한 옵션을 지정하는 정수입니다. 이 값은 DriverStringOptions 열거형의 요소이거나 이러한 요소 중 두 개 이상에 적용된 비트 OR 의 결과여야 합니다.
[in] matrix
형식: const Matrix*
텍스트 배열의 각 값에 적용할 변환 행렬을 지정하는 Matrix 개체에 대한 포인터입니다.
[out] boundingBox
형식: RectF*
문자열을 바인딩하는 사각형을 수신하는 RectF 개체에 대한 포인터입니다.
반환 값
형식: 상태
메서드가 성공하면 Status 열거형의 요소인 확인을 반환합니다.
메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP, Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | gdiplusgraphics.h(Gdiplus.h 포함) |
| 라이브러리 | Gdiplus.lib |
| DLL | Gdiplus.dll |