DataGridViewColumnCollection.GetFirstColumn Metodo

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Restituisce la prima colonna nell'ordine di visualizzazione che soddisfa i requisiti di filtro specificati.

Overload

Nome	Descrizione
GetFirstColumn(DataGridViewElementStates)	Restituisce la prima colonna nell'ordine di visualizzazione che soddisfa i requisiti di filtro inclusione specificati.
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)	Restituisce la prima colonna nell'ordine di visualizzazione che soddisfa i requisiti di filtro di inclusione e filtro di esclusione specificati.

GetFirstColumn(DataGridViewElementStates)

Origine:: DataGridViewColumnCollection.cs

Origine:: DataGridViewColumnCollection.cs

Origine:: DataGridViewColumnCollection.cs

Origine:: DataGridViewColumnCollection.cs

Origine:: DataGridViewColumnCollection.cs

Restituisce la prima colonna nell'ordine di visualizzazione che soddisfa i requisiti di filtro inclusione specificati.

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

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 DataGridViewElementStates valori che rappresenta il filtro per l'inclusione.

Valori restituiti

DataGridViewColumn

Prima colonna nell'ordine di visualizzazione che soddisfa i requisiti di filtro specificati o null se non viene trovata alcuna colonna.

Eccezioni

ArgumentException

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

Esempio

Nell'esempio di codice seguente viene utilizzato 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 che soddisfa i criteri specificati senza dover confrontare direttamente i valori di indice.

Vedi anche

Si applica a

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Origine:: DataGridViewColumnCollection.cs

Origine:: DataGridViewColumnCollection.cs

Origine:: DataGridViewColumnCollection.cs

Origine:: DataGridViewColumnCollection.cs

Origine:: DataGridViewColumnCollection.cs

Restituisce la prima colonna nell'ordine di visualizzazione che soddisfa i requisiti di filtro di inclusione e filtro di esclusione specificati.

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);

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 DataGridViewElementStates valori che rappresentano il filtro da applicare per l'inclusione.

excludeFilter: DataGridViewElementStates

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