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에 표시되는 열의 위치(0부터 시작)이거나, 열이 컨트롤에 포함되어 있지 않으면 -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.

특성

예외

DataGridViewnull이 아니고 이 속성을 설정할 때 지정된 값이 0보다 작거나 컨트롤의 열 수보다 크거나 같은 경우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- DataGridViewnull이고 이 속성을 설정할 때 지정된 값이 -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 사용자 인터페이스 (UI)에 표시 된 속성은 열의 현재 위치에 해당 합니다.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. 합니다 Visible 속성 값에 영향을 주지 않습니다는 DisplayIndex 값입니다.The Visible property value does not affect the DisplayIndex value. 표시 또는 다른 상태에 따라 열에 표시 되는 위치를 확인 하려면 사용 합니다 GetFirstColumn, GetLastColumn, 또는 GetNextColumn 메서드의 DataGridViewColumnCollection 클래스.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.

적용 대상

추가 정보