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 열거형의 다른 요소 중 하나를 반환합니다.

요구 사항

추가 정보

DriverStringOptions

글꼴

그래픽

그래픽::D rawDriverString

행렬

RectF

SolidBrush