DataGridViewColumn.DisplayIndex Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает расположение столбца относительно столбцов, отображаемых в текущий момент.

public:
 property int DisplayIndex { int get(); void set(int value); };

[System.ComponentModel.Browsable(false)]
public int DisplayIndex { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.DisplayIndex : int with get, set

Public Property DisplayIndex As Integer

Значение свойства

Int32

Порядковый номер (с нуля) столбца при его отображении в сопоставленном элементе управления DataGridView или -1, если эта связь не содержится в элементе управления.

Атрибуты

BrowsableAttribute

Исключения

ArgumentOutOfRangeException

Значением свойства DataGridView не является null, а указанное значение при задании этого свойства меньше нуля или больше количества столбцов в элементе управления.

-или-

Значением свойства DataGridView является null, а указанное значение при задании этого свойства меньше -1.

-или-

Указанное значение при задании этого свойства равно Int32.MaxValue.

Примеры

В следующем примере кода свойство используется для DisplayIndex замены визуальной позиции первого и последнего столбцов. Обратите внимание, что вставки происходят перед DisplayIndex. Этот пример входит в состав более крупного примера использования класса DataGridViewColumn.

// Swap the last column with the first.
void Button10_Click( Object^ /*sender*/, EventArgs^ /*args*/ )
{
   DataGridViewColumnCollection^ columnCollection = dataGridView->Columns;
   DataGridViewColumn^ firstDisplayedColumn = columnCollection->GetFirstColumn( DataGridViewElementStates::Visible );
   DataGridViewColumn^ lastDisplayedColumn = columnCollection->GetLastColumn( DataGridViewElementStates::Visible, DataGridViewElementStates::None );
   int firstColumn_sIndex = firstDisplayedColumn->DisplayIndex;
   firstDisplayedColumn->DisplayIndex = lastDisplayedColumn->DisplayIndex;
   lastDisplayedColumn->DisplayIndex = firstColumn_sIndex;
}

// Swap the last column with the first.
private void Button10_Click(object sender, EventArgs args)
{
    DataGridViewColumnCollection columnCollection = dataGridView.Columns;

    DataGridViewColumn firstVisibleColumn =
        columnCollection.GetFirstColumn(DataGridViewElementStates.Visible);
    DataGridViewColumn lastVisibleColumn =
        columnCollection.GetLastColumn(
            DataGridViewElementStates.Visible, DataGridViewElementStates.None);

    int firstColumn_sIndex = firstVisibleColumn.DisplayIndex;
    firstVisibleColumn.DisplayIndex = lastVisibleColumn.DisplayIndex;
    lastVisibleColumn.DisplayIndex = firstColumn_sIndex;
}

' Swap the last column with the first.
Private Sub Button10_Click(ByVal sender As Object, _
    ByVal args As EventArgs) Handles Button10.Click

    Dim columnCollection As DataGridViewColumnCollection = _
        dataGridView.Columns

    Dim firstVisibleColumn As DataGridViewColumn = _
        columnCollection.GetFirstColumn(DataGridViewElementStates.Visible)
    Dim lastVisibleColumn As DataGridViewColumn = _
        columnCollection.GetLastColumn(DataGridViewElementStates.Visible, _
        Nothing)

    Dim firstColumn_sIndex As Integer = firstVisibleColumn.DisplayIndex
    firstVisibleColumn.DisplayIndex = _
        lastVisibleColumn.DisplayIndex
    lastVisibleColumn.DisplayIndex = firstColumn_sIndex
End Sub

Комментарии

Index В отличие от свойства, DisplayIndex свойство соответствует текущему положению столбца, отображаемому в пользовательском интерфейсе. По умолчанию для каждого столбца DisplayIndex задано число возрастающего порядка, отражающего порядок их добавления. Значение Visible свойства не влияет на DisplayIndex значение. Чтобы определить позицию отображения столбца на основе его видимости или другого DataGridViewColumnCollection состояния, используйте GetFirstColumnметод , GetLastColumnили GetNextColumn класса .

Каждый столбец в элементе управления имеет уникальное DisplayIndex значение. Значения начинаются с 0 и продолжаются в числовом порядке, не пропуская значения. При изменении DisplayIndex значения столбца DisplayIndex значения для других столбцов изменяются в соответствии с новым порядком.

Если столбец имеет связанный DataGridView элемент управления, установка этого свойства приведет к перерисовки самого элемента управления.

См. также раздел

• DataGridView
• Index
• GetFirstColumn
• GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)
• GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)
• DataGridViewColumnCollection