Sdílet prostřednictvím

DataGridViewColumn.DisplayIndex Vlastnost

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll
Zdroj:
DataGridViewColumn.cs
Zdroj:
DataGridViewColumn.cs
Zdroj:
DataGridViewColumn.cs
Zdroj:
DataGridViewColumn.cs
Zdroj:
DataGridViewColumn.cs

Získá nebo nastaví pořadí zobrazení sloupce vzhledem k aktuálně zobrazeným sloupcům.

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

Hodnota vlastnosti

Int32

Umístění sloupce založeného na nule, jak je zobrazeno v přidruženém DataGridViewobjektu , nebo -1, pokud pás není obsažen v ovládacím prvku.

Atributy
BrowsableAttribute

Výjimky

ArgumentOutOfRangeException

DataGridView není null a zadaná hodnota při nastavení této vlastnosti je menší než 0 nebo větší nebo rovna počtu sloupců v ovládacím prvku.

nebo

DataGridView je null a zadaná hodnota při nastavení této vlastnosti je menší než -1.

nebo

Zadaná hodnota při nastavení této vlastnosti je rovna Int32.MaxValue.

Příklady

Následující příklad kódu používá DisplayIndex vlastnost pro prohození vizuální pozice prvních a posledních sloupců. Všimněte si, že vložení probíhá před .DisplayIndex Tento příklad kódu je součástí většího příkladu uvedeného pro třídu DataGridViewColumn.

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

Poznámky

Index Na rozdíl od vlastnosti DisplayIndex odpovídá vlastnost aktuální pozici sloupce, jak je zobrazeno v uživatelském rozhraní. Ve výchozím nastavení je počet sloupců DisplayIndex nastavený na čísla vzestupného pořadí, což odráží pořadí, ve kterém byly přidány. Hodnota Visible vlastnosti nemá vliv na DisplayIndex hodnotu. Chcete-li určit umístění zobrazení sloupce na základě jeho viditelnosti nebo jiného stavu, použijte GetFirstColumn, GetLastColumnnebo GetNextColumn metodu DataGridViewColumnCollection třídy.

Každý sloupec v ovládacím prvku má jedinečnou DisplayIndex hodnotu. Hodnoty začínají hodnotou 0 a pokračujte v číselném pořadí bez vynechání hodnot. Když změníte DisplayIndex hodnotu sloupce, změní se hodnoty pro ostatní sloupce tak, DisplayIndex aby odrážely nové pořadí.

Pokud má sloupec přidružený DataGridView ovládací prvek, nastavení této vlastnosti způsobí překreslení ovládacího prvku.

Platí pro

Viz také