DataGridView.AutoSizeRowsMode 屬性

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

取得或設定值，指出要如何判斷資料列的高度。

public:
 property System::Windows::Forms::DataGridViewAutoSizeRowsMode AutoSizeRowsMode { System::Windows::Forms::DataGridViewAutoSizeRowsMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeRowsMode value); };
public System.Windows.Forms.DataGridViewAutoSizeRowsMode AutoSizeRowsMode { get; set; }
member this.AutoSizeRowsMode : System.Windows.Forms.DataGridViewAutoSizeRowsMode with get, set
Public Property AutoSizeRowsMode As DataGridViewAutoSizeRowsMode

屬性值

DataGridViewAutoSizeRowsMode

指出調整大小模式的 DataGridViewAutoSizeRowsMode 值。 預設為 None。

例外狀況

InvalidEnumArgumentException

設定這個屬性時所指定的值不是有效的 DataGridViewAutoSizeRowsMode 值。

InvalidOperationException

設定這個屬性時所指定的值是 AllHeaders 或 DisplayedHeaders，且資料列標頭已隱藏。

範例

下列程式碼範例示範如何根據資料列標頭和所有資料行的內容，將資料列設定為自動調整大小。 此程式碼範例是如何：在 Windows Forms DataGridView 控制項中內容變更時自動調整儲存格大小之較大範例的一部分。

void AutoSizeRowsMode( Object^ /*sender*/, EventArgs^ /*es*/ )
{
   dataGridView1->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::AllCells;
}

private void AutoSizeRowsMode(Object sender, EventArgs es)
{
    dataGridView1.AutoSizeRowsMode =
        DataGridViewAutoSizeRowsMode.AllCells;
}

Private Sub AutoSizeRowsMode(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button7.Click

    DataGridView1.AutoSizeRowsMode = _
        DataGridViewAutoSizeRowsMode.AllCells

End Sub

備註

此屬性可讓您設定 控制項，以便在內容變更時自動調整資料列高度以符合其內容。 如果 WrapMode 已啟用，每當資料行寬度變更時，也會調整資料列高度。 某些調整大小模式可讓您限制目前顯示資料列的大小調整，以提高效能。

只有屬性值 true 為 Visible 的資料列會自動調整大小，而變更資料列的可見度並不會造成調整大小。 此外，當資料列設定為自動調整大小時，使用者無法使用滑鼠調整資料列高度。

自動 Height 調整大小資料列的值會在版面配置期間重新計算，以考慮所使用的字型大小。 若要取得正確的 Height ，您應該擷取表單 Layout 事件中的值，而不是在表單的建構函式中擷取。

若要以程式設計方式調整資料列高度，請使用 AutoResizeRow 或 AutoResizeRows 方法，或設定資料列 Height 屬性。

若要讓儲存格內容在重設資料列大小時換行到多行，儲存格的效果儲存格樣式必須具有 WrapMode 的屬性值 True 。

如需內容型自動調整大小的詳細資訊，請參閱Windows Forms DataGridView 控制項中的調整大小選項。

適用於

另請參閱