DataGridViewColumn.DisplayIndex Vlastnost

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví pořadí zobrazení sloupce vzhledem k aktuálně zobrazené sloupce.

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

Pozice sloupce od nuly zobrazená v přidruženém DataGridViewobjektu nebo -1, pokud pásmo není obsaženo 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ší než 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 se rovná Int32.MaxValue.

Příklady

Následující příklad kódu používá DisplayIndex vlastnost k prohození pozice vizuálu prvního a posledního sloupce. Všimněte si, že k vložení dochází před .DisplayIndex Tento příklad kódu je součástí většího příkladu DataGridViewColumn pro třídu .

// 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 zobrazené v uživatelském rozhraní (UI). Ve výchozím nastavení je u každého sloupce DisplayIndex nastavená čísla vzestupného pořadí, což odráží pořadí, ve kterém byly sloupce přidány. Hodnota Visible vlastnosti nemá na hodnotu DisplayIndex vliv. Chcete-li určit umístění zobrazení sloupce na základě jeho viditelnosti nebo jiného stavu, použijte metodu GetFirstColumn DataGridViewColumnCollection , GetLastColumnnebo GetNextColumn třídy .

Každý sloupec v ovládacím prvku má jedinečnou DisplayIndex hodnotu. Hodnoty začínají číslem 0 a pokračují v číselném pořadí, aniž by se některé hodnoty přeskakly. 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