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 フラグが設定されている場合、各値は表示する Unicode 文字を指定します。 それ以外の場合、各値は、表示する文字を定義するフォント グリフへのインデックスを指定します。

[in] length

型: INT

テキスト配列内の値の数を指定する整数。 文字列が null で終わる場合は、 length パラメーターを –1 に設定できます。

[in] font

型: const Font*

文字列に適用するフォントのファミリ名、サイズ、スタイルを指定する Font オブジェクトへのポインター。

[in] positions

型: const PointF*

DriverStringOptionsRealizedAdvance フラグが設定されている場合、 positions は、最初のグリフの位置を指定する PointF オブジェクトへのポインターです。 それ以外の場合、 位置 は PointF オブジェクトの配列であり、それぞれが個々のグリフの原点を指定します。

[in] flags

型: INT

文字列の外観のオプションを指定する整数。 この値は 、DriverStringOptions 列挙体の要素、またはこれらの 2 つ以上の要素に適用されたビットごとの OR の結果である必要があります。

[in] matrix

型: const Matrix*

テキスト配列の各値に適用する変換マトリックスを指定する Matrix オブジェクトへのポインター。

[out] boundingBox

型: RectF*

文字列をバインドする四角形を受け取る RectF オブジェクトへのポインター。

戻り値

種類: 状態

メソッドが成功した場合は、 Status 列挙体の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

要件

こちらもご覧ください

DriverStringOptions

フォント

グラフィックス

Graphics::D rawDriverString

マトリックス

RectF

Solidbrush