DataGridViewAutoSizeColumnMode 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
定義值來指定要如何調整資料行的寬度。
public enum class DataGridViewAutoSizeColumnMode
public enum DataGridViewAutoSizeColumnMode
type DataGridViewAutoSizeColumnMode =
Public Enum DataGridViewAutoSizeColumnMode
- 繼承
欄位
AllCells | 6 | 資料行寬度會調整,以適合資料行中的所有儲存格的內容 (包括標題儲存格)。 |
AllCellsExceptHeader | 4 | 資料行寬度會調整,以適合資料行中的所有儲存格的內容 (不包括標題儲存格)。 |
ColumnHeader | 2 | 資料行寬度會調整,以適合資料行行首儲存格的內容。 |
DisplayedCells | 10 | 資料行寬度會調整,以適合資料行中的所有儲存格的內容 (位在目前顯示在螢幕上的資料列中),包括標題儲存格。 |
DisplayedCellsExceptHeader | 8 | 資料行寬度會調整,以適合資料行中的所有儲存格的內容 (位在目前顯示在螢幕上的資料列中),不包括標題儲存格。 |
Fill | 16 | 資料行寬度會調整,使得所有資料行的寬度可以剛好填滿控制項的顯示區,且必須要使用水平捲動方式,才能讓資料行寬度維持在 MinimumWidth 屬性值之上。 相對的資料行寬度是由相對的 FillWeight 屬性值所決定。 |
None | 1 | 資料行寬度不會自動調整。 |
NotSet | 0 | 資料行的調整大小行為是繼承自 AutoSizeColumnsMode 屬性。 |
範例
下列程式碼範例說明如何使用這個列舉來設定固定寬度資料行。 此範例是如何:設定 DataGridView 控制項Windows Forms大小模式中較大範例的一部分。
DataGridViewTextBoxColumn idColumn =
new DataGridViewTextBoxColumn();
idColumn.HeaderText = "ID";
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None;
idColumn.Resizable = DataGridViewTriState.False;
idColumn.ReadOnly = true;
idColumn.Width = 20;
Dim idColumn As New DataGridViewTextBoxColumn()
idColumn.HeaderText = "ID"
idColumn.AutoSizeMode = DataGridViewAutoSizeColumnMode.None
idColumn.Resizable = DataGridViewTriState.False
idColumn.ReadOnly = True
idColumn.Width = 20
備註
控制項 DataGridView 可以調整其欄的大小,使其填滿控制項的可用水準寬度,或讓它們顯示所有儲存格或指定儲存格的完整內容。
使用 [填滿] 模式時,資料行的慣用寬度取決於調整該模式中的所有資料行大小,讓控制項中的所有可見資料行完全填滿可用顯示區域的水準寬度。 使用其他模式時,慣用的資料行寬度是顯示所有儲存格或該資料行中儲存格子集的最大儲存格值所需的最小寬度,例如目前顯示的資料列儲存格子集。 使用資料格子集來判斷新的寬度,有助於避免使用許多資料列時的效能負面影響。
以內容為基礎的自動調整大小可防止使用者使用滑鼠調整欄寬。 不過,使用者調整大小會在填滿模式中啟用。
這個列舉是由 AutoSizeMode 資料行和 DataGridView.AutoResizeColumn 方法的 和 InheritedAutoSizeMode 屬性所使用。
如需調整模式的詳細資訊,請參閱Windows Forms DataGridView 控制項中的調整大小選項。 如需有關資料行填滿模式的詳細資訊,請參閱DataGridView 控制項Windows Forms中的資料行填滿模式。