DataGridViewColumn.DisplayIndex Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewColumn.cs

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

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 и указанное значение при настройке этого свойства меньше 0 или больше или равно количеству столбцов в элементе управления.

–или–

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 состояния, используйте GetFirstColumnGetLastColumnметод или GetNextColumn метод класса.

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

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

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

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