DataGridViewBand.Index Właściwość

Definicja

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

Położenie pasm w obiekcie lubDataGridViewColumnCollection, w DataGridViewRowCollection których jest zawarta wartość zero. Wartość domyślna to -1, co oznacza, że nie ma skojarzonej DataGridView kontrolki.

Atrybuty

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

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 kolumn zmieniają DisplayIndex się. Jednak sortowanie wierszy powoduje zmianę ich Index wartości.

Dotyczy

Zobacz też