DataGridViewColumn.DisplayIndex Properti

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur urutan tampilan kolom relatif terhadap kolom yang saat ini ditampilkan.

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

Nilai Properti

Int32

Posisi kolom berbasis nol seperti yang ditampilkan di , atau -1 terkait jika pita tidak terkandung DataGridViewdalam kontrol.

Atribut: BrowsableAttribute

Pengecualian

ArgumentOutOfRangeException

DataGridView bukan null dan nilai yang ditentukan saat mengatur properti ini kurang dari 0 atau lebih besar dari atau sama dengan jumlah kolom dalam kontrol.

-atau-

DataGridView adalah null dan nilai yang ditentukan saat mengatur properti ini kurang dari -1.

-atau-

Nilai yang ditentukan saat mengatur properti ini sama dengan Int32.MaxValue.

Contoh

Contoh kode berikut menggunakan DisplayIndex properti untuk menukar posisi visual kolom pertama dan terakhir. Perhatikan bahwa penyisipan terjadi sebelum DisplayIndex. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk DataGridViewColumn kelas .

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

Keterangan

Index Tidak seperti properti , DisplayIndex properti sesuai dengan posisi kolom saat ini seperti yang ditampilkan oleh antarmuka pengguna (UI). Secara default, setiap kolom DisplayIndex diatur ke jumlah urutan yang meningkat, yang mencerminkan urutan penambahannya. Nilai Visible properti tidak memengaruhi DisplayIndex nilai. Untuk menentukan posisi tampilan kolom berdasarkan visibilitasnya atau status lainnya, gunakan GetFirstColumnmetode , GetLastColumn, atau GetNextColumn kelas DataGridViewColumnCollection .

Setiap kolom dalam kontrol memiliki nilai yang unik DisplayIndex . Nilai dimulai dengan 0 dan dilanjutkan dalam urutan numerik tanpa melewati nilai apa pun. Saat Anda mengubah DisplayIndex nilai untuk kolom, DisplayIndex nilai untuk kolom lain diubah untuk mencerminkan urutan baru.

Jika kolom memiliki kontrol terkait DataGridView , mengatur properti ini akan menyebabkan kontrol menggambar ulang dirinya sendiri.

Berlaku untuk

Bagikan melalui