DataGridViewColumnCollection.GetFirstColumn DataGridViewColumnCollection.GetFirstColumn DataGridViewColumnCollection.GetFirstColumn DataGridViewColumnCollection.GetFirstColumn Method

정의

표시 순서에서 지정된 필터 요구 사항을 충족시키는 첫 번째 열을 반환합니다.Returns the first column in display order that meets the given filter requirements.

오버로드

GetFirstColumn(DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates)

지정된 포함 필터 요구 사항을 충족시키는 표시 순서의 첫 번째 열을 반환합니다.Returns the first column in display order that meets the given inclusion-filter requirements.

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

표시 순서에서 지정된 포함 필터 및 제외 필터 요구 사항을 충족시키는 첫 번째 열을 반환합니다.Returns the first column in display order that meets the given inclusion-filter and exclusion-filter requirements.

GetFirstColumn(DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates)

지정된 포함 필터 요구 사항을 충족시키는 표시 순서의 첫 번째 열을 반환합니다.Returns the first column in display order that meets the given inclusion-filter requirements.

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

포함 필터를 나타내는 DataGridViewElementStates 값의 비트 조합입니다.A bitwise combination of the DataGridViewElementStates values that represents the filter for inclusion.

반환

표시 순서에서 지정된 필터 요구 사항을 충족시키는 첫 번째 열이고, 이 열이 없으면 null입니다.The first column in display order that meets the given filter requirements, or null if no column is found.

예외

includeFilterDataGridViewElementStates 값의 유효한 비트 조합이 아닌 경우includeFilter is not a valid bitwise combination of DataGridViewElementStates values.

예제

다음 코드 예제에서는 GetFirstColumn 첫 번째 표시 된 열과 마지막 표시 된 열을 교환 하는 방법입니다.The following code example uses the GetFirstColumn method to swap the first displayed column and the last displayed column.

// 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 열이 화면에 실제로 표시 되는지 여부에 관계 없이 값입니다.The first column in display order is the column with the lowest DisplayIndex value, regardless of whether the column is actually visible on the screen.

이 메서드를 사용 하면 인덱스 값을 직접 비교할 필요 없이 지정된 된 조건에 맞는 첫 번째 열을 확인할 수 있습니다.This method lets you determine the first column that fits the given criteria without having to compare index values directly.

추가 정보

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates) GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

표시 순서에서 지정된 포함 필터 및 제외 필터 요구 사항을 충족시키는 첫 번째 열을 반환합니다.Returns the first column in display order that meets the given inclusion-filter and exclusion-filter requirements.

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

포함시키기 위해 적용할 필터를 나타내는 DataGridViewElementStates 값의 비트 조합입니다.A bitwise combination of the DataGridViewElementStates values that represent the filter to apply for inclusion.

excludeFilter
DataGridViewElementStates DataGridViewElementStates DataGridViewElementStates DataGridViewElementStates

제외시키기 위해 적용할 필터를 나타내는 DataGridViewElementStates 값의 비트 조합입니다.A bitwise combination of the DataGridViewElementStates values that represent the filter to apply for exclusion.

반환

표시 순서에서 지정된 필터 요구 사항을 충족시키는 첫 번째 열이고, 이 열이 없으면 null입니다.The first column in display order that meets the given filter requirements, or null if no column is found.

예외

필터 값 중 하나 이상이 DataGridViewElementStates 값의 유효한 비트 조합이 아닌 경우At least one of the filter values is not a valid bitwise combination of DataGridViewElementStates values.

설명

표시 순서에서 첫 번째 열은 가장 낮은 열 DisplayIndex 열이 화면에 실제로 표시 되는지 여부에 관계 없이 값입니다.The first column in display order is the column with the lowest DisplayIndex value, regardless of whether the column is actually visible on the screen.

이 메서드를 사용 하면 인덱스 값을 직접 비교할 필요 없이 지정된 된 조건에 맞는 첫 번째 열을 확인할 수 있습니다.This method lets you determine the first column that fits the given criteria without having to compare index values directly.

추가 정보

적용 대상