Graphics::MeasureDriverString メソッド (gdiplusgraphics.h)

[アーティクル]
02/26/2024

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 列挙体の他の要素のいずれかを返します。

要件

要件	値
サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdiplusgraphics.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll