DataGridViewColumn.DisplayIndex Egenskap

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll

Hämtar eller anger visningsordningen för kolumnen i förhållande till de kolumner som visas för närvarande.

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

Egenskapsvärde

Int32

Kolumnens nollbaserade position som den visas i den associerade DataGridView, eller -1 om bandet inte finns i en kontroll.

Attribut
BrowsableAttribute

Undantag

ArgumentOutOfRangeException

DataGridView är inte null och det angivna värdet när du anger den här egenskapen är mindre än 0 eller större än eller lika med antalet kolumner i kontrollen.

-eller-

DataGridView är null och det angivna värdet när du anger den här egenskapen är mindre än -1.

-eller-

Det angivna värdet när du anger den här egenskapen är lika med Int32.MaxValue.

Exempel

I följande kodexempel används DisplayIndex egenskapen för att växla den visuella positionen för de första och sista kolumnerna. Observera att infogningar inträffar före DisplayIndex. Det här kodexemplet är en del av ett större exempel för DataGridViewColumn klassen.

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

Kommentarer

Index Till skillnad från egenskapen DisplayIndex motsvarar egenskapen kolumnens aktuella position enligt användargränssnittet (UI). Som standard anges varje kolumns DisplayIndex till antal ökande ordningar, vilket återspeglar i vilken ordning de lades till. Egenskapsvärdet Visible påverkar inte värdet DisplayIndex . Om du vill fastställa visningspositionen för en kolumn baserat på dess synlighet eller andra tillstånd använder du GetFirstColumnGetLastColumn- eller GetNextColumn -metoden för DataGridViewColumnCollection klassen.

Varje kolumn i kontrollen har ett unikt DisplayIndex värde. Värdena börjar med 0 och fortsätter i numerisk ordning utan att hoppa över några värden. När du ändrar DisplayIndex värdet för en kolumn DisplayIndex ändras värdena för andra kolumner för att återspegla den nya ordningen.

Om kolumnen har en associerad DataGridView kontroll kommer inställningen av den här egenskapen att göra så att kontrollen ritar om sig själv.

Gäller för

Se även