DataGridViewBand.Index Właściwość

Definicja

Pobiera względną pozycję pasma w kontrolce DataGridView.Gets the relative position of the band within the DataGridView control.

public:
 property int Index { int get(); };
[System.ComponentModel.Browsable(false)]
public int Index { get; }
member this.Index : int
Public ReadOnly Property Index As Integer

Wartość właściwości

Int32

Pozycja od zera pasma w DataGridViewRowCollection lub DataGridViewColumnCollection, w której jest zawarty.The zero-based position of the band in the DataGridViewRowCollection or DataGridViewColumnCollection that it is contained within. Wartość domyślna to-1, co oznacza, że nie ma skojarzonej kontrolki DataGridView.The default is -1, indicating that there is no associated DataGridView control.

Atrybuty

Przykłady

Poniższy przykład kodu używa właściwości Index do ustawiania etykiet kolumn.The following code example uses the Index property to set column labels. Do właściwości Index pasma można uzyskać dostęp za pomocą DataGridViewColumn.The band's Index property is accessed through a DataGridViewColumn.

Uwaga

Jeśli style wizualizacji są włączone, bieżący motyw zastępuje właściwości wyświetlania stylu dla nagłówków wierszy i kolumn.If visual styles are enabled, the current theme overrides the display style properties for row and column headers.

// 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 wizualizacji pasma w kolekcji.The value of this property does not necessarily correspond to the current visual position of the band within the collection. Jeśli na przykład użytkownik zmieni kolejność kolumn w DataGridView w czasie wykonywania (przy założeniu, że właściwość AllowUserToOrderColumns jest ustawiona na true), wartość właściwości Index dla każdej kolumny nie zostanie zmieniona.For example, if the user reorders columns in a DataGridView at run time (assuming the AllowUserToOrderColumns property is set to true), the value of the Index property of each column will not change. Zamiast tego zmieni się wartość kolumny DisplayIndex.Instead, the column DisplayIndex values change. Sortowanie wierszy, jednak zmienia ich wartości Index.Sorting rows, however, does change their Index values.

Dotyczy

Zobacz też