DataGridViewCell.MeasureTextPreferredSize メソッドとは何？わかりやすく解説 Weblio辞書

.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)

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
)

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 値の有効なビットごとの組み合わせではありません。

例外の種類

条件

ArgumentNullException

graphics が null 参照 (Visual Basic では Nothing) です。

または

font が null 参照 (Visual Basic では Nothing) です。

ArgumentOutOfRangeException

maxRatio が 0 以下です。

InvalidEnumArgumentException

flags が、TextFormatFlags 値の有効なビットごとの組み合わせではありません。

解説

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