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 值。

例外狀況

ArgumentException

rowHeadersWidthSizeMode 具有值 EnableResizing 或 DisableResizing。

InvalidEnumArgumentException

rowHeadersWidthSizeMode 不是有效的 DataGridViewRowHeadersWidthSizeMode 值。

備註

如果您想要控制資料列標頭調整大小時，這個方法很有用。 每個方法呼叫的資料列標頭寬度只會調整一次;如果稍後資料列標頭的內容變更，則資料列標頭將不會自動調整。 若要設定資料列標頭在內容變更時自動調整大小，請使用 RowHeadersWidthSizeMode 屬性。

這個方法可讓您指定大小調整模式，根據一組有限標頭中的值來計算新的寬度，例如只顯示的資料列中的值。 當控制項包含大量資料列時，這會改善效能。

如需以程式設計方式調整大小的詳細資訊，請參閱dataGridView 控制項中的 Windows Forms調整大小選項。

另請參閱

適用於

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 值。

例外狀況

ArgumentOutOfRangeException

rowIndex 不在 0 到資料列數目減 1 的有效範圍內。

ArgumentException

rowHeadersWidthSizeMode 具有值 EnableResizing 或 DisableResizing

InvalidEnumArgumentException

rowHeadersWidthSizeMode 不是有效的 DataGridViewRowHeadersWidthSizeMode 值。

範例

下列程式碼範例說明如何根據第一個資料列標頭內容的變更來調整資料列標頭寬度的大小。 此程式碼範例是如何：以程式設計方式調整儲存格大小以符合 DataGridView 控制項 Windows Forms中內容之較大範例的一部分。

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

備註

如果您想要控制資料列標頭的大小是否只有指定資料列中的標頭內容因為使用者編輯或變更系結資料來源而變更，這個方法會很有用。 如果內容變更需要，資料列標頭的寬度只會調整每個方法呼叫一次;如果稍後資料列標頭的內容變更，則資料列標頭將不會自動調整。 若要設定資料列標頭在內容變更時自動調整大小，請使用 RowHeadersWidthSizeMode 屬性。

這個方法可讓您指定大小調整模式，根據一組有限標頭中的值來計算新的寬度，例如只顯示的資料列中的值。 當控制項包含大量資料列時，這會改善效能。

如需以程式設計方式調整大小的詳細資訊，請參閱dataGridView 控制項中的 Windows Forms調整大小選項。

另請參閱

適用於

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 值。

fixedColumnHeadersHeight
Boolean

true 表示根據目前資料行標頭的高度計算新的寬度；false 則表示在預期資料行標頭的高度也將會調整的情況下計算寬度。

fixedRowsHeight
Boolean

true 表示根據目前的資料列高度來計算新的寬度；false 則表示在預期資料列高度也將會調整的情況下計算寬度。

例外狀況

ArgumentException

rowHeadersWidthSizeMode 具有值 EnableResizing 或 DisableResizing。

InvalidEnumArgumentException

rowHeadersWidthSizeMode 不是有效的 DataGridViewRowHeadersWidthSizeMode 值。

備註

如果您想要控制資料列標頭調整大小時，這個方法很有用。 每個方法呼叫的資料列標頭寬度只會調整一次;如果稍後資料列標頭的內容變更，則資料列標頭將不會自動調整。 若要設定資料列標頭在內容變更時自動調整大小，請使用 RowHeadersWidthSizeMode 屬性。

這個方法可讓您指定大小調整模式，根據一組有限標頭中的值來計算新的寬度，例如只顯示的資料列中的值。 當控制項包含大量資料列時，這會改善效能。

此多載受到保護，其設計目的是讓您在衍生 DataGridView 類別中達到理想的儲存格高度與寬度比例。 fixedColumnHeadersHeight如果 或 fixedRowsHeight 參數為 false ，則會計算資料列標頭的寬度，並預期您將呼叫 和 AutoResizeRows AutoResizeColumnHeadersHeight next 等方法。

如需以程式設計方式調整大小的詳細資訊，請參閱dataGridView 控制項中的 Windows Forms調整大小選項。

另請參閱

適用於

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 值。

fixedColumnHeadersHeight
Boolean

true 表示根據目前資料行標頭的高度計算新的寬度；false 則表示在預期資料行標頭的高度也將會調整的情況下計算寬度。

fixedRowHeight
Boolean

true 表示根據指定資料列的目前高度計算新的寬度；false 則表示在預期資料列高度也將會調整的情況下計算寬度。

例外狀況

ArgumentOutOfRangeException

rowIndex 不在 0 到資料列數目減 1 的有效範圍內。

ArgumentException

rowHeadersWidthSizeMode 具有值 EnableResizing 或 DisableResizing。

InvalidEnumArgumentException

rowHeadersWidthSizeMode 不是有效的 DataGridViewRowHeadersWidthSizeMode 值。

備註

如果您想要控制資料列標頭的大小是否只有指定資料列中的標頭內容因為使用者編輯或變更系結資料來源而變更，這個方法會很有用。 如果內容變更需要，資料列標頭的寬度只會調整每個方法呼叫一次;如果稍後資料列標頭的內容變更，則資料列標頭將不會自動調整。 若要設定資料列標頭在內容變更時自動調整大小，請使用 RowHeadersWidthSizeMode 屬性。

這個方法可讓您指定大小調整模式，根據一組有限標頭中的值來計算新的寬度，例如只顯示的資料列中的值。 當控制項包含大量資料列時，這會改善效能。

此多載受到保護，並設計成讓您在衍生 DataGridView 類別中達到理想的儲存格高度與寬度比例。 fixedColumnHeadersHeight如果 或 fixedRowHeight 參數為 false ，則會計算資料列標頭的寬度，並預期您將呼叫 和 AutoResizeRows AutoResizeColumnHeadersHeight next 等方法。

如需以程式設計方式調整大小的詳細資訊，請參閱dataGridView 控制項中的 Windows Forms調整大小選項。

另請參閱

適用於