DataGridViewColumn.DisplayIndex Özellik

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Sütunun görüntülenme sırasını o anda görüntülenen sütunlara göre alır veya ayarlar.

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

Özellik Değeri

Int32

Sütunun ilişkili DataGridViewiçinde görüntülendiği şekilde sıfır tabanlı konumu veya bir denetim içinde bant yoksa -1.

Öznitelikler: BrowsableAttribute

Özel durumlar

ArgumentOutOfRangeException

DataGridView değil null ve bu özelliği ayarlarken belirtilen değer 0'dan küçük veya denetimdeki sütun sayısından büyük veya buna eşit.

-veya-

DataGridView ve null bu özelliği ayarlarken belirtilen değer -1'den küçüktür.

-veya-

Bu özellik ayarlanırken belirtilen değer Int32.MaxValue değerine eşit.

Örnekler

Aşağıdaki kod örneği, ilk ve son sütunların görsel konumunu değiştirmek için özelliğini kullanır DisplayIndex . Eklemelerin öncesinde gerçekleştiğini DisplayIndexunutmayın. Bu kod örneği, sınıfı için DataGridViewColumn sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

özelliğinden Index farklı olarak özelliği, DisplayIndex kullanıcı arabirimi (UI) tarafından görüntülenen sütunun geçerli konumuna karşılık gelir. Varsayılan olarak, her sütunun DisplayIndex sayısı artan düzende ayarlanır ve bu da eklendikleri sırayı yansıtır. Özellik Visible değeri değeri etkilemez DisplayIndex . Bir sütunun görünürlüğüne veya başka bir durumuna göre görüntüleme konumunu belirlemek için sınıfının , GetLastColumnveya GetNextColumn yöntemini DataGridViewColumnCollection kullanınGetFirstColumn.

Denetimdeki her sütunun benzersiz DisplayIndex bir değeri vardır. Değerler 0 ile başlar ve hiçbir değeri atlamadan sayısal sırada devam eder. Bir sütunun DisplayIndex değerini değiştirdiğinizde, diğer sütunların DisplayIndex değerleri yeni sırayı yansıtacak şekilde değiştirilir.

Sütunda ilişkili DataGridView bir denetim varsa, bu özelliğin ayarlanması denetimin kendisini yeniden çizmesine neden olur.

Şunlara uygulanır