DataGridViewBand.Index Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Źródło:

DataGridViewBand.cs

Pobiera względną pozycję pasma w kontrolce DataGridView .

public:
 property int Index { int get(); };

[System.ComponentModel.Browsable(false)]
public int Index { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Index : int

Public ReadOnly Property Index As Integer

Wartość właściwości

Int32

Położenie na podstawie zera przedziału w DataGridViewRowCollection obiekcie lub DataGridViewColumnCollection , w których znajduje się. Wartość domyślna to -1 wskazująca, że nie ma skojarzonej DataGridView kontrolki.

Atrybuty

BrowsableAttribute

Przykłady

Poniższy przykład kodu używa Index właściwości do ustawiania etykiet kolumn. Dostęp do właściwości zespołu Index jest uzyskiwany za pośrednictwem obiektu DataGridViewColumn.

Uwaga / Notatka

Jeśli style wizualizacji są włączone, bieżący motyw zastępuje właściwości stylu wyświetlania nagłówków wierszy i kolumn.

// Style and number columns.
void Button8_Click( Object^ /*sender*/, EventArgs^ /*args*/ )
{
   DataGridViewCellStyle^ style = gcnew DataGridViewCellStyle;
   style->Alignment = DataGridViewContentAlignment::MiddleCenter;
   style->ForeColor = Color::IndianRed;
   style->BackColor = Color::Ivory;
   IEnumerator^ myEnum1 = dataGridView->Columns->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      DataGridViewColumn^ column = safe_cast<DataGridViewColumn^>(myEnum1->Current);
      column->HeaderCell->Value = column->Index.ToString();
      column->HeaderCell->Style = style;
   }
}

// Style and number columns.
private void Button8_Click(object sender,
    EventArgs args)
{
    DataGridViewCellStyle style = new DataGridViewCellStyle();
    style.Alignment =
        DataGridViewContentAlignment.MiddleCenter;
    style.ForeColor = Color.IndianRed;
    style.BackColor = Color.Ivory;

    foreach (DataGridViewColumn column in dataGridView.Columns)
    {
        column.HeaderCell.Value = column.Index.ToString();
        column.HeaderCell.Style = style;
    }
}

' Style and number columns.
Private Sub Button8_Click(ByVal sender As Object, _
    ByVal args As EventArgs) Handles Button8.Click

    Dim style As DataGridViewCellStyle = _
        New DataGridViewCellStyle()
    style.Alignment = _
        DataGridViewContentAlignment.MiddleCenter
    style.ForeColor = Color.IndianRed
    style.BackColor = Color.Ivory

    For Each column As DataGridViewColumn _
        In dataGridView.Columns

        column.HeaderCell.Value = _
            column.Index.ToString
        column.HeaderCell.Style = style
    Next
End Sub

Uwagi

Wartość tej właściwości nie musi odpowiadać bieżącej pozycji wizualnej pasma w kolekcji. Jeśli na przykład użytkownik zmienia kolejność kolumn w DataGridView czasie wykonywania (przy założeniu AllowUserToOrderColumns , że właściwość jest ustawiona na true), wartość Index właściwości każdej kolumny nie ulegnie zmianie. Zamiast tego wartości kolumny DisplayIndex zmieniają się. Jednak sortowanie wierszy powoduje zmianę ich Index wartości.

Zobacz też

• DataGridView
• DataGridViewRowCollection
• DataGridViewColumnCollection
• AllowUserToOrderColumns