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