Język

DataGridViewAutoSizeColumnMode Wyliczenie

Definicja

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

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

Pola

Nazwa Wartość Opis
NotSet 0

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

None 1

Szerokość kolumny nie jest automatycznie dopasowywana.

ColumnHeader 2

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

AllCellsExceptHeader 4

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

AllCells 6

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

DisplayedCellsExceptHeader 8

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

DisplayedCells 10

Szerokość kolumny dopasowuje 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.

Fill 16

Szerokość kolumny dostosowuje się tak, aby szerokość wszystkich kolumn dokładnie wypełniała obszar wyświetlania kontrolki, wymagając 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.

Przykłady

Poniższy przykład kodu ilustruje użycie tej wyliczenia do 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 DataGridView formularzy systemu Windows.

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 jest minimalną szerokością wymaganą do wyświetlenia największej wartości komórki ze wszystkich komórek lub podzestawu komórek w tej kolumnie, takich jak podzbiór komórek, które znajdują się w aktualnie wyświetlanych wierszach. Użycie podzbioru komórek w celu określenia nowej szerokości jest przydatne, aby uniknąć kary za wydajność 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.

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

Aby uzyskać więcej informacji na temat trybów ustalania rozmiaru, zobacz Opcje określania rozmiaru w kontrolce DataGridView formularzy systemu Windows. Aby uzyskać więcej informacji na temat trybu wypełniania kolumny, zobacz Tryb wypełniania kolumn w kontrolce DataGridView formularzy systemu Windows.

Dotyczy

Zobacz też