DataGridViewColumn.DisplayIndex 屬性

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

取得或設定相對於目前所顯示之資料行的資料行顯示順序。

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

屬性值

Int32

顯示在相關聯 DataGridView 中之資料行的以零起始位置，或是如果群組列並未包含在控制項之內，則為 -1。

屬性
BrowsableAttribute

例外狀況

ArgumentOutOfRangeException

DataGridView 不是 null，而且設定這個屬性時，指定的值小於 0，或是大於或等於控制項中資料行數。

-或-

DataGridView 為 null，而且設定這個屬性時，指定的值小於 -1。

-或-

設定此屬性時指定的值等於 Int32.MaxValue。

範例

下列程式碼範例會 DisplayIndex 使用 屬性來交換第一個和最後一個資料行的視覺位置。 請注意，插入發生在 之前 DisplayIndex 。 此程式碼範例是提供給 類別之較大範例的 DataGridViewColumn 一部分。

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

備註

Index不同于 屬性， DisplayIndex 屬性會對應至使用者介面 (UI 所顯示之資料行的目前位置) 。 根據預設，每個資料行的 DisplayIndex 會設定為遞增順序的數目，以反映其新增的順序。 Visible屬性值不會影響 DisplayIndex 值。 若要根據資料行的可見度或其他狀態來判斷資料行的顯示位置，請使用 GetFirstColumn 類別的 DataGridViewColumnCollection 、 GetLastColumn 或 GetNextColumn 方法。

控制項中的每個資料行都有唯 DisplayIndex 一的值。 值從 0 開始，並以數值順序繼續進行，而不略過任何值。 當您變更資料行的值時 DisplayIndex ， DisplayIndex 其他資料行的值會變更以反映新的順序。

如果資料行有相關聯的 DataGridView 控制項，設定這個屬性會導致控制項重新繪製本身。

適用於

另請參閱