ListBox 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表 Windows 的一個控制項，用來顯示一串項目。
public ref class ListBox : System::Windows::Forms::ListControlpublic class ListBox : System.Windows.Forms.ListControl[System.ComponentModel.DefaultBindingProperty("SelectedValue")]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class ListBox : System.Windows.Forms.ListControl[System.ComponentModel.DefaultBindingProperty("SelectedValue")]
public class ListBox : System.Windows.Forms.ListControltype ListBox = class
inherit ListControl[<System.ComponentModel.DefaultBindingProperty("SelectedValue")>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ListBox = class
inherit ListControl[<System.ComponentModel.DefaultBindingProperty("SelectedValue")>]
type ListBox = class
inherit ListControlPublic Class ListBox
Inherits ListControl- 繼承
- 衍生
- 屬性
範例
以下程式碼範例示範如何建立 ListBox 一個控制項，能在欄位中顯示多個項目，且控制項列表中可選擇多個項目。 範例中的程式碼會用Add類別的方法ListBox.ObjectCollection加入 50 個項目ListBox，然後用該SetSelected方法從列表中選擇三個項目。 程式碼接著從集合中，透過SelectedItems屬性，以及ListBox.SelectedIndexCollection透過SelectedIndices屬性顯示 ，然後顯示 ListBox.SelectedObjectCollection 。 此範例要求程式碼位於 ，並從 中呼叫 Form。
void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Create an instance of the ListBox.
ListBox^ listBox1 = gcnew ListBox;
// Set the size and location of the ListBox.
listBox1->Size = System::Drawing::Size( 200, 100 );
listBox1->Location = System::Drawing::Point( 10, 10 );
// Add the ListBox to the form.
this->Controls->Add( listBox1 );
// Set the ListBox to display items in multiple columns.
listBox1->MultiColumn = true;
// Set the selection mode to multiple and extended.
listBox1->SelectionMode = SelectionMode::MultiExtended;
// Shutdown the painting of the ListBox as items are added.
listBox1->BeginUpdate();
// Loop through and add 50 items to the ListBox.
for ( int x = 1; x <= 50; x++ )
{
listBox1->Items->Add( String::Format( "Item {0}", x ) );
}
listBox1->EndUpdate();
// Select three items from the ListBox.
listBox1->SetSelected( 1, true );
listBox1->SetSelected( 3, true );
listBox1->SetSelected( 5, true );
#if defined(DEBUG)
// Display the second selected item in the ListBox to the console.
System::Diagnostics::Debug::WriteLine( listBox1->SelectedItems[ 1 ] );
// Display the index of the first selected item in the ListBox.
System::Diagnostics::Debug::WriteLine( listBox1->SelectedIndices[ 0 ] );
#endif
}
private void button1_Click(object sender, System.EventArgs e)
{
// Create an instance of the ListBox.
ListBox listBox1 = new ListBox();
// Set the size and location of the ListBox.
listBox1.Size = new System.Drawing.Size(200, 100);
listBox1.Location = new System.Drawing.Point(10,10);
// Add the ListBox to the form.
this.Controls.Add(listBox1);
// Set the ListBox to display items in multiple columns.
listBox1.MultiColumn = true;
// Set the selection mode to multiple and extended.
listBox1.SelectionMode = SelectionMode.MultiExtended;
// Shutdown the painting of the ListBox as items are added.
listBox1.BeginUpdate();
// Loop through and add 50 items to the ListBox.
for (int x = 1; x <= 50; x++)
{
listBox1.Items.Add("Item " + x.ToString());
}
// Allow the ListBox to repaint and display the new items.
listBox1.EndUpdate();
// Select three items from the ListBox.
listBox1.SetSelected(1, true);
listBox1.SetSelected(3, true);
listBox1.SetSelected(5, true);
// Display the second selected item in the ListBox to the console.
System.Diagnostics.Debug.WriteLine(listBox1.SelectedItems[1].ToString());
// Display the index of the first selected item in the ListBox.
System.Diagnostics.Debug.WriteLine(listBox1.SelectedIndices[0].ToString());
}
Private Sub button1_Click(sender As Object, e As System.EventArgs)
' Create an instance of the ListBox.
Dim listBox1 As New ListBox()
' Set the size and location of the ListBox.
listBox1.Size = New System.Drawing.Size(200, 100)
listBox1.Location = New System.Drawing.Point(10, 10)
' Add the ListBox to the form.
Me.Controls.Add(listBox1)
' Set the ListBox to display items in multiple columns.
listBox1.MultiColumn = True
' Set the selection mode to multiple and extended.
listBox1.SelectionMode = SelectionMode.MultiExtended
' Shutdown the painting of the ListBox as items are added.
listBox1.BeginUpdate()
' Loop through and add 50 items to the ListBox.
Dim x As Integer
For x = 1 To 50
listBox1.Items.Add("Item " & x.ToString())
Next x
' Allow the ListBox to repaint and display the new items.
listBox1.EndUpdate()
' Select three items from the ListBox.
listBox1.SetSelected(1, True)
listBox1.SetSelected(3, True)
listBox1.SetSelected(5, True)
' Display the second selected item in the ListBox to the console.
System.Diagnostics.Debug.WriteLine(listBox1.SelectedItems(1).ToString())
' Display the index of the first selected item in the ListBox.
System.Diagnostics.Debug.WriteLine(listBox1.SelectedIndices(0).ToString())
End Sub
備註
這個 ListBox 控制項讓你能向使用者顯示一份項目清單，使用者可點擊選擇。 ListBox控制項可利用該SelectionMode屬性提供單一或多個選擇。 同時 ListBox 也提供 MultiColumn 一個特性，使項目能以欄位顯示，而非直列的垂直清單。 這樣，控制項可以顯示更多可見的項目，使用者不再需要捲動到某個項目。
通常，Windows 負責繪製要顯示在 ListBox. 你可以使用這個 DrawMode 屬性，處理 MeasureItem 和 DrawItem 事件，這樣你就能覆蓋 Windows 提供的自動繪圖，自己繪製物品。 你可以使用擁有者繪製 ListBox 的控制項來顯示可變高度的項目、圖片，或是列表中每個項目文字的不同顏色或字型。 該 HorizontalExtent 物業， GetItemHeight也 GetItemRectangle 幫助你繪製自己的物品。
除了顯示與選取功能外，還 ListBox 提供能有效新增項目 ListBox 及在清單中尋找文字的功能。 BeginUpdate和 EndUpdate 方法讓你可以新增大量項目到列表中ListBox，且每次新增項目時控制點都會重新塗裝。 FindString與FindStringExact方法讓你能在列表中搜尋包含特定搜尋字串的項目。
、 ItemsSelectedItems、 和 SelectedIndices 屬性提供了存取三個集合ListBox的存取。 下表概述了 所 ListBox 使用的三個集合及其在控制中的使用。
| 收藏類別 | 在 ListBox |
|---|---|
| ListBox.ObjectCollection | 包含控制中所有項目 ListBox 。 |
| ListBox.SelectedObjectCollection | 包含一組被選中的項目，這些項目是控制項目的子集 ListBox 。 |
| ListBox.SelectedIndexCollection | 包含所選索引的集合，該索引是 的 ListBox.ObjectCollection索引子集。 這些索引會指定被選中的項目。 |
以下三個範例展示了該 ListBox 類別所支援的三個索引集合。
下表展示了如何 ListBox.ObjectCollection 儲存 的 ListBox 項目及其選擇狀態的 ListBox範例。
| 指數 | 項目 | 列表框中的選擇狀態 |
|---|---|---|
| 0 | 物件1 | 未選取 |
| 1 | 物件2 | 已選擇 |
| 2 | 物件3 | 未選取 |
| 3 | 物件4 | 已選擇 |
| 4 | 物件5 | 已選擇 |
根據 ListBox.ObjectCollection 前一表格所示，這張表顯示了 的 ListBox.SelectedObjectCollection 外觀。
| 指數 | 項目 |
|---|---|
| 0 | 物件2 |
| 1 | 物件4 |
| 2 | 物件5 |
根據 ListBox.ObjectCollection 前一表格所示，這張表顯示了 的 ListBox.SelectedIndexCollection 外觀。
| 指數 | 項目索引 |
|---|---|
| 0 | 1 |
| 1 | 3 |
| 2 | 4 |
Add這個類別的方法ListBox.ObjectCollection讓你能在 中加入項目。ListBox 當加入成員到該 ListBox時，該Add方法可接受任何物件。 當物件被加入 ListBox時，控制項會使用物件方法中定義 ToString 的文字，除非物件內的成員名稱在屬性中 DisplayMember 指定。 除了用 Add 類別的方法 ListBox.ObjectCollection 新增項目外，你也可以利用 DataSource 類別的 ListControl 屬性來新增項目。
備註
如果你在基礎 Windows 表單上有 ListBox、 ComboBox、 或 CheckedListBox ，並且想修改這些控制項的字串集合，並修改衍生 Windows 表單中的這些控制項的字串集合，則基礎 Windows 表單中的字串集合必須是空的。 如果字串集合不是空的，當你推導出另一個 Windows 表單時，它們就會變成唯讀。
建構函式
| 名稱 | Description |
|---|---|
| ListBox() |
初始化 ListBox 類別的新執行個體。 |
欄位
| 名稱 | Description |
|---|---|
| DefaultItemHeight |
指定擁有者抽取 ListBox的預設物品高度。 |
| NoMatches |
規定搜尋過程中未找到匹配。 |
屬性
| 名稱 | Description |
|---|---|
| AccessibilityObject |
讓被 AccessibleObject 指派到控制室。 (繼承來源 Control) |
| AccessibleDefaultActionDescription |
取得或設定控制項的預設動作描述，供無障礙客戶端應用程式使用。 (繼承來源 Control) |
| AccessibleDescription |
取得或設定無障礙客戶端應用程式所使用的控制項描述。 (繼承來源 Control) |
| AccessibleName |
取得或設定無障礙客戶端應用程式所使用的控制項名稱。 (繼承來源 Control) |
| AccessibleRole |
取得或設定控制的可及角色。 (繼承來源 Control) |
| AllowDrop |
取得或設定一個值，指示控制器是否能接受使用者拖曳到的資料。 (繼承來源 Control) |
| AllowSelection |
會取得一個值，表示目前 ListBox 是否啟用清單項目的選擇。 |
| Anchor |
取得或設定控制項綁定容器的邊緣，並決定控制項如何與父控制項進行調整大小。 (繼承來源 Control) |
| AutoScrollOffset |
取得或設定，將此控制捲動至。ScrollControlIntoView(Control) (繼承來源 Control) |
| AutoSize |
此性質對此類別無關。 (繼承來源 Control) |
| BackColor |
取得或設定控制點的背景色。 |
| BackgroundImage |
此性質與此類別無關。 |
| BackgroundImageLayout |
取得或設定 的 ListBox 背景影像佈局，依照列舉定義 ImageLayout 。 |
| BindingContext |
取得或設定 BindingContext 控制。 (繼承來源 Control) |
| BorderStyle |
取得或設定圍繞 的邊界 ListBox類型。 |
| Bottom |
取得控制項底部邊緣與容器用戶端區域頂部邊緣之間的距離（像素）。 (繼承來源 Control) |
| Bounds |
取得或設定控制項的大小與位置，包括非用戶端元素，以像素為單位，相對於父控制項。 (繼承來源 Control) |
| CanEnableIme |
會取得一個值，表示該屬性是否 ImeMode 能被設定為主動值，以支援 IME。 (繼承來源 Control) |
| CanFocus |
會獲得一個值，表示控制點是否能獲得焦點。 (繼承來源 Control) |
| CanRaiseEvents |
判斷事件是否能在控制組上引發。 (繼承來源 Control) |
| CanSelect |
會得到一個值，表示是否可以選擇該控制項。 (繼承來源 Control) |
| Capture |
取得或設定一個值，表示控制器是否已捕捉該滑鼠。 (繼承來源 Control) |
| CausesValidation |
取得或設定一個值，指示該控制是否導致在收到焦點時對需要驗證的控制項進行驗證。 (繼承來源 Control) |
| ClientRectangle |
取得代表控制區客戶端區域的矩形。 (繼承來源 Control) |
| ClientSize |
取得或設定控制區客戶區域的高度與寬度。 (繼承來源 Control) |
| ColumnWidth |
取得或設定多欄 ListBox中欄位的寬度。 |
| CompanyName |
取得包含控制權的公司名稱或應用程式的創建者名稱。 (繼承來源 Control) |
| Container |
得到 IContainer 包含 Component的 。 (繼承來源 Component) |
| ContainsFocus |
會獲得一個值，表示該控制項或其子控制項目前是否擁有輸入焦點。 (繼承來源 Control) |
| ContextMenu |
已淘汰.
取得或設定與控制鍵相關的捷徑選單。 (繼承來源 Control) |
| ContextMenuStrip |
取得或設定 ContextMenuStrip 與此控制相關聯的 (繼承來源 Control) |
| Controls |
取得控制中包含的控制項集合。 (繼承來源 Control) |
| Created |
會得到一個值，表示控制是否已被建立。 (繼承來源 Control) |
| CreateParams |
當控制句柄建立時，會取得所需的建立參數。 |
| Cursor |
當滑鼠指標位於控制器上時，會顯示或設定游標。 (繼承來源 Control) |
| CustomTabOffsets |
取得 . 中項目 ListBox之間分頁的寬度。 |
| DataBindings |
取得控制項的資料綁定。 (繼承來源 Control) |
| DataContext |
取得或設定資料上下文以進行資料綁定。 這是一個環境音屬性。 (繼承來源 Control) |
| DataManager |
與 CurrencyManager 這種控制相關。 (繼承來源 ListControl) |
| DataSource |
取得或設定此 ListControl資料來源。 (繼承來源 ListControl) |
| DefaultCursor |
取得或設定控制鍵的預設游標。 (繼承來源 Control) |
| DefaultImeMode |
可獲得控制項所支援的預設輸入法編輯器（IME）模式。 (繼承來源 Control) |
| DefaultMargin |
取得預設控制點間設定的像素空間。 (繼承來源 Control) |
| DefaultMaximumSize |
取得控制項預設最大大小的長度與高度（像素數）。 (繼承來源 Control) |
| DefaultMinimumSize |
取得控制項預設最小大小的長度與高度（像素）。 (繼承來源 Control) |
| DefaultPadding |
取得控制項內容的預設內部間距（像素）。 (繼承來源 Control) |
| DefaultSize |
會得到預設大小的控制器。 |
| DesignMode |
會得到一個值，表示目前 Component 是否處於設計模式。 (繼承來源 Component) |
| DeviceDpi |
取得目前顯示控制項所在顯示器的 DPI 值。 (繼承來源 Control) |
| DisplayMember |
取得或設定屬性以顯示此 ListControl。 (繼承來源 ListControl) |
| DisplayRectangle |
取得代表控制器顯示區域的矩形。 (繼承來源 Control) |
| Disposing |
會取得一個值，表示基底 Control 類別是否正在處理中。 (繼承來源 Control) |
| Dock |
取得或設定哪些控制邊界對接到其父控制，並決定控制點如何與父控制進行調整大小。 (繼承來源 Control) |
| DoubleBuffered |
會取得或設定一個值，指示該控制器是否應該使用次級緩衝區重新繪製表面以減少或防止閃爍。 (繼承來源 Control) |
| DrawMode |
取得或設定控制的繪圖模式。 |
| Enabled |
取得或設定一個值，表示控制項是否能回應使用者互動。 (繼承來源 Control) |
| Events |
會取得與此 Component連結的事件處理程序清單。 (繼承來源 Component) |
| Focused |
會得到一個值，表示控制器是否有輸入焦點。 (繼承來源 Control) |
| Font |
取得或設定控制項顯示文字的字型。 |
| Font |
取得或設定控制項顯示文字的字型。 (繼承來源 Control) |
| FontHeight |
取得或設定控制鍵字型的高度。 (繼承來源 Control) |
| ForeColor |
取得或設定控制鍵的前景色。 |
| FormatInfo |
取得或設定 IFormatProvider ，提供自訂格式行為。 (繼承來源 ListControl) |
| FormatString |
取得或設定格式指定字元，指示值如何顯示。 (繼承來源 ListControl) |
| FormattingEnabled |
取得或設定一個值，指示是否對 的ListControl屬性套用DisplayMember格式化。 (繼承來源 ListControl) |
| Handle |
它會得到控制項綁定的視窗把手。 (繼承來源 Control) |
| HasChildren |
會取得一個值，表示該控制是否包含一個或多個子控制項。 (繼承來源 Control) |
| Height |
取得或設定控制點的高度。 (繼承來源 Control) |
| HorizontalExtent |
設定或設定可以讓水平捲動條 ListBox 捲動的寬度。 |
| HorizontalScrollbar |
取得或設定一個值，指示控制鍵中是否顯示水平捲動條。 |
| ImeMode |
取得或設定控制器的輸入法編輯器（IME）模式。 (繼承來源 Control) |
| ImeModeBase |
取得或設定控制的 IME 模式。 (繼承來源 Control) |
| IntegralHeight |
取得或設定一個值，指示控制項是否應該調整大小以避免顯示部分項目。 |
| InvokeRequired |
會獲得一個值，表示呼叫者在呼叫控制項時是否必須呼叫呼叫方法，因為呼叫者使用的執行緒與該控制項建立的執行緒不同。 (繼承來源 Control) |
| IsAccessible |
取得或設定一個值，指示該控制項是否對無障礙應用程式可見。 (繼承來源 Control) |
| IsAncestorSiteInDesignMode |
顯示該控制點的前祖是否被設置在 DesignMode 中。 這個屬性是唯讀的。 (繼承來源 Control) |
| IsDisposed |
會有一個值，表示控制權是否已被處理掉。 (繼承來源 Control) |
| IsHandleCreated |
會得到一個值，表示該控制項是否有與其相關的 handle。 (繼承來源 Control) |
| IsMirrored |
會得到一個值，表示該控制是否為鏡像。 (繼承來源 Control) |
| ItemHeight |
取得或設定 中 ListBox某個項目的高度。 |
| Items |
取得 的項目 ListBox。 |
| LayoutEngine |
會取得控制點的佈局引擎的快取實例。 (繼承來源 Control) |
| Left |
取得或設定控制項左邊與容器客戶端區域左邊之間的距離（像素）。 (繼承來源 Control) |
| Location |
取得或設定控制器左上角相對於容器左上角的座標。 (繼承來源 Control) |
| Margin |
取得或設定控制區之間的空格。 (繼承來源 Control) |
| MaximumSize |
取得或設定的上限是可以指定的上限 GetPreferredSize(Size) 。 (繼承來源 Control) |
| MinimumSize |
取得或設定的尺寸是可指定的下限 GetPreferredSize(Size) 。 (繼承來源 Control) |
| MultiColumn |
取得或設定一個值，表示是否 ListBox 支援多欄。 |
| Name |
取得或設定控制的名稱。 (繼承來源 Control) |
| Padding |
此性質與此類別無關。 |
| Parent |
取得或設定控制的父容器。 (繼承來源 Control) |
| PreferredHeight |
取得所有項目 ListBox的總高度。 |
| PreferredSize |
大小相當於一個長方形區域，控制器可以放進去。 (繼承來源 Control) |
| ProductName |
取得包含控制項的組件產品名稱。 (繼承來源 Control) |
| ProductVersion |
取得包含控制項的組裝版本。 (繼承來源 Control) |
| RecreatingHandle |
會取得一個值，表示該控制項目前是否正在重新建立其句柄。 (繼承來源 Control) |
| Region |
取得或設定與控制項相關的視窗區域。 (繼承來源 Control) |
| RenderRightToLeft |
已淘汰.
已淘汰.
該物業現已過時。 (繼承來源 Control) |
| ResizeRedraw |
會取得或設定一個值，表示控制項在調整時是否會自行重新繪製。 (繼承來源 Control) |
| Right |
取得控制器右邊與容器用戶端區域左邊之間的距離（像素）。 (繼承來源 Control) |
| RightToLeft |
取得或設定一個值，指示控制器顯示的文字是否從右向左顯示。 |
| RightToLeft |
取得或設定一個值，指示 control 元素是否對齊以支援使用右至左字型的區域。 (繼承來源 Control) |
| ScaleChildren |
會得到一個決定子控制項縮放的值。 (繼承來源 Control) |
| ScrollAlwaysVisible |
會取得或設定一個值，指示垂直捲動條是否隨時顯示。 |
| SelectedIndex |
取得或設定目前選取項目 ListBox的零基索引。 |
| SelectedIndices |
取得一個集合，包含所有目前選取 ListBox項目的零為基礎索引。 |
| SelectedItem |
取得或設定目前選取的項目。ListBox |
| SelectedItems |
會獲得一個包含目前選取項目的集合。ListBox |
| SelectedValue |
取得或設定由 ValueMember 該屬性指定的成員屬性的值。 (繼承來源 ListControl) |
| SelectionMode |
取得或設定在 中選取 ListBox項目的方法。 |
| ShowFocusCues |
會得到一個值，指示控制器是否應該顯示焦點矩形。 (繼承來源 Control) |
| ShowKeyboardCues |
會取得一個值，表示使用者介面是否處於顯示或隱藏鍵盤加速器的適當狀態。 (繼承來源 Control) |
| Site |
取得或設定控制點。 (繼承來源 Control) |
| Size |
設定控制器的高度與寬度。 (繼承來源 Control) |
| Sorted |
取得或設定一個值，表示 中的 ListBox 項目是否按字母順序排序。 |
| TabIndex |
取得或設定容器內控制項的制表順序。 (繼承來源 Control) |
| TabStop |
取得或設定一個值，指示使用者是否能使用 TAB 鍵將焦點分配給此控制項。 (繼承來源 Control) |
| Tag |
取得或設定包含控制項資料的物件。 (繼承來源 Control) |
| Text |
取得或搜尋目前選取項目 ListBox的文字。 |
| Top |
取得或設定控制面板頂端與容器用戶端區域頂端之間的距離（以像素為單位）。 (繼承來源 Control) |
| TopIndex |
取得或設定第一個可見項目的 ListBox索引。 |
| TopLevelControl |
取得沒有被其他 Windows Forms 控制項保護的父控制權。 通常，這是控制所包含的最 Form 外層。 (繼承來源 Control) |
| UseCustomTabOffsets |
會取得或設定一個值，表示在 ListBox 使用整數陣列繪製字串 CustomTabOffsets 時是否能辨識並展開制表字元。 |
| UseTabStops |
取得或設定一個值，表示在 ListBox 繪製字串時是否能辨識並展開制表符字元。 |
| UseWaitCursor |
取得或設定一個值，指示是否使用等待游標來控制目前的控制項及所有子控制項。 (繼承來源 Control) |
| ValueMember |
取得或設定屬性的路徑，作為 中項目 ListControl的實際值。 (繼承來源 ListControl) |
| Visible |
取得或設定一個值，表示該控制項及其所有子控制項是否被顯示。 (繼承來源 Control) |
| Width |
設定或設定控制寬度。 (繼承來源 Control) |
| WindowTarget |
此性質對此類別無關。 (繼承來源 Control) |
方法
事件
| 名稱 | Description |
|---|---|
| AutoSizeChanged |
這個活動與本班無關。 (繼承來源 Control) |
| BackColorChanged |
發生於 BackColor 屬性的值變更時。 (繼承來源 Control) |
| BackgroundImageChanged |
當標籤的性質改變時 BackgroundImage ，會發生這種情況。 |
| BackgroundImageLayoutChanged |
當房產變更時 BackgroundImageLayout 發生。 |
| BindingContextChanged |
發生於 BindingContext 屬性的值變更時。 (繼承來源 Control) |
| CausesValidationChanged |
發生於 CausesValidation 屬性的值變更時。 (繼承來源 Control) |
| ChangeUICues |
當焦點或鍵盤使用者介面（UI）提示改變時，會發生這種情況。 (繼承來源 Control) |
| Click |
當按下控制器時 ListBox 會發生。 |
| ClientSizeChanged |
發生於 ClientSize 屬性的值變更時。 (繼承來源 Control) |
| ContextMenuChanged |
已淘汰.
發生於 ContextMenu 屬性的值變更時。 (繼承來源 Control) |
| ContextMenuStripChanged |
發生於 ContextMenuStrip 屬性的值變更時。 (繼承來源 Control) |
| ControlAdded |
當新增控制項加入 Control.ControlCollection時，會發生。 (繼承來源 Control) |
| ControlRemoved |
當控制項從 中移除 Control.ControlCollection時發生。 (繼承來源 Control) |
| CursorChanged |
發生於 Cursor 屬性的值變更時。 (繼承來源 Control) |
| DataContextChanged |
發生於 DataContext 屬性的值變更時。 (繼承來源 Control) |
| DataSourceChanged |
發生在變化 DataSource 時。 (繼承來源 ListControl) |
| DisplayMemberChanged |
當房產變更時 DisplayMember 發生。 (繼承來源 ListControl) |
| Disposed |
當元件被呼叫方法 Dispose() 時會發生。 (繼承來源 Component) |
| DockChanged |
發生於 Dock 屬性的值變更時。 (繼承來源 Control) |
| DoubleClick |
當雙擊按鈕時會發生。 (繼承來源 Control) |
| DpiChangedAfterParent |
當控制器的 DPI 設定在父控制器或表單的 DPI 改變後，程式方式更改時會發生。 (繼承來源 Control) |
| DpiChangedBeforeParent |
當控制器的 DPI 設定在父控制器或表單的 DPI 變更事件尚未發生之前，程式化地更改時就會發生。 (繼承來源 Control) |
| DragDrop |
當拖放操作完成時會發生。 (繼承來源 Control) |
| DragEnter |
當物體被拖入控制範圍時，會發生這種情況。 (繼承來源 Control) |
| DragLeave |
當物體被拖出控制範圍時，會發生這種情況。 (繼承來源 Control) |
| DragOver |
當物體被拖過控制範圍時會發生。 (繼承來源 Control) |
| DrawItem |
當擁有者繪 ListBox 製的視覺元素改變時，會發生這種情況。 |
| EnabledChanged |
發生於 Enabled 屬性值變更時。 (繼承來源 Control) |
| Enter |
當進入控制區時發生。 (繼承來源 Control) |
| FontChanged |
當房產價值變動時 Font 發生。 (繼承來源 Control) |
| ForeColorChanged |
當房產價值變動時 ForeColor 發生。 (繼承來源 Control) |
| Format |
當控制項綁定到資料值時，會發生這種情況。 (繼承來源 ListControl) |
| FormatInfoChanged |
發生於 FormatInfo 屬性的值變更時。 (繼承來源 ListControl) |
| FormatStringChanged |
當房產價值 FormatString 變動時，會發生這種情況。 (繼承來源 ListControl) |
| FormattingEnabledChanged |
發生於 FormattingEnabled 屬性的值變更時。 (繼承來源 ListControl) |
| GiveFeedback |
發生在拖曳操作期間。 (繼承來源 Control) |
| GotFocus |
當控制裝置被聚焦時發生。 (繼承來源 Control) |
| HandleCreated |
當控制器被建立把柄時，會發生這種情況。 (繼承來源 Control) |
| HandleDestroyed |
當控制器的把手正在被摧毀時，會發生這種情況。 (繼承來源 Control) |
| HelpRequested |
當使用者請求控制權協助時會發生。 (繼承來源 Control) |
| ImeModeChanged |
當房產發生變化時 ImeMode 。 (繼承來源 Control) |
| Invalidated |
當控制器顯示需要重新繪製時，會發生這種情況。 (繼承來源 Control) |
| KeyDown |
當按鍵時，控制器處於焦點狀態時會發生。 (繼承來源 Control) |
| KeyPress |
當按鍵在控制鍵處於焦點狀態時，按下字元、空白鍵或退格鍵時會發生。 (繼承來源 Control) |
| KeyUp |
當控制鍵處於對焦狀態時放開鍵時會發生。 (繼承來源 Control) |
| Layout |
當控制項應該重新定位其子控制項時，會發生這種情況。 (繼承來源 Control) |
| Leave |
當輸入焦點離開控制器時會發生。 (繼承來源 Control) |
| LocationChanged |
發生於 Location 屬性值變更時。 (繼承來源 Control) |
| LostFocus |
當控制失焦時會發生。 (繼承來源 Control) |
| MarginChanged |
當對照組的邊界改變時會發生。 (繼承來源 Control) |
| MeasureItem |
當建立擁有者繪製 ListBox 並確定清單項目大小時，會發生這種情況。 |
| MouseCaptureChanged |
當控制組失去滑鼠捕捉時會發生。 (繼承來源 Control) |
| MouseClick |
當使用者用滑鼠指標點擊 ListBox 控制鍵時，會發生這種情況。 |
| MouseDoubleClick |
當滑鼠雙擊控制鍵時會發生。 (繼承來源 Control) |
| MouseDown |
當滑鼠指標放在控制器上，按下滑鼠按鈕時會發生。 (繼承來源 Control) |
| MouseEnter |
當滑鼠指標進入控制鍵時會發生。 (繼承來源 Control) |
| MouseHover |
當滑鼠指標放在控制器上時會發生。 (繼承來源 Control) |
| MouseLeave |
當滑鼠指標離開控制鍵時會發生。 (繼承來源 Control) |
| MouseMove |
當滑鼠指標移到控制器上時會發生。 (繼承來源 Control) |
| MouseUp |
當滑鼠指標放在控制器上方並放開滑鼠按鈕時，會發生這種情況。 (繼承來源 Control) |
| MouseWheel |
當滑鼠滾輪移動時，控制器仍保持對焦。 (繼承來源 Control) |
| Move |
當控制桿移動時會發生。 (繼承來源 Control) |
| PaddingChanged |
發生於 Padding 屬性的值變更時。 |
| Paint |
當控制器被塗漆時 ListBox 會發生。 |
| ParentChanged |
當房產價值變動時 Parent 發生。 (繼承來源 Control) |
| PreviewKeyDown |
當按鍵在該控制鍵上時，會發生在事件發生 KeyDown 前。 (繼承來源 Control) |
| QueryAccessibilityHelp |
當 AccessibleObject 提供無障礙應用程式協助時，會發生這種情況。 (繼承來源 Control) |
| QueryContinueDrag |
發生在拖放操作期間，使拖曳源判斷是否應該取消拖放操作。 (繼承來源 Control) |
| RegionChanged |
發生於 Region 屬性的值變更時。 (繼承來源 Control) |
| Resize |
當控制大小被調整時會發生。 (繼承來源 Control) |
| RightToLeftChanged |
當房產價值變動時 RightToLeft 發生。 (繼承來源 Control) |
| SelectedIndexChanged |
當財產或SelectedIndices收藏發生變化時SelectedIndex。 |
| SelectedValueChanged |
當房產變更時 SelectedValue 發生。 (繼承來源 ListControl) |
| SizeChanged |
當房產價值變動時 Size 發生。 (繼承來源 Control) |
| StyleChanged |
當控制風格改變時會發生。 (繼承來源 Control) |
| SystemColorsChanged |
當系統顏色改變時會發生。 (繼承來源 Control) |
| TabIndexChanged |
當房產價值變動時 TabIndex 發生。 (繼承來源 Control) |
| TabStopChanged |
當房產價值變動時 TabStop 發生。 (繼承來源 Control) |
| TextChanged |
當房產變更時 Text 會發生。 |
| Validated |
當控制驗證完成時發生。 (繼承來源 Control) |
| Validating |
當對照組進行驗證時會發生。 (繼承來源 Control) |
| ValueMemberChanged |
當房產變更時 ValueMember 發生。 (繼承來源 ListControl) |
| VisibleChanged |
當房產價值變動時 Visible 發生。 (繼承來源 Control) |
明確介面實作
| 名稱 | Description |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |
