Graphics::MeasureString(constWCHAR,INT,constFont,constPointF&,constStringFormat,RectF) メソッド (gdiplusgraphics.h)

[アーティクル]
08/24/2023

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*

文字列に適用されるフォントのファミリ名、サイズ、スタイルを指定する 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 を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll