語言

DataGridView.AutoResizeColumns 方法

定義

調整所有欄位的寬度以符合其儲存格的內容。

多載

名稱 Description
AutoResizeColumns()

調整所有欄位的寬度,以容納所有儲存格的內容,包括標頭儲存格。

AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

可依指定大小模式調整所有欄位的寬度。

AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

使用指定的大小模式調整所有欄位的寬度,並可選擇計算寬度,並預期列高會隨後調整。

AutoResizeColumns()

來源:
DataGridView.Methods.cs
來源:
DataGridView.Methods.cs
來源:
DataGridView.Methods.cs
來源:
DataGridView.Methods.cs
來源:
DataGridView.Methods.cs

調整所有欄位的寬度,以容納所有儲存格的內容,包括標頭儲存格。

public:
 void AutoResizeColumns();
public void AutoResizeColumns();
member this.AutoResizeColumns : unit -> unit
Public Sub AutoResizeColumns ()

範例

以下程式碼範例將所有欄位調整大小以符合欄位內容及欄位標頭。 此程式碼範例是《 如何:程式化調整儲存格以符合 Windows 表單 DataGridView 控制項內容》中較大範例的一部分。

void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}
private void SizeAllColumns(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeColumns(
        DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)

End Sub

備註

如果你想控制欄位大小調整的時間,這個方法很有用。 欄位寬度每次方法呼叫僅調整一次;若欄位內容後來改變,欄位不會自動調整。 要調整特定欄位大小,請使用該 AutoResizeColumn 方法。 要設定欄位在內容變動時自動調整大小,請使用 該 AutoSizeColumnsMode 屬性或欄位 AutoSizeMode 屬性。

欲了解更多程式化調整大小的資訊,請參閱 Windows Forms DataGridView 控制項中的尺寸選項。

另請參閱

適用於

AutoResizeColumns(DataGridViewAutoSizeColumnsMode)

來源:
DataGridView.Methods.cs
來源:
DataGridView.Methods.cs
來源:
DataGridView.Methods.cs
來源:
DataGridView.Methods.cs
來源:
DataGridView.Methods.cs

可依指定大小模式調整所有欄位的寬度。

public:
 void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
public void AutoResizeColumns(System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode -> unit
Public Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode)

參數

autoSizeColumnsMode
DataGridViewAutoSizeColumnsMode

這是其中一項 DataGridViewAutoSizeColumnsMode 價值。

例外狀況

autoSizeColumnsMode 具有 值, ColumnHeader 且 ColumnHeadersVisible 為 false。

autoSizeColumnsMode其值NoneFill為 或 。

autoSizeColumnsMode 不是一個有效的 DataGridViewAutoSizeColumnsMode 值。

範例

以下程式碼範例將所有欄位調整大小以符合欄位內容及欄位標頭。 此程式碼範例是《 如何:程式化調整儲存格以符合 Windows 表單 DataGridView 控制項內容》中較大範例的一部分。

void SizeAllColumns( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   dataGridView1->AutoResizeColumns( DataGridViewAutoSizeColumnsMode::AllCells );
}
private void SizeAllColumns(Object sender, EventArgs e)
{
    dataGridView1.AutoResizeColumns(
        DataGridViewAutoSizeColumnsMode.AllCells);
}
Private Sub SizeAllColumns(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    DataGridView1.AutoResizeColumns(DataGridViewAutoSizeColumnsMode.AllCells)

End Sub

備註

如果你想控制欄位大小調整的時間,這個方法很有用。 欄位寬度每次方法呼叫僅調整一次;若欄位內容後來改變,欄位不會自動調整。 要調整特定欄位大小,請使用該 AutoResizeColumn 方法。 要設定欄位在內容變動時自動調整大小,請使用 該 AutoSizeColumnsMode 屬性或欄位 AutoSizeMode 屬性。

這種過載讓你能指定一種尺寸模式,根據有限儲存格集合的數值計算新的寬度,例如只顯示在列中的格子。 當控制項包含大量列時,這能提升效能。

欲了解更多程式化調整大小的資訊,請參閱 Windows Forms DataGridView 控制項中的尺寸選項。

另請參閱

適用於

AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean)

來源:
DataGridView.Methods.cs
來源:
DataGridView.Methods.cs
來源:
DataGridView.Methods.cs
來源:
DataGridView.Methods.cs
來源:
DataGridView.Methods.cs

使用指定的大小模式調整所有欄位的寬度,並可選擇計算寬度,並預期列高會隨後調整。

protected:
 void AutoResizeColumns(System::Windows::Forms::DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
protected void AutoResizeColumns(System.Windows.Forms.DataGridViewAutoSizeColumnsMode autoSizeColumnsMode, bool fixedHeight);
member this.AutoResizeColumns : System.Windows.Forms.DataGridViewAutoSizeColumnsMode * bool -> unit
Protected Sub AutoResizeColumns (autoSizeColumnsMode As DataGridViewAutoSizeColumnsMode, fixedHeight As Boolean)

參數

autoSizeColumnsMode
DataGridViewAutoSizeColumnsMode

這是其中一項 DataGridViewAutoSizeColumnsMode 價值。

fixedHeight
Boolean

true 根據目前列高計算新寬度; false 計算寬度時,預期列高也會被調整。

例外狀況

autoSizeColumnsMode 具有 值, ColumnHeader 且 ColumnHeadersVisible 為 false。

autoSizeColumnsMode其值NoneFill為 或 。

autoSizeColumnsMode 不是一個有效的 DataGridViewAutoSizeColumnsMode 值。

備註

如果你想控制欄位大小調整的時間,這個方法很有用。 欄位寬度每次方法呼叫僅調整一次;若欄位內容後來改變,欄位不會自動調整。 要調整特定欄位大小,請使用該 AutoResizeColumn 方法。 要設定欄位在內容變動時自動調整大小,請使用 該 AutoSizeColumnsMode 屬性或欄位 AutoSizeMode 屬性。

這種過載讓你能指定一種尺寸模式,根據有限儲存格集合的數值計算新的寬度,例如只顯示在列中的格子。 當控制項包含大量列時,這能提升效能。

這種過載受到保護,設計目的是讓你能在衍生 DataGridView 類別中達到理想的單元高寬比。 若 fixedHeight 是 false,則欄位寬度會預期你接下來會呼叫 AutoResizeRow 或 AutoResizeRows 方法。

欲了解更多程式化調整大小的資訊,請參閱 Windows Forms DataGridView 控制項中的尺寸選項。

另請參閱

適用於