DataGridViewColumn.DisplayIndex Свойство

Определение

Возвращает или задает расположение столбца относительно столбцов, отображаемых в текущий момент.Gets or sets the display order of the column relative to the currently displayed columns.

public:
 property int DisplayIndex { int get(); void set(int value); };
[System.ComponentModel.Browsable(false)]
public int DisplayIndex { get; set; }
member this.DisplayIndex : int with get, set
Public Property DisplayIndex As Integer

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

Порядковый номер (с нуля) столбца при его отображении в сопоставленном элементе управления DataGridView или -1, если эта связь не содержится в элементе управления.The zero-based position of the column as it is displayed in the associated DataGridView, or -1 if the band is not contained within a control.

Атрибуты

Исключения

Значением свойства DataGridView не является null, а указанное значение при задании этого свойства меньше нуля или больше количества столбцов в элементе управления.DataGridView is not null and the specified value when setting this property is less than 0 or greater than or equal to the number of columns in the control.

- или --or- Значением свойства DataGridView является null, а указанное значение при задании этого свойства меньше -1.DataGridView is null and the specified value when setting this property is less than -1.

- или --or- Указанное значение при задании этого свойства равно MaxValue.The specified value when setting this property is equal to MaxValue.

Примеры

В следующем примере кода DisplayIndex свойство используется для переключения визуального расположения первого и последнего столбцов.The following code example uses the DisplayIndex property to swap the visual position of the first and last columns. Обратите внимание, что вставки происходят DisplayIndexперед.Note that insertions occur before the DisplayIndex. Этот пример кода является частью большого примера, DataGridViewColumn приведенного для класса.This code example is part of a larger example provided for the DataGridViewColumn class.

// 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 отличие от свойства, свойство соответствует текущему положению столбца в соответствии с отображением пользовательского интерфейса.Unlike the Index property, the DisplayIndex property corresponds to the current position of the column as displayed by the user interface (UI). По умолчанию каждому столбцу DisplayIndex присваивается число возрастающего порядка, что отражает порядок их добавления.By default, each column's DisplayIndex is set to numbers of increasing order, which reflects the order in which they were added. Значение свойства не влияет на DisplayIndexзначение. VisibleThe Visible property value does not affect the DisplayIndex value. Чтобы определить отображаемую позицией столбца на основе его видимости или GetFirstColumnдругого состояния, используйте метод DataGridViewColumnCollection , GetLastColumnили GetNextColumn класса.To determine the display position of a column based on its visibility or other state, use the GetFirstColumn, GetLastColumn, or GetNextColumn method of the DataGridViewColumnCollection class.

Каждый столбец в элементе управления имеет уникальное DisplayIndex значение.Every column in the control has a unique DisplayIndex value. Значения начинаются с 0 и продолжаются в числовом порядке без пропуска каких бы то ни было значений.The values start with 0 and proceed in numerical order without skipping any values. При изменении DisplayIndex значения для столбца DisplayIndex значения других столбцов изменяются в соответствии с новым порядком.When you change the DisplayIndex value for a column, the DisplayIndex values for other columns are changed to reflect the new order.

Если у столбца есть связанный DataGridView элемент управления, установка этого свойства приведет к перерисовки элемента управления.If the column has an associated DataGridView control, setting this property will cause the control to redraw itself.

Применяется к

Дополнительно