DataGridView.AutoResizeRows 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
調整某些或所有資料列的高度,以適合其內容。
多載
AutoResizeRows(DataGridViewAutoSizeRowsMode) |
使用指定的調整大小模式值來調整資料列的高度。 |
AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) |
使用指定的調整大小模式調整指定資料列的高度,並在預期接下來將調整資料行寬度的情況下,選擇性地計算高度。 |
AutoResizeRows() |
調整所有資料列的高度,以適合其所有儲存格的內容 (包括標題儲存格)。 |
AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean) |
使用指定的調整大小模式調整所有資料列的高度,並在預期接下來將調整資料行寬度的情況下,選擇性地計算高度。 |
AutoResizeRows(DataGridViewAutoSizeRowsMode)
使用指定的調整大小模式值來調整資料列的高度。
public:
void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode);
public void AutoResizeRows (System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode);
member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode -> unit
Public Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode)
參數
- autoSizeRowsMode
- DataGridViewAutoSizeRowsMode
其中一個 DataGridViewAutoSizeRowsMode 值。
例外狀況
autoSizeRowsMode
具有值 AllHeaders 或 DisplayedHeaders,且 RowHeadersVisible 是 false
。
autoSizeRowsMode
不是有效的 DataGridViewAutoSizeRowsMode 值。
autoSizeRowsMode
具有值 None。
範例
下列程式碼範例示範如何根據非標頭儲存格內容調整所有資料列的大小。 此程式碼範例是如何:以程式設計方式調整儲存格大小以符合 DataGridView 控制項 Windows Forms中內容之較大範例的一部分。
void SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}
private void SizeAllRows(Object sender,
EventArgs e)
{
dataGridView1.AutoResizeRows(
DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub SizeAllRows(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button11.Click
DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)
End Sub
備註
如果您想要控制資料列調整大小時,這個方法很有用。 每個方法呼叫只會調整一次資料列高度;如果資料列的內容稍後變更,資料列將不會自動調整。 若要調整特定資料列的大小,請使用 AutoResizeRow 方法。 若要調整資料列子集的大小,請使用 AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) 多載。 若要設定資料列在內容變更時自動調整大小,請使用 AutoSizeRowsMode 屬性。
若要讓儲存格內容在重設資料列大小時換行到多行,儲存格的效果儲存格樣式必須具有 WrapMode 的屬性值 True 。
此多載可讓您指定大小調整模式,根據一組有限儲存格中的值來計算新的高度,例如僅顯示的資料列中的值。 當控制項包含大量資料列時,這可改善效能。
如需程式設計調整大小的詳細資訊,請參閱dataGridView 控制項中的重設大小選項Windows Forms。
另請參閱
適用於
AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean)
使用指定的調整大小模式調整指定資料列的高度,並在預期接下來將調整資料行寬度的情況下,選擇性地計算高度。
protected:
void AutoResizeRows(int rowIndexStart, int rowsCount, System::Windows::Forms::DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
protected void AutoResizeRows (int rowIndexStart, int rowsCount, System.Windows.Forms.DataGridViewAutoSizeRowMode autoSizeRowMode, bool fixedWidth);
member this.AutoResizeRows : int * int * System.Windows.Forms.DataGridViewAutoSizeRowMode * bool -> unit
Protected Sub AutoResizeRows (rowIndexStart As Integer, rowsCount As Integer, autoSizeRowMode As DataGridViewAutoSizeRowMode, fixedWidth As Boolean)
參數
- rowIndexStart
- Int32
要調整大小之第一個資料列的索引。
- rowsCount
- Int32
要調整大小的資料列數目。
- autoSizeRowMode
- DataGridViewAutoSizeRowMode
其中一個 DataGridViewAutoSizeRowMode 值。
- fixedWidth
- Boolean
true
表示根據目前的資料行寬度計算新的高度;false
則表示在預期資料行寬度也將會調整的情況下計算高度。
例外狀況
autoSizeRowsMode
具有值 AllHeaders 或 DisplayedHeaders,且 RowHeadersVisible 是 false
。
autoSizeRowsMode
不是有效的 DataGridViewAutoSizeRowsMode 值。
autoSizeRowsMode
具有值 None。
備註
如果您想要控制資料列調整大小,但只想調整特定資料列子集的大小,例如已更新之系結記錄範圍內的資料列,這個方法很有用。 每個方法呼叫只會調整指定資料列的資料列高度一次;如果資料列的內容稍後變更,資料列將不會自動調整。 若要調整特定資料列的大小,請使用 AutoResizeRow 方法。 若要調整所有資料列的大小,請使用 方法的不同多載 AutoResizeRows 。 若要設定資料列在內容變更時自動調整大小,請使用 AutoSizeRowsMode 屬性。
若要讓儲存格內容在重設資料列大小時換行到多行,儲存格的效果儲存格樣式必須具有 WrapMode 的屬性值 True 。
此多載可讓您指定大小調整模式,根據一組有限儲存格中的值來計算新的高度,例如僅顯示的資料列中的值。 當控制項包含大量資料列時,這可改善效能。
此多載受到保護,其設計目的是讓您在衍生 DataGridView 類別中達到理想的儲存格高度與寬度比例。
fixedWidth
如果 參數為 false
,則會計算資料列高度,並預期您接下來會呼叫 AutoResizeColumn 或 AutoResizeColumns 方法。
如需程式設計調整大小的詳細資訊,請參閱dataGridView 控制項中的重設大小選項Windows Forms。
另請參閱
適用於
AutoResizeRows()
調整所有資料列的高度,以適合其所有儲存格的內容 (包括標題儲存格)。
public:
void AutoResizeRows();
public void AutoResizeRows ();
member this.AutoResizeRows : unit -> unit
Public Sub AutoResizeRows ()
範例
下列程式碼範例示範如何根據非標頭儲存格內容調整所有資料列的大小。 此程式碼範例是如何:以程式設計方式調整儲存格大小以符合 DataGridView 控制項 Windows Forms中內容之較大範例的一部分。
void SizeAllRows( Object^ /*sender*/, EventArgs^ /*e*/ )
{
dataGridView1->AutoResizeRows(DataGridViewAutoSizeRowsMode::AllCellsExceptHeaders);
}
private void SizeAllRows(Object sender,
EventArgs e)
{
dataGridView1.AutoResizeRows(
DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders);
}
Private Sub SizeAllRows(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button11.Click
DataGridView1.AutoResizeRows(DataGridViewAutoSizeRowsMode.AllCellsExceptHeaders)
End Sub
備註
如果您想要控制資料列調整大小時,這個方法很有用。 每個方法呼叫只會調整一次資料列高度;如果資料列的內容稍後變更,資料列將不會自動調整。 若要調整特定資料列的大小,請使用 AutoResizeRow 方法。 若要調整資料列子集的大小,請使用 AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) 多載。 若要設定資料列在內容變更時自動調整大小,請使用 AutoSizeRowsMode 屬性。
若要讓儲存格內容在重設資料列大小時換行到多行,儲存格的效果儲存格樣式必須具有 WrapMode 的屬性值 True 。
如需程式設計調整大小的詳細資訊,請參閱dataGridView 控制項中的重設大小選項Windows Forms。
另請參閱
適用於
AutoResizeRows(DataGridViewAutoSizeRowsMode, Boolean)
使用指定的調整大小模式調整所有資料列的高度,並在預期接下來將調整資料行寬度的情況下,選擇性地計算高度。
protected:
void AutoResizeRows(System::Windows::Forms::DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);
protected void AutoResizeRows (System.Windows.Forms.DataGridViewAutoSizeRowsMode autoSizeRowsMode, bool fixedWidth);
member this.AutoResizeRows : System.Windows.Forms.DataGridViewAutoSizeRowsMode * bool -> unit
Protected Sub AutoResizeRows (autoSizeRowsMode As DataGridViewAutoSizeRowsMode, fixedWidth As Boolean)
參數
- autoSizeRowsMode
- DataGridViewAutoSizeRowsMode
其中一個 DataGridViewAutoSizeRowsMode 值。
- fixedWidth
- Boolean
true
表示根據目前的資料行寬度計算新的高度;false
則表示在預期資料行寬度也將會調整的情況下計算高度。
例外狀況
autoSizeRowsMode
具有值 AllHeaders 或 DisplayedHeaders,且 RowHeadersVisible 是 false
。
autoSizeRowsMode
不是有效的 DataGridViewAutoSizeRowsMode 值。
autoSizeRowsMode
具有值 None。
備註
如果您想要控制資料列調整大小時,這個方法很有用。 每個方法呼叫只會調整一次資料列高度;如果資料列的內容稍後變更,資料列將不會自動調整。 若要調整特定資料列的大小,請使用 AutoResizeRow 方法。 若要調整資料列子集的大小,請使用 AutoResizeRows(Int32, Int32, DataGridViewAutoSizeRowMode, Boolean) 多載。 若要設定資料列在內容變更時自動調整大小,請使用 AutoSizeRowsMode 屬性。
若要讓儲存格內容在重設資料列大小時換行到多行,儲存格的效果儲存格樣式必須具有 WrapMode 的屬性值 True 。
此多載可讓您指定大小調整模式,根據一組有限儲存格中的值來計算新的高度,例如僅顯示的資料列中的值。 當控制項包含大量資料列時,這可改善效能。
此多載受到保護,且旨在讓您在衍生 DataGridView 類別中達到理想的儲存格高度與寬度比例。
fixedWidth
如果 參數為 false
,則會計算資料列高度,並預期您接下來會呼叫 AutoResizeColumn 或 AutoResizeColumns 方法。
如需程式設計調整大小的詳細資訊,請參閱dataGridView 控制項中的重設大小選項Windows Forms。