DataGridViewColumnCollection.GetFirstColumn 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
回傳符合特定篩選條件的顯示順序的第一欄。
多載
| 名稱 | Description |
|---|---|
| GetFirstColumn(DataGridViewElementStates) |
回傳符合包含過濾器要求的顯示順序的第一欄。 |
| GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates) |
回傳符合包含過濾器與排除過濾器要求的第一欄，並依顯示順序排列。 |
GetFirstColumn(DataGridViewElementStates)
回傳符合包含過濾器要求的顯示順序的第一欄。
public:
System::Windows::Forms::DataGridViewColumn ^ GetFirstColumn(System::Windows::Forms::DataGridViewElementStates includeFilter);public System.Windows.Forms.DataGridViewColumn GetFirstColumn(System.Windows.Forms.DataGridViewElementStates includeFilter);public System.Windows.Forms.DataGridViewColumn? GetFirstColumn(System.Windows.Forms.DataGridViewElementStates includeFilter);member this.GetFirstColumn : System.Windows.Forms.DataGridViewElementStates -> System.Windows.Forms.DataGridViewColumnPublic Function GetFirstColumn (includeFilter As DataGridViewElementStates) As DataGridViewColumn參數
- includeFilter
- DataGridViewElementStates
一個位元組合 DataGridViewElementStates 的值，代表包含的濾波器。
傳回
顯示順序中符合特定篩選條件的第一欄，或 null 若找不到欄位。
例外狀況
includeFilter 不是有效的位元組合 DataGridViewElementStates 。
範例
以下程式碼範例使用 GetFirstColumn 了交換第一個顯示欄位與最後一個顯示欄位的方法。
// 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
備註
顯示順序的第一欄是值最低 DisplayIndex 的欄位，無論該欄位是否實際在螢幕上可見。
此方法讓您能在不直接比較索引值的情況下，確定第一欄符合指定條件。
另請參閱
適用於
GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)
回傳符合包含過濾器與排除過濾器要求的第一欄，並依顯示順序排列。
public:
System::Windows::Forms::DataGridViewColumn ^ GetFirstColumn(System::Windows::Forms::DataGridViewElementStates includeFilter, System::Windows::Forms::DataGridViewElementStates excludeFilter);public System.Windows.Forms.DataGridViewColumn GetFirstColumn(System.Windows.Forms.DataGridViewElementStates includeFilter, System.Windows.Forms.DataGridViewElementStates excludeFilter);public System.Windows.Forms.DataGridViewColumn? GetFirstColumn(System.Windows.Forms.DataGridViewElementStates includeFilter, System.Windows.Forms.DataGridViewElementStates excludeFilter);member this.GetFirstColumn : System.Windows.Forms.DataGridViewElementStates * System.Windows.Forms.DataGridViewElementStates -> System.Windows.Forms.DataGridViewColumnPublic Function GetFirstColumn (includeFilter As DataGridViewElementStates, excludeFilter As DataGridViewElementStates) As DataGridViewColumn參數
- includeFilter
- DataGridViewElementStates
一個位元組合，將 DataGridViewElementStates 代表該濾波器的值組成，以應用於包含範圍。
- excludeFilter
- DataGridViewElementStates
將代表濾波器的值逐位組合 DataGridViewElementStates ，應用排除。
傳回
顯示順序中符合特定篩選條件的第一欄，或 null 若找不到欄位。
例外狀況
至少有一個濾波器值並非有效的位元組合 DataGridViewElementStates 。
備註
顯示順序的第一欄是值最低 DisplayIndex 的欄位，無論該欄位是否實際在螢幕上可見。
此方法讓您能在不直接比較索引值的情況下，確定第一欄符合指定條件。
