語言

DataGridViewAutoSizeColumnMode 列舉

定義

定義值,以指定如何調整數據行的寬度。

public enum class DataGridViewAutoSizeColumnMode
public enum DataGridViewAutoSizeColumnMode
type DataGridViewAutoSizeColumnMode = 
Public Enum DataGridViewAutoSizeColumnMode
繼承
DataGridViewAutoSizeColumnMode

欄位

名稱 值 Description
NotSet 0

欄位的尺寸行為是從屬性 AutoSizeColumnsMode 繼承而來的。

None 1

欄位寬度不會自動調整。

ColumnHeader 2

欄位寬度會調整以符合欄位標頭儲存格的內容。

AllCellsExceptHeader 4

欄位寬度會調整以容納欄位中所有儲存格的內容,但不包括標頭儲存格。

AllCells 6

欄寬會調整以容納欄位中所有儲存格的內容,包括標頭儲存格。

DisplayedCellsExceptHeader 8

欄位寬度會調整,以符合目前顯示在螢幕上列中的所有儲存格的內容,但標頭儲存格除外。

DisplayedCells 10

欄位寬度會調整以容納目前顯示在螢幕上的所有欄位中欄位內容,包括標頭單元。

Fill 16

欄位寬度會調整,使所有欄位的寬度恰好填滿控制項的顯示區域,只需水平捲動以保持欄位寬度高於 MinimumWidth 屬性值。 相對欄位寬度由相對 FillWeight 性質值決定。

範例

以下程式碼範例說明使用此枚舉來配置固定寬度欄位。 此範例是《 如何設定 Windows 表單 DataGridView 控制項的大小模式》中更大範例的一部分。

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 欄位的 和 InheritedAutoSizeMode 性質及方法 DataGridView.AutoResizeColumn 。

欲了解更多關於尺寸模式的資訊,請參閱 Windows 表單 DataGridView 控制項中的尺寸選項。 欲了解更多關於欄位填充模式的資訊,請參閱 Windows 表單 DataGridView 控制項中的欄位填充模式。

適用於

另請參閱