DataGridViewCell.MeasureTextPreferredSize メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridViewCell.MeasureTextPreferredSize メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

特性を指定して、指定したテキストの最適な高さと幅を取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Shared Function MeasureTextPreferredSize
 ( _
    graphics As Graphics, _
    text As String, _
    font As Font, _
    maxRatio As Single, _
    flags As TextFormatFlags _
) As Size

Visual Basic (使用法)

Dim graphics As Graphics
Dim text As String
Dim font As Font
Dim maxRatio As Single
Dim flags As TextFormatFlags
Dim returnValue As Size

returnValue = DataGridViewCell.MeasureTextPreferredSize(graphics, text, font, maxRatio,
 flags)

C#

public static Size MeasureTextPreferredSize
 (
    Graphics graphics,
    string text,
    Font font,
    float maxRatio,
    TextFormatFlags flags
)

C++

public:
static Size MeasureTextPreferredSize (
    Graphics^ graphics, 
    String^ text, 
    Font^ font, 
    float maxRatio, 
    TextFormatFlags flags
)

J#

public static Size MeasureTextPreferredSize
 (
    Graphics graphics, 
    String text, 
    Font font, 
    float maxRatio, 
    TextFormatFlags flags
)

JScript

public static function MeasureTextPreferredSize
 (
    graphics : Graphics, 
    text : String, 
    font : Font, 
    maxRatio : float, 
    flags : TextFormatFlags
) : Size

パラメータ

graphics

テキストを表示するために使用する Graphics。

text

計測対象のテキスト。

font

テキストに適用される Font。

maxRatio

テキストのブロックの、最大の幅と高さの比率。

flags

テキストに適用される TextFormatFlags 値のビットごとの組み合わせ。

戻り値
テキストの適切な高さと幅を表す Size。

例外

例外の種類	条件
ArgumentNullException	graphics が null 参照 (Visual Basic では Nothing) です。 または font が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	maxRatio が 0 以下です。
InvalidEnumArgumentException	flags が、TextFormatFlags 値の有効なビットごとの組み合わせではありません。

解説

複数の行が必要で、指定した書式設定で許可される場合、返されるサイズには、すべての行の高さの合計が含まれます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewCell クラス
DataGridViewCell メンバ
System.Windows.Forms 名前空間
DataGridView クラス