Udostępnij za pośrednictwem

DataGridViewColumn.DisplayIndex Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

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

Zobacz też