DataGridViewColumnCollection.GetFirstColumn Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Restituisce la prima colonna in ordine di visualizzazione che risponde ai requisiti di filtro specificati.

Overload

GetFirstColumn(DataGridViewElementStates)

Restituisce la prima colonna in ordine di visualizzazione che risponde ai requisiti di filtro specificati per l'inclusione.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Restituisce la prima colonna in ordine di visualizzazione che risponde ai requisiti di filtro specificati per l'inclusione e l'esclusione.

GetFirstColumn(DataGridViewElementStates)

Restituisce la prima colonna in ordine di visualizzazione che risponde ai requisiti di filtro specificati per l'inclusione.

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

Parametri

includeFilter
DataGridViewElementStates

Combinazione bit per bit dei valori di DataGridViewElementStates che rappresenta il filtro per l'inclusione.

Restituisce

DataGridViewColumn

La prima colonna in ordine di visualizzazione che risponde ai requisiti di filtro specificati o null se non viene trovata alcuna colonna.

Eccezioni

ArgumentException

includeFilter non è una combinazione bit per bit valida di valori di DataGridViewElementStates.

Esempio

Nell'esempio di codice seguente viene usato il GetFirstColumn metodo per scambiare la prima colonna visualizzata e l'ultima colonna visualizzata.

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

Commenti

La prima colonna nell'ordine di visualizzazione è la colonna con il valore più basso DisplayIndex , indipendentemente dal fatto che la colonna sia effettivamente visibile sullo schermo.

Questo metodo consente di determinare la prima colonna adatta ai criteri specificati senza dover confrontare direttamente i valori di indice.

Vedi anche

Si applica a

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Restituisce la prima colonna in ordine di visualizzazione che risponde ai requisiti di filtro specificati per l'inclusione e l'esclusione.

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

Parametri

includeFilter
DataGridViewElementStates

Combinazione bit per bit dei valori di DataGridViewElementStates che rappresenta il filtro da applicare per l'inclusione.

excludeFilter
DataGridViewElementStates

Combinazione bit per bit dei valori di DataGridViewElementStates che rappresenta il filtro da applicare per l'esclusione.

Restituisce

DataGridViewColumn

La prima colonna in ordine di visualizzazione che risponde ai requisiti di filtro specificati o null se non viene trovata alcuna colonna.

Eccezioni

ArgumentException

Almeno uno dei valori di filtro non è una combinazione bit per bit valida di valori DataGridViewElementStates.

Commenti

La prima colonna nell'ordine di visualizzazione è la colonna con il valore più basso DisplayIndex , indipendentemente dal fatto che la colonna sia effettivamente visibile sullo schermo.

Questo metodo consente di determinare la prima colonna adatta ai criteri specificati senza dover confrontare direttamente i valori di indice.

Vedi anche

Si applica a