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에 표시되는 열의 위치(0부터 시작)이거나, 열이 컨트롤에 포함되어 있지 않으면 -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 UI(사용자 인터페이스)에 표시되는 열의 현재 위치에 해당합니다. 기본적으로 각 열은 DisplayIndex 추가된 순서를 반영하는 증가하는 순서의 수로 설정됩니다. 속성 값은 Visible 값에 DisplayIndex 영향을 주지 않습니다. 표시 유형 또는 다른 상태에 따라 열의 표시 위치를 확인하려면 클래스의 GetFirstColumn, GetLastColumn또는 GetNextColumn 메서드를 DataGridViewColumnCollection 사용합니다.

컨트롤의 모든 열에는 고유한 DisplayIndex 값이 있습니다. 값은 0으로 시작하고 값을 건너뛰지 않고 숫자 순서로 진행합니다. 열의 DisplayIndex 값을 변경하면 다른 열의 DisplayIndex 값이 새 순서를 반영하도록 변경됩니다.

열에 연결된 DataGridView 컨트롤이 있는 경우 이 속성을 설정하면 컨트롤 자체를 다시 그리게 됩니다.

적용 대상

추가 정보