DataGridView.AutoResizeColumns 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
調整所有資料行的寬度,以適合其儲存格的內容。
多載
AutoResizeColumns() |
調整所有資料行的寬度,以適合其所有儲存格的內容 (包括標題儲存格)。 |
AutoResizeColumns(DataGridViewAutoSizeColumnsMode) |
使用指定的調整大小模式調整所有資料行的寬度。 |
AutoResizeColumns(DataGridViewAutoSizeColumnsMode, Boolean) |
使用指定的調整大小模式調整所有資料行的寬度,並在預期接下來將調整資料列高度的情況下,選擇性地計算寬度。 |
AutoResizeColumns()
調整所有資料行的寬度,以適合其所有儲存格的內容 (包括標題儲存格)。
public:
void AutoResizeColumns();
public void AutoResizeColumns ();
member this.AutoResizeColumns : unit -> unit
Public Sub AutoResizeColumns ()
範例
下列程式碼範例會調整所有資料行的大小,以符合資料行和資料行標頭的內容。 此程式碼範例是如何:以程式設計方式調整儲存格大小以符合 DataGridView 控制項 Windows Forms中內容之較大範例的一部分。
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 屬性。
如需程式設計調整大小的詳細資訊,請參閱dataGridView 控制項中的重設大小選項Windows Forms。
另請參閱
適用於
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 值。
範例
下列程式碼範例會調整所有資料行的大小,以符合資料行和資料行標頭的內容。 此程式碼範例是如何:以程式設計方式調整儲存格大小以符合 DataGridView 控制項 Windows Forms中內容之較大範例的一部分。
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 屬性。
此多載可讓您指定大小調整模式,根據一組有限儲存格中的值來計算新的寬度,例如僅顯示的資料列中的值。 當控制項包含大量資料列時,這可改善效能。
如需程式設計調整大小的詳細資訊,請參閱dataGridView 控制項中的重設大小選項Windows Forms。
另請參閱
適用於
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 方法。
如需程式設計調整大小的詳細資訊,請參閱dataGridView 控制項中的重設大小選項Windows Forms。