DataGridViewAutoSizeColumnsMode Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет значения для указания способа регулирования ширины столбцов.
public enum class DataGridViewAutoSizeColumnsModepublic enum DataGridViewAutoSizeColumnsModetype DataGridViewAutoSizeColumnsMode = Public Enum DataGridViewAutoSizeColumnsMode- Наследование
Поля
| Имя | Значение | Описание |
|---|---|---|
| AllCells | 6 | Ширина столбцов изменяется так, чтобы вместить содержимое всех ячеек столбцов, включая ячейки заголовков. |
| AllCellsExceptHeader | 4 | Ширина столбцов изменяется так, чтобы вместить содержимое всех ячеек столбцов, исключая ячейки заголовков. |
| ColumnHeader | 2 | Ширина столбцов изменяется так, чтобы вместить содержимое ячеек заголовков столбцов. |
| DisplayedCells | 10 | Ширина столбцов изменяется так, чтобы вместить содержимое всех ячеек столбцов, которые находятся в строках, отображающихся на экране в настоящий момент, включая ячейки заголовков. |
| DisplayedCellsExceptHeader | 8 | Ширина столбцов изменяется так, чтобы вместить содержимое всех ячеек столбцов, которые находятся в строках, отображающихся на экране в настоящий момент, исключая ячейки заголовков. |
| Fill | 16 | Ширина столбцов подбирается таким образом, чтобы суммарная ширина всех столбцов в точности заполняла отображаемую область элемента управления, а прокрутка по горизонтали требовалась только для того, чтобы не допускать уменьшения ширины столбцов ниже значений свойства MinimumWidth. Относительная ширина столбцов определяется относительными значениями свойства FillWeight. |
| None | 1 | Значения ширины столбцов не изменяются автоматически. |
Примеры
В следующем примере кода показано использование этого перечисления в сценарии "главный/подробный", где два DataGridView элемента управления отображают данные из двух таблиц в отношениях "родители-потомки". В этом примере для главного элемента управления используется режим изменения размера столбца None, а ширина столбцов инициализируется программным способом в соответствии с загруженными значениями. Элемент управления сведениями устанавливается в режим автоматического изменения размера, чтобы столбцы автоматически изменялись при каждом изменении значений (например, когда пользователь изменяет текущую строку в родительской таблице). Этот пример является частью более крупного примера, доступного в разделе How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls.
private void Form1_Load(object sender, System.EventArgs e)
{
// Bind the DataGridView controls to the BindingSource
// components and load the data from the database.
masterDataGridView.DataSource = masterBindingSource;
detailsDataGridView.DataSource = detailsBindingSource;
GetData();
// Resize the master DataGridView columns to fit the newly loaded data.
masterDataGridView.AutoResizeColumns();
// Configure the details DataGridView so that its columns automatically
// adjust their widths when the data changes.
detailsDataGridView.AutoSizeColumnsMode =
DataGridViewAutoSizeColumnsMode.AllCells;
}
Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
Handles Me.Load
' Bind the DataGridView controls to the BindingSource
' components and load the data from the database.
masterDataGridView.DataSource = masterBindingSource
detailsDataGridView.DataSource = detailsBindingSource
GetData()
' Resize the master DataGridView columns to fit the newly loaded data.
masterDataGridView.AutoResizeColumns()
' Configure the details DataGridView so that its columns automatically
' adjust their widths when the data changes.
detailsDataGridView.AutoSizeColumnsMode = _
DataGridViewAutoSizeColumnsMode.AllCells
End Sub
Комментарии
Элемент DataGridView управления может изменять размер своих столбцов, чтобы они заполняли доступную горизонтальную ширину элемента управления или отображали полное содержимое всех ячеек или указанных ячеек.
В Fill режиме предпочтительная ширина столбца определяется путем изменения размера всех столбцов в этом режиме, чтобы все видимые столбцы в элементе управления точно заполняли горизонтальную ширину доступной области отображения. В других режимах предпочтительной шириной столбца является минимальная ширина, необходимая для отображения наибольшего значения ячейки из всех ячеек или подмножества ячеек в этом столбце, например подмножества ячеек, которые находятся в текущих строках. Использование подмножества ячеек для определения новой ширины полезно, чтобы избежать снижения производительности при работе с большим количеством строк данных.
Автоматическое изменение размера на основе содержимого запрещает пользователям настраивать ширину столбцов с помощью мыши. Однако изменение размера пользователя включено в режиме заполнения.
Это перечисление используется свойством DataGridView элемента управления AutoSizeColumnsMode и AutoResizeColumns методом .
Дополнительные сведения о режимах изменения размера см. в разделе Параметры изменения размера элемента управления Windows Forms DataGridView. Дополнительные сведения о режиме заполнения столбцов см. в разделе Режим заполнения столбцов в Windows Forms элемента управления DataGridView.
