DataGridView.AutoResizeColumns 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
調整所有欄位的寬度以符合其儲存格的內容。
多載
| 名稱 | Description |
|---|---|
| AutoResizeColumns() |
調整所有欄位的寬度,以容納所有儲存格的內容,包括標頭儲存格。 |
| AutoResizeColumns(DataGridViewAutoSizeColumnsMode) |
可依指定大小模式調整所有欄位的寬度。 |
| AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean) |
使用指定的大小模式調整所有欄位的寬度,並可選擇計算寬度,並預期列高會隨後調整。 |
AutoResizeColumns()
調整所有欄位的寬度,以容納所有儲存格的內容,包括標頭儲存格。
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)
可依指定大小模式調整所有欄位的寬度。
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 不是一個有效的 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)
使用指定的大小模式調整所有欄位的寬度,並可選擇計算寬度,並預期列高會隨後調整。
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 不是一個有效的 DataGridViewAutoSizeColumnsMode 值。
備註
如果你想控制欄位大小調整的時間,這個方法很有用。 欄位寬度每次方法呼叫僅調整一次;若欄位內容後來改變,欄位不會自動調整。 要調整特定欄位大小,請使用該 AutoResizeColumn 方法。 要設定欄位在內容變動時自動調整大小,請使用 該 AutoSizeColumnsMode 屬性或欄位 AutoSizeMode 屬性。
這種過載讓你能指定一種尺寸模式,根據有限儲存格集合的數值計算新的寬度,例如只顯示在列中的格子。 當控制項包含大量列時,這能提升效能。
這種過載受到保護,設計目的是讓你能在衍生 DataGridView 類別中達到理想的單元高寬比。 若 fixedHeight 是 false,則欄位寬度會預期你接下來會呼叫 AutoResizeRow 或 AutoResizeRows 方法。
欲了解更多程式化調整大小的資訊,請參閱 Windows Forms DataGridView 控制項中的尺寸選項。