DataGridViewColumn.AutoSizeMode 屬性

  • 參考

定義

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

取得或設定資料行自動調整其寬度所根據的模式。

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

屬性值

DataGridViewAutoSizeColumnMode

DataGridViewAutoSizeColumnMode 值，決定資料行是否調整其寬度，以及如何決定所要用的寬度。 預設為 NotSet。

例外狀況

InvalidEnumArgumentException

在設定這個屬性時所指定的值並非有效的 DataGridViewAutoSizeColumnMode。

InvalidOperationException

設定這個屬性時所指定的值，在隱藏資料行行首時，會為可見資料行產生 InheritedAutoSizeMode 的 ColumnHeader 值。

-或-

設定這個屬性時所指定的值，會為凍結的可見資料行產生 InheritedAutoSizeMode 的 Fill 值。

範例

下列程式碼範例會強制資料行自動調整其寬度，以符合其內容。 此程式碼範例是針對 類別提供的較大範例的 DataGridViewColumn 一部分。

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}

// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}

' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

備註

資料行的自動調整大小行為是由 屬性的值所決定，這個值 InheritedAutoSizeMode 與所有值的值 AutoSizeMode 相同，但 NotSet 除外，這表示值是繼承自 DataGridView.AutoSizeColumnsMode 屬性。

InheritedAutoSizeMode當屬性值為 Fill 時，資料行會隨著該模式中的其他資料行調整大小。 控制項中的所有填滿模式資料行會以屬性值所 FillWeight 決定的比例來分割可用空間。 填滿模式的寬度取決於從控制項的工作區寬度減去所有其他資料行的寬度。 如果此寬度小於所有填滿模式資料行的合併 MinimumWidth 值，則會顯示水準捲軸，所有填滿模式資料行都會以其最小寬度顯示，而且會停用使用者資料行調整大小。 如需資料行填滿模式的詳細資訊，請參閱DataGridView 控制項中的 Windows Forms資料行填滿模式。

InheritedAutoSizeMode當 屬性設定為以外的 None 任何其他值時，資料行會管理其寬度，使其儲存格值完全顯示，而不會裁剪。 在以內容為基礎的調整大小模式中，每當儲存格內容變更或啟用時，每當資料列高度變更 WrapMode 時，就會進行大小調整。 某些以內容為基礎的調整大小模式可讓您限制目前顯示的資料列大小調整，以提高效能。

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

若要以程式設計方式調整資料行寬度，請使用 DataGridView 控制項的 AutoResizeColumn 或 方法或 AutoResizeColumns 設定資料行 Width 屬性。

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

適用於

另請參閱