DataGridView.AutoResizeRowHeadersWidth メソッド

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

ヘッダーの内容に合わせて行ヘッダーの幅を調整します。

オーバーロード

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)

指定されたサイズ モードを使用して、行ヘッダーの幅を調整します。
AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)

指定された行のヘッダーの内容の変更に基づいて、指定されたサイズ モードを使用して行ヘッダーの幅を調整します。
AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

指定されたサイズ モードを使用して行ヘッダーの幅を調整します。オプションで、行ヘッダーまたは列ヘッダー (またはその両方) の幅が後で調整されることを見込んで幅を計算します。
AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

指定された行のヘッダーの内容の変更に基づいて、指定されたサイズ モードを使用して行ヘッダーの幅を調整します。オプションで、行ヘッダーまたは列ヘッダー (またはその両方) の幅が後で調整されることを見込んで幅を計算します。

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode)

指定されたサイズ モードを使用して、行ヘッダーの幅を調整します。

public:
 void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
public void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit
Public Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)

パラメーター

rowHeadersWidthSizeMode
DataGridViewRowHeadersWidthSizeMode

DataGridViewRowHeadersWidthSizeMode 値のいずれか 1 つ。

例外

ArgumentException

rowHeadersWidthSizeMode の値は EnableResizing または DisableResizing です。

InvalidEnumArgumentException

rowHeadersWidthSizeMode は有効な DataGridViewRowHeadersWidthSizeMode 値ではありません。

注釈

このメソッドは、行ヘッダーのサイズを変更するタイミングを制御する場合に便利です。 行ヘッダーの幅は、メソッド呼び出しごとに 1 回だけ調整されます。行ヘッダーの内容が後で変更された場合、行ヘッダーは自動的に調整されません。 行ヘッダーの内容が変更されたときに自動的にサイズを変更するように設定するには、プロパティを RowHeadersWidthSizeMode 使用します。

このメソッドを使用すると、ヘッダーの制限されたセットの値 (表示される行のみなど) に基づいて新しい幅を計算するサイズ設定モードを指定できます。 これにより、コントロールに多数の行が含まれている場合のパフォーマンスが向上します。

プログラムによるサイズ変更の詳細については、「Windows フォーム DataGridView コントロールのサイズ設定オプション」を参照してください。

こちらもご覧ください

適用対象

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode)

指定された行のヘッダーの内容の変更に基づいて、指定されたサイズ モードを使用して行ヘッダーの幅を調整します。

public:
 void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
public void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode);
member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode -> unit
Public Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode)

パラメーター

rowIndex
Int32

内容が変更された行ヘッダーのインデックス。

rowHeadersWidthSizeMode
DataGridViewRowHeadersWidthSizeMode

DataGridViewRowHeadersWidthSizeMode 値のいずれか 1 つ。

例外

ArgumentOutOfRangeException

rowIndex が、0 以上、行数 - 1 以下の、有効な範囲内にありません。

ArgumentException

rowHeadersWidthSizeMode の値が EnableResizing または DisableResizing

InvalidEnumArgumentException

rowHeadersWidthSizeMode は有効な DataGridViewRowHeadersWidthSizeMode 値ではありません。

例

次のコード例は、最初の行ヘッダーの内容に対する変更に基づいて行ヘッダーの幅を変更する方法を示しています。 このコード例は、「方法: Windows フォーム DataGridView コントロールのコンテンツに合わせてセルのサイズをプログラムで変更する」で提供されるより大きな例の一部です。

void SizeFirstRowHeaderToAllHeaders( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeRowHeadersWidth(0, DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders);
}

private void SizeFirstRowHeaderToAllHeaders(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeRowHeadersWidth(
        0, DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}

Private Sub SizeFirstRowHeaderToAllHeaders(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button8.Click

    DataGridView1.AutoResizeRowHeadersWidth( _
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)

End Sub

注釈

このメソッドは、ユーザーがバインドされたデータ ソースを編集または変更した結果、指定した行のヘッダーの内容のみが変更された場合に、行ヘッダーのサイズを変更するタイミングを制御する場合に便利です。 行ヘッダーの幅は、コンテンツの変更で必要な場合、メソッド呼び出しごとに 1 回だけ調整されます。行ヘッダーの内容が後で変更された場合、行ヘッダーは自動的に調整されません。 行ヘッダーの内容が変更されたときに自動的にサイズを変更するように設定するには、プロパティを RowHeadersWidthSizeMode 使用します。

このメソッドを使用すると、ヘッダーの制限されたセットの値 (表示される行のみなど) に基づいて新しい幅を計算するサイズ設定モードを指定できます。 これにより、コントロールに多数の行が含まれている場合のパフォーマンスが向上します。

プログラムによるサイズ変更の詳細については、「Windows フォーム DataGridView コントロールのサイズ設定オプション」を参照してください。

こちらもご覧ください

適用対象

AutoResizeRowHeadersWidth(DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

指定されたサイズ モードを使用して行ヘッダーの幅を調整します。オプションで、行ヘッダーまたは列ヘッダー (またはその両方) の幅が後で調整されることを見込んで幅を計算します。

protected:
 void AutoResizeRowHeadersWidth(System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);
protected void AutoResizeRowHeadersWidth (System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowsHeight);
member this.AutoResizeRowHeadersWidth : System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit
Protected Sub AutoResizeRowHeadersWidth (rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowsHeight As Boolean)

パラメーター

rowHeadersWidthSizeMode
DataGridViewRowHeadersWidthSizeMode

DataGridViewRowHeadersWidthSizeMode 値のいずれか 1 つ。

fixedColumnHeadersHeight
Boolean

列ヘッダーの現在の高さに基づいて新しい幅を計算する場合は true。列ヘッダーの高さも調整されることを見込んで幅を計算する場合は false。

fixedRowsHeight
Boolean

現在の行の高さに基づいて新しい幅を計算する場合は true。行の高さも調整されることを見込んで幅を計算する場合は false。

例外

ArgumentException

rowHeadersWidthSizeMode の値は EnableResizing または DisableResizing です。

InvalidEnumArgumentException

rowHeadersWidthSizeMode は有効な DataGridViewRowHeadersWidthSizeMode 値ではありません。

注釈

このメソッドは、行ヘッダーのサイズを変更するタイミングを制御する場合に便利です。 行ヘッダーの幅は、メソッド呼び出しごとに 1 回だけ調整されます。行ヘッダーの内容が後で変更された場合、行ヘッダーは自動的に調整されません。 行ヘッダーの内容が変更されたときに自動的にサイズを変更するように設定するには、プロパティを RowHeadersWidthSizeMode 使用します。

このメソッドを使用すると、ヘッダーの制限されたセットの値 (表示される行のみなど) に基づいて新しい幅を計算するサイズ設定モードを指定できます。 これにより、コントロールに多数の行が含まれている場合のパフォーマンスが向上します。

このオーバーロードは保護されており、派生 DataGridView クラスで理想的なセルの高さと幅の比率を実現できるように設計されています。 パラメーターがfixedColumnHeadersHeight``fixedRowsHeight指定されている場合、false行ヘッダーの幅は、次のようなAutoResizeRowsAutoResizeColumnHeadersHeightメソッドを呼び出す予定で計算されます。

プログラムによるサイズ変更の詳細については、「Windows フォーム DataGridView コントロールのサイズ設定オプション」を参照してください。

こちらもご覧ください

適用対象

AutoResizeRowHeadersWidth(Int32, DataGridViewRowHeadersWidthSizeMode, Boolean, Boolean)

指定された行のヘッダーの内容の変更に基づいて、指定されたサイズ モードを使用して行ヘッダーの幅を調整します。オプションで、行ヘッダーまたは列ヘッダー (またはその両方) の幅が後で調整されることを見込んで幅を計算します。

protected:
 void AutoResizeRowHeadersWidth(int rowIndex, System::Windows::Forms::DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);
protected void AutoResizeRowHeadersWidth (int rowIndex, System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode rowHeadersWidthSizeMode, bool fixedColumnHeadersHeight, bool fixedRowHeight);
member this.AutoResizeRowHeadersWidth : int * System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode * bool * bool -> unit
Protected Sub AutoResizeRowHeadersWidth (rowIndex As Integer, rowHeadersWidthSizeMode As DataGridViewRowHeadersWidthSizeMode, fixedColumnHeadersHeight As Boolean, fixedRowHeight As Boolean)

パラメーター

rowIndex
Int32

内容が変更されたヘッダーを格納している行のインデックス。

rowHeadersWidthSizeMode
DataGridViewRowHeadersWidthSizeMode

DataGridViewRowHeadersWidthSizeMode 値のいずれか 1 つ。

fixedColumnHeadersHeight
Boolean

列ヘッダーの現在の高さに基づいて新しい幅を計算する場合は true。列ヘッダーの高さも調整されることを見込んで幅を計算する場合は false。

fixedRowHeight
Boolean

指定された行の現在の高さに基づいて新しい幅を計算する場合は true。行の高さも調整されることを見込んで幅を計算する場合は false。

例外

ArgumentOutOfRangeException

rowIndex が、0 以上、行数 - 1 以下の、有効な範囲内にありません。

ArgumentException

rowHeadersWidthSizeMode の値は EnableResizing または DisableResizing です。

InvalidEnumArgumentException

rowHeadersWidthSizeMode は有効な DataGridViewRowHeadersWidthSizeMode 値ではありません。

注釈

このメソッドは、ユーザーがバインドされたデータ ソースを編集または変更した結果、指定した行のヘッダーの内容のみが変更された場合に、行ヘッダーのサイズを変更するタイミングを制御する場合に便利です。 行ヘッダーの幅は、コンテンツの変更で必要な場合、メソッド呼び出しごとに 1 回だけ調整されます。行ヘッダーの内容が後で変更された場合、行ヘッダーは自動的に調整されません。 行ヘッダーの内容が変更されたときに自動的にサイズを変更するように設定するには、プロパティを RowHeadersWidthSizeMode 使用します。

このメソッドを使用すると、ヘッダーの制限されたセットの値 (表示される行のみなど) に基づいて新しい幅を計算するサイズ設定モードを指定できます。 これにより、コントロールに多数の行が含まれている場合のパフォーマンスが向上します。

このオーバーロードは保護されており、派生 DataGridView クラスで理想的なセルの高さと幅の比率を実現できるように設計されています。 パラメーターがfixedColumnHeadersHeight``fixedRowHeight指定されている場合、false行ヘッダーの幅は、次のようなAutoResizeRowsAutoResizeColumnHeadersHeightメソッドを呼び出す予定で計算されます。

プログラムによるサイズ変更の詳細については、「Windows フォーム DataGridView コントロールのサイズ設定オプション」を参照してください。

こちらもご覧ください

適用対象