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

[アーティクル]
01/10/2024

Graphics::MeasureString メソッドは、指定したフォント、書式、レイアウト四角形の文字列の範囲を測定します。

構文

Status MeasureString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const Font         *font,
  [in, ref] const SizeF &      layoutRectSize,
  [in]      const StringFormat *stringFormat,
  [out]     SizeF              *size,
  [out]     INT                *codepointsFitted,
  [out]     INT                *linesFilled
);

パラメーター

[in] string

型: const WCHAR*

測定するワイド文字列へのポインター。

大事な アラビア語などの双方向言語の場合、文字列の長さは 2046 文字を超えることはできません。

[in] length

型: INT

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

[in] font

型: const Font*

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

[in, ref] layoutRectSize

型: const SizeF

文字列をバインドする四角形の幅と高さを指定する SizeF オブジェクトへの参照。

[in] stringFormat

型: const StringFormat*

配置、トリミング、タブ位置などのレイアウト情報を指定する StringFormat オブジェクトへのポインター。

[out] size

種類: SizeF*

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

[out] codepointsFitted

型: INT*

省略可能。レイアウトの四角形に実際に収まる文字数を受け取る INT へのポインター。既定値は NULL ポインターです。

[out] linesFilled

型: INT*

省略可能。レイアウト四角形に実際に収まる行数を受け取る INT へのポインター。既定値は NULL ポインターです。

戻り値

種類: 状態

メソッドが成功すると、 Status 列挙体の要素である OK が返されます。

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

要件


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