DataGridViewColumnCollection.GetFirstColumn 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

표시 순서에서 지정된 필터 요구 사항을 충족시키는 첫 번째 열을 반환합니다.

오버로드

GetFirstColumn(DataGridViewElementStates)	지정된 포함 필터 요구 사항을 충족시키는 표시 순서의 첫 번째 열을 반환합니다.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	표시 순서에서 지정된 포함 필터 및 제외 필터 요구 사항을 충족시키는 첫 번째 열을 반환합니다.

GetFirstColumn(DataGridViewElementStates)

지정된 포함 필터 요구 사항을 충족시키는 표시 순서의 첫 번째 열을 반환합니다.

public:
 System::Windows::Forms::DataGridViewColumn ^ GetFirstColumn(System::Windows::Forms::DataGridViewElementStates includeFilter);

public System.Windows.Forms.DataGridViewColumn GetFirstColumn (System.Windows.Forms.DataGridViewElementStates includeFilter);

member this.GetFirstColumn : System.Windows.Forms.DataGridViewElementStates -> System.Windows.Forms.DataGridViewColumn

Public Function GetFirstColumn (includeFilter As DataGridViewElementStates) As DataGridViewColumn

매개 변수

includeFilter

DataGridViewElementStates

포함 필터를 나타내는 DataGridViewElementStates 값의 비트 조합입니다.

반환

DataGridViewColumn

표시 순서에서 지정된 필터 요구 사항을 충족시키는 첫 번째 열이고, 이 열이 없으면 null입니다.

예외

ArgumentException

includeFilter 가 DataGridViewElementStates 값의 유효한 비트 조합이 아닙니다.

예제

다음 코드 예제에서는 메서드를 GetFirstColumn 사용하여 표시된 첫 번째 열과 마지막으로 표시된 열을 교환합니다.

// 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

설명

표시 순서의 첫 번째 열은 실제로 화면에 열이 표시되는지 여부에 관계없이 값이 가장 낮은 DisplayIndex 열입니다.

이 메서드를 사용하면 인덱스 값을 직접 비교할 필요 없이 지정된 조건에 맞는 첫 번째 열을 결정할 수 있습니다.

추가 정보

• DataGridView
• DataGridViewColumn
• DisplayIndex
• DataGridViewElementStates

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

표시 순서에서 지정된 포함 필터 및 제외 필터 요구 사항을 충족시키는 첫 번째 열을 반환합니다.

public:
 System::Windows::Forms::DataGridViewColumn ^ GetFirstColumn(System::Windows::Forms::DataGridViewElementStates includeFilter, System::Windows::Forms::DataGridViewElementStates excludeFilter);

public System.Windows.Forms.DataGridViewColumn GetFirstColumn (System.Windows.Forms.DataGridViewElementStates includeFilter, System.Windows.Forms.DataGridViewElementStates excludeFilter);

member this.GetFirstColumn : System.Windows.Forms.DataGridViewElementStates * System.Windows.Forms.DataGridViewElementStates -> System.Windows.Forms.DataGridViewColumn

Public Function GetFirstColumn (includeFilter As DataGridViewElementStates, excludeFilter As DataGridViewElementStates) As DataGridViewColumn

매개 변수

includeFilter

DataGridViewElementStates

포함시키기 위해 적용할 필터를 나타내는 DataGridViewElementStates 값의 비트 조합입니다.

excludeFilter

DataGridViewElementStates

제외시키기 위해 적용할 필터를 나타내는 DataGridViewElementStates 값의 비트 조합입니다.

반환

DataGridViewColumn

표시 순서에서 지정된 필터 요구 사항을 충족시키는 첫 번째 열이고, 이 열이 없으면 null입니다.

예외

ArgumentException

필터 값 중 하나 이상이 DataGridViewElementStates 값의 유효한 비트 조합이 아닌 경우

설명

표시 순서의 첫 번째 열은 실제로 화면에 열이 표시되는지 여부에 관계없이 값이 가장 낮은 DisplayIndex 열입니다.

이 메서드를 사용하면 인덱스 값을 직접 비교할 필요 없이 지정된 조건에 맞는 첫 번째 열을 결정할 수 있습니다.

추가 정보

• DataGridView
• DataGridViewColumn
• DisplayIndex
• DataGridViewElementStates