DataGridViewAutoSizeColumnMode Wyliczenie

Definicja

Definiuje wartości określające, w jaki sposób szerokość kolumny jest dostosowywana.

public enum class DataGridViewAutoSizeColumnMode
public enum DataGridViewAutoSizeColumnMode
type DataGridViewAutoSizeColumnMode = 
Public Enum DataGridViewAutoSizeColumnMode
Dziedziczenie
DataGridViewAutoSizeColumnMode

Pola

AllCells 6

Szerokość kolumny dostosowuje się do zawartości wszystkich komórek w kolumnie, w tym komórki nagłówka.

AllCellsExceptHeader 4

Szerokość kolumny dostosowuje się do zawartości wszystkich komórek w kolumnie, z wyłączeniem komórki nagłówka.

ColumnHeader 2

Szerokość kolumny dostosowuje się do zawartości komórki nagłówka kolumny.

DisplayedCells 10

Szerokość kolumny dostosowuje się do zawartości wszystkich komórek w kolumnie, które znajdują się w wierszach aktualnie wyświetlanych na ekranie, w tym komórki nagłówka.

DisplayedCellsExceptHeader 8

Szerokość kolumny dostosowuje się do zawartości wszystkich komórek w kolumnie, które są obecnie wyświetlane na ekranie wierszy, z wyłączeniem komórki nagłówka.

Fill 16

Szerokość kolumny dostosowuje się tak, aby szerokość wszystkich kolumn dokładnie wypełniała obszar wyświetlania kontrolki, co wymaga przewijania poziomego tylko w celu zachowania szerokości kolumn powyżej MinimumWidth wartości właściwości. Względne szerokości kolumn są określane przez względne FillWeight wartości właściwości.

None 1

Szerokość kolumny nie dostosowuje się automatycznie.

NotSet 0

Zachowanie ustalania rozmiaru kolumny jest dziedziczone z AutoSizeColumnsMode właściwości.

Przykłady

Poniższy przykład kodu ilustruje użycie tej wyliczenia w celu skonfigurowania kolumny o stałej szerokości. Ten przykład jest częścią większego przykładu dostępnego w temacie Instrukcje: ustawianie trybów określania rozmiaru kontrolki Windows Forms 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

Uwagi

Kontrolka DataGridView może zmienić rozmiar kolumn, aby wypełnić dostępną szerokość poziomą kontrolki lub wyświetlić pełną zawartość wszystkich komórek lub określonych komórek.

W trybie wypełniania preferowana szerokość kolumny jest określana przez zmianę rozmiaru wszystkich kolumn w tym trybie, aby wszystkie widoczne kolumny w kontrolce dokładnie wypełniały poziomą szerokość dostępnego obszaru wyświetlania. W przypadku innych trybów preferowana szerokość kolumny to minimalna szerokość wymagana do wyświetlenia największej wartości komórki ze wszystkich komórek lub podzbioru komórek w tej kolumnie, na przykład podzestaw komórek, które znajdują się w aktualnie wyświetlanych wierszach. Używanie podzestawu komórek do określenia nowej szerokości jest przydatne, aby uniknąć kary wydajności podczas pracy z wieloma wierszami danych.

Automatyczna zmiana rozmiaru oparta na zawartości uniemożliwia użytkownikom dostosowywanie szerokości kolumn za pomocą myszy. Zmiana rozmiaru użytkownika jest jednak włączona w trybie wypełniania.

Ta wyliczenie jest używana przez AutoSizeMode właściwości i InheritedAutoSizeMode kolumn i metody DataGridView.AutoResizeColumn .

Aby uzyskać więcej informacji na temat trybów określania rozmiaru, zobacz Opcje określania rozmiaru w kontrolce dataGridView Windows Forms. Aby uzyskać więcej informacji na temat trybu wypełniania kolumn w szczególności, zobacz Tryb wypełniania kolumn w kontrolce DataGridView Windows Forms.

Dotyczy

Zobacz też