DataGridViewColumn.DisplayIndex Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia kolejność wyświetlania kolumny względem aktualnie wyświetlanych kolumn.

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

Wartość właściwości

Int32

Położenie kolumny opartej na zera, jak jest wyświetlane w skojarzonym DataGridViewobiekcie lub -1, jeśli pasm nie jest zawarty w kontrolce.

Atrybuty: BrowsableAttribute

Wyjątki

ArgumentOutOfRangeException

DataGridView nie null jest i określona wartość podczas ustawiania tej właściwości jest mniejsza niż 0 lub większa lub równa liczbie kolumn w kontrolce.

-lub-

DataGridView to null i określona wartość podczas ustawiania tej właściwości jest mniejsza niż -1.

-lub-

Określona wartość podczas ustawiania tej właściwości jest równa Int32.MaxValue.

Przykłady

Poniższy przykład kodu używa DisplayIndex właściwości do zamiany pozycji wizualnej pierwszych i ostatnich kolumn. Należy pamiętać, że wstawiania występują przed elementem DisplayIndex. Ten przykład kodu jest częścią większego przykładu podanego DataGridViewColumn dla klasy.

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

Uwagi

Index W przeciwieństwie do właściwości właściwość DisplayIndex odpowiada bieżącej pozycji kolumny wyświetlanej przez interfejs użytkownika. Domyślnie każda kolumna DisplayIndex jest ustawiona na liczbę rosnącej kolejności, co odzwierciedla kolejność, w której zostały dodane. Wartość Visible właściwości nie ma wpływu na DisplayIndex wartość. Aby określić położenie wyświetlania kolumny na podstawie jego widoczności lub innego stanu, użyj GetFirstColumnmetody DataGridViewColumnCollection , GetLastColumnlub GetNextColumn klasy .

Każda kolumna w kontrolce ma unikatową DisplayIndex wartość. Wartości zaczynają się od 0 i kontynuuj w kolejności liczbowej bez pomijania żadnych wartości. Po zmianie DisplayIndex wartości kolumny DisplayIndex wartości dla innych kolumn zostaną zmienione, aby odzwierciedlić nową kolejność.

Jeśli kolumna ma skojarzona DataGridView kontrolkę, ustawienie tej właściwości spowoduje ponowne rysowanie kontrolki.

Dotyczy