DataGridView.AutoSizeRowsMode 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定值,指出要如何判斷資料列的高度。
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 值。 預設為 None。
例外狀況
設定這個屬性時所指定的值不是有效的 DataGridViewAutoSizeRowsMode 值。
設定這個屬性時所指定的值是 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 控制項中的調整大小選項。