CheckedListBox 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
顯示 ListBox 一個，每個項目左側會顯示一個勾選框。
public ref class CheckedListBox : System::Windows::Forms::ListBoxpublic class CheckedListBox : System.Windows.Forms.ListBox[System.ComponentModel.LookupBindingProperties]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class CheckedListBox : System.Windows.Forms.ListBox[System.ComponentModel.LookupBindingProperties]
public class CheckedListBox : System.Windows.Forms.ListBoxtype CheckedListBox = class
inherit ListBox[<System.ComponentModel.LookupBindingProperties>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CheckedListBox = class
inherit ListBox[<System.ComponentModel.LookupBindingProperties>]
type CheckedListBox = class
inherit ListBoxPublic Class CheckedListBox
Inherits ListBox- 繼承
- 屬性
範例
以下範例說明如何使用該 CheckedListBox的方法、屬性與集合。 這是一份完整的範例，一旦複製到專案中即可執行。 你可以勾選和取消勾選項目，使用文字框新增項目，點擊儲存按鈕後，清除已勾選項目。
#using <System.Data.dll>
#using <System.Windows.Forms.dll>
#using <System.dll>
#using <System.Drawing.dll>
using namespace System;
using namespace System::Drawing;
using namespace System::Collections;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using namespace System::Data;
using namespace System::IO;
public ref class Form1: public System::Windows::Forms::Form
{
private:
System::Windows::Forms::CheckedListBox^ checkedListBox1;
System::Windows::Forms::TextBox^ textBox1;
System::Windows::Forms::Button^ button1;
System::Windows::Forms::Button^ button2;
System::Windows::Forms::ListBox^ listBox1;
System::Windows::Forms::Button^ button3;
System::ComponentModel::Container^ components;
public:
Form1()
{
InitializeComponent();
// Sets up the initial objects in the CheckedListBox.
array<String^>^myFruit = {"Apples","Oranges","Tomato"};
checkedListBox1->Items->AddRange( myFruit );
// Changes the selection mode from double-click to single click.
checkedListBox1->CheckOnClick = true;
}
public:
~Form1()
{
if ( components != nullptr )
{
delete components;
}
}
private:
void InitializeComponent()
{
this->components = gcnew System::ComponentModel::Container;
this->textBox1 = gcnew System::Windows::Forms::TextBox;
this->checkedListBox1 = gcnew System::Windows::Forms::CheckedListBox;
this->listBox1 = gcnew System::Windows::Forms::ListBox;
this->button1 = gcnew System::Windows::Forms::Button;
this->button2 = gcnew System::Windows::Forms::Button;
this->button3 = gcnew System::Windows::Forms::Button;
this->textBox1->Location = System::Drawing::Point( 144, 64 );
this->textBox1->Size = System::Drawing::Size( 128, 20 );
this->textBox1->TabIndex = 1;
this->textBox1->TextChanged += gcnew System::EventHandler( this, &Form1::textBox1_TextChanged );
this->checkedListBox1->Location = System::Drawing::Point( 16, 64 );
this->checkedListBox1->Size = System::Drawing::Size( 120, 184 );
this->checkedListBox1->TabIndex = 0;
this->checkedListBox1->ItemCheck += gcnew System::Windows::Forms::ItemCheckEventHandler( this, &Form1::checkedListBox1_ItemCheck );
this->listBox1->Location = System::Drawing::Point( 408, 64 );
this->listBox1->Size = System::Drawing::Size( 128, 186 );
this->listBox1->TabIndex = 3;
this->button1->Enabled = false;
this->button1->Location = System::Drawing::Point( 144, 104 );
this->button1->Size = System::Drawing::Size( 104, 32 );
this->button1->TabIndex = 2;
this->button1->Text = "Add Fruit";
this->button1->Click += gcnew System::EventHandler( this, &Form1::button1_Click );
this->button2->Enabled = false;
this->button2->Location = System::Drawing::Point( 288, 64 );
this->button2->Size = System::Drawing::Size( 104, 32 );
this->button2->TabIndex = 2;
this->button2->Text = "Show Order";
this->button2->Click += gcnew System::EventHandler( this, &Form1::button2_Click );
this->button3->Enabled = false;
this->button3->Location = System::Drawing::Point( 288, 104 );
this->button3->Size = System::Drawing::Size( 104, 32 );
this->button3->TabIndex = 2;
this->button3->Text = "Save Order";
this->button3->Click += gcnew System::EventHandler( this, &Form1::button3_Click );
this->ClientSize = System::Drawing::Size( 563, 273 );
array<System::Windows::Forms::Control^>^temp0 = {this->listBox1,this->button3,this->button2,this->button1,this->textBox1,this->checkedListBox1};
this->Controls->AddRange( temp0 );
this->Text = "Fruit Order";
}
// Adds the string if the text box has data in it.
void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
if ( !textBox1->Text->Equals( "" ) )
{
if ( !checkedListBox1->CheckedItems->Contains( textBox1->Text ) )
checkedListBox1->Items->Add( textBox1->Text, CheckState::Checked );
textBox1->Text = "";
}
}
// Activates or deactivates the Add button.
void textBox1_TextChanged( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
if ( textBox1->Text->Equals( "" ) )
{
button1->Enabled = false;
}
else
{
button1->Enabled = true;
}
}
// Moves the checked items from the CheckedListBox to the listBox.
void button2_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
listBox1->Items->Clear();
button3->Enabled = false;
for ( int i = 0; i < checkedListBox1->CheckedItems->Count; i++ )
{
listBox1->Items->Add( checkedListBox1->CheckedItems[ i ] );
}
if ( listBox1->Items->Count > 0 )
button3->Enabled = true;
}
// Activates the move button if there are checked items.
void checkedListBox1_ItemCheck( Object^ /*sender*/, ItemCheckEventArgs^ e )
{
if ( e->NewValue == CheckState::Unchecked )
{
if ( checkedListBox1->CheckedItems->Count == 1 )
{
button2->Enabled = false;
}
}
else
{
button2->Enabled = true;
}
}
// Saves the items to a file.
void button3_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
// Insert code to save a file.
listBox1->Items->Clear();
IEnumerator^ myEnumerator;
myEnumerator = checkedListBox1->CheckedIndices->GetEnumerator();
int y;
while ( myEnumerator->MoveNext() )
{
y = safe_cast<Int32>(myEnumerator->Current);
checkedListBox1->SetItemChecked( y, false );
}
button3->Enabled = false;
}
};
[STAThread]
int main()
{
Application::Run( gcnew Form1 );
}
namespace WindowsApplication1
{
using System;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using System.Windows.Forms;
using System.Data;
using System.IO ;
public class Form1 : System.Windows.Forms.Form
{
private System.Windows.Forms.CheckedListBox checkedListBox1;
private System.Windows.Forms.TextBox textBox1;
private System.Windows.Forms.Button button1;
private System.Windows.Forms.Button button2;
private System.Windows.Forms.ListBox listBox1;
private System.Windows.Forms.Button button3;
private System.ComponentModel.Container components;
public Form1()
{
InitializeComponent();
// Sets up the initial objects in the CheckedListBox.
string[] myFruit = {"Apples", "Oranges","Tomato"};
checkedListBox1.Items.AddRange(myFruit);
// Changes the selection mode from double-click to single click.
checkedListBox1.CheckOnClick = true;
}
protected override void Dispose( bool disposing )
{
if( disposing )
{
if (components != null)
{
components.Dispose();
}
}
base.Dispose( disposing );
}
private void InitializeComponent()
{
this.components = new System.ComponentModel.Container();
this.textBox1 = new System.Windows.Forms.TextBox();
this.checkedListBox1 = new System.Windows.Forms.CheckedListBox();
this.listBox1 = new System.Windows.Forms.ListBox();
this.button1 = new System.Windows.Forms.Button();
this.button2 = new System.Windows.Forms.Button();
this.button3 = new System.Windows.Forms.Button();
this.textBox1.Location = new System.Drawing.Point(144, 64);
this.textBox1.Size = new System.Drawing.Size(128, 20);
this.textBox1.TabIndex = 1;
this.textBox1.TextChanged += new System.EventHandler(this.textBox1_TextChanged);
this.checkedListBox1.Location = new System.Drawing.Point(16, 64);
this.checkedListBox1.Size = new System.Drawing.Size(120, 184);
this.checkedListBox1.TabIndex = 0;
this.checkedListBox1.ItemCheck += new System.Windows.Forms.ItemCheckEventHandler(this.checkedListBox1_ItemCheck);
this.listBox1.Location = new System.Drawing.Point(408, 64);
this.listBox1.Size = new System.Drawing.Size(128, 186);
this.listBox1.TabIndex = 3;
this.button1.Enabled = false;
this.button1.Location = new System.Drawing.Point(144, 104);
this.button1.Size = new System.Drawing.Size(104, 32);
this.button1.TabIndex = 2;
this.button1.Text = "Add Fruit";
this.button1.Click += new System.EventHandler(this.button1_Click);
this.button2.Enabled = false;
this.button2.Location = new System.Drawing.Point(288, 64);
this.button2.Size = new System.Drawing.Size(104, 32);
this.button2.TabIndex = 2;
this.button2.Text = "Show Order";
this.button2.Click += new System.EventHandler(this.button2_Click);
this.button3.Enabled = false;
this.button3.Location = new System.Drawing.Point(288, 104);
this.button3.Size = new System.Drawing.Size(104, 32);
this.button3.TabIndex = 2;
this.button3.Text = "Save Order";
this.button3.Click += new System.EventHandler(this.button3_Click);
this.ClientSize = new System.Drawing.Size(563, 273);
this.Controls.AddRange(new System.Windows.Forms.Control[] {this.listBox1,
this.button3,
this.button2,
this.button1,
this.textBox1,
this.checkedListBox1});
this.Text = "Fruit Order";
}
[STAThread]
public static void Main(string[] args)
{
Application.Run(new Form1());
}
// Adds the string if the text box has data in it.
private void button1_Click(object sender, System.EventArgs e)
{
if(textBox1.Text != "")
{
if(!checkedListBox1.CheckedItems.Contains(textBox1.Text))
checkedListBox1.Items.Add(textBox1.Text,CheckState.Checked);
textBox1.Text = "";
}
}
// Activates or deactivates the Add button.
private void textBox1_TextChanged(object sender, System.EventArgs e)
{
if (textBox1.Text == "")
{
button1.Enabled = false;
}
else
{
button1.Enabled = true;
}
}
// Moves the checked items from the CheckedListBox to the listBox.
private void button2_Click(object sender, System.EventArgs e)
{
listBox1.Items.Clear();
button3.Enabled=false;
for (int i=0; i< checkedListBox1.CheckedItems.Count;i++)
{
listBox1.Items.Add(checkedListBox1.CheckedItems[i]);
}
if (listBox1.Items.Count>0)
button3.Enabled=true;
}
// Activates the move button if there are checked items.
private void checkedListBox1_ItemCheck(object sender, ItemCheckEventArgs e)
{
if(e.NewValue==CheckState.Unchecked)
{
if(checkedListBox1.CheckedItems.Count==1)
{
button2.Enabled = false;
}
}
else
{
button2.Enabled = true;
}
}
// Saves the items to a file.
private void button3_Click(object sender, System.EventArgs e)
{
// Insert code to save a file.
listBox1.Items.Clear();
IEnumerator myEnumerator;
myEnumerator = checkedListBox1.CheckedIndices.GetEnumerator();
int y;
while (myEnumerator.MoveNext())
{
y =(int) myEnumerator.Current;
checkedListBox1.SetItemChecked(y, false);
}
button3.Enabled = false ;
}
}
}
Option Explicit
Option Strict
Imports System.Drawing
Imports System.Collections
Imports System.ComponentModel
Imports System.Windows.Forms
Imports System.Data
Imports System.IO
Namespace WindowsApplication1
Public Class Form1
Inherits System.Windows.Forms.Form
Private WithEvents checkedListBox1 As System.Windows.Forms.CheckedListBox
Private WithEvents textBox1 As System.Windows.Forms.TextBox
Private WithEvents button1 As System.Windows.Forms.Button
Private WithEvents button2 As System.Windows.Forms.Button
Private WithEvents listBox1 As System.Windows.Forms.ListBox
Private WithEvents button3 As System.Windows.Forms.Button
Private components As System.ComponentModel.Container
Public Sub New()
InitializeComponent()
' Sets up the initial objects in the CheckedListBox.
Dim myFruit As String() = {"Apples", "Oranges", "Tomato"}
checkedListBox1.Items.AddRange(myFruit)
' Changes the selection mode from double-click to single click.
checkedListBox1.CheckOnClick = True
End Sub
Protected Overloads Overrides Sub Dispose(ByVal disposing As Boolean)
If disposing Then
If (components IsNot Nothing) Then
components.Dispose()
End If
End If
MyBase.Dispose(disposing)
End Sub
Private Sub InitializeComponent()
Me.components = New System.ComponentModel.Container()
Me.textBox1 = New System.Windows.Forms.TextBox()
Me.checkedListBox1 = New System.Windows.Forms.CheckedListBox()
Me.listBox1 = New System.Windows.Forms.ListBox()
Me.button1 = New System.Windows.Forms.Button()
Me.button2 = New System.Windows.Forms.Button()
Me.button3 = New System.Windows.Forms.Button()
Me.textBox1.Location = New System.Drawing.Point(144, 64)
Me.textBox1.Size = New System.Drawing.Size(128, 20)
Me.textBox1.TabIndex = 1
Me.checkedListBox1.Location = New System.Drawing.Point(16, 64)
Me.checkedListBox1.Size = New System.Drawing.Size(120, 184)
Me.checkedListBox1.TabIndex = 0
Me.listBox1.Location = New System.Drawing.Point(408, 64)
Me.listBox1.Size = New System.Drawing.Size(128, 186)
Me.listBox1.TabIndex = 3
Me.button1.Enabled = False
Me.button1.Location = New System.Drawing.Point(144, 104)
Me.button1.Size = New System.Drawing.Size(104, 32)
Me.button1.TabIndex = 2
Me.button1.Text = "Add Fruit"
Me.button2.Enabled = False
Me.button2.Location = New System.Drawing.Point(288, 64)
Me.button2.Size = New System.Drawing.Size(104, 32)
Me.button2.TabIndex = 2
Me.button2.Text = "Show Order"
Me.button3.Enabled = False
Me.button3.Location = New System.Drawing.Point(288, 104)
Me.button3.Size = New System.Drawing.Size(104, 32)
Me.button3.TabIndex = 2
Me.button3.Text = "Save Order"
Me.ClientSize = New System.Drawing.Size(563, 273)
Me.Controls.AddRange(New System.Windows.Forms.Control() {Me.listBox1, Me.button3, Me.button2, Me.button1, Me.textBox1, Me.checkedListBox1})
Me.Text = "Fruit Order"
End Sub
<STAThread()> _
Public Shared Sub Main()
Application.Run(New Form1())
End Sub
' Adds the string if the text box has data in it.
Private Sub button1_Click(sender As Object, _
e As System.EventArgs) Handles button1.Click
If textBox1.Text <> "" Then
If checkedListBox1.CheckedItems.Contains(textBox1.Text) = False Then
checkedListBox1.Items.Add(textBox1.Text, CheckState.Checked)
End If
textBox1.Text = ""
End If
End Sub
' Activates or deactivates the Add button.
Private Sub textBox1_TextChanged(sender As Object, _
e As System.EventArgs) Handles textBox1.TextChanged
If textBox1.Text = "" Then
button1.Enabled = False
Else
button1.Enabled = True
End If
End Sub
' Moves the checked items from the CheckedListBox to the listBox.
Private Sub button2_Click(sender As Object, _
e As System.EventArgs) Handles button2.Click
listBox1.Items.Clear()
button3.Enabled = False
Dim i As Integer
For i = 0 To checkedListBox1.CheckedItems.Count - 1
listBox1.Items.Add(checkedListBox1.CheckedItems(i))
Next i
If listBox1.Items.Count > 0 Then
button3.Enabled = True
End If
End Sub
' Activates the move button if there are checked items.
Private Sub checkedListBox1_ItemCheck(sender As Object, _
e As ItemCheckEventArgs) Handles checkedListBox1.ItemCheck
If e.NewValue = CheckState.Unchecked Then
If checkedListBox1.CheckedItems.Count = 1 Then
button2.Enabled = False
End If
Else
button2.Enabled = True
End If
End Sub
' Saves the items to a file.
Private Sub button3_Click(sender As Object, _
e As System.EventArgs) Handles button3.Click
' Insert code to save a file.
listBox1.Items.Clear()
For Each index in checkedListBox1.CheckedIndices.Cast(Of Integer).ToArray()
checkedListBox1.SetItemChecked(index, False)
Next
button3.Enabled = False
End Sub
End Class
End Namespace 'WindowsApplication1
備註
此控制項會顯示一個項目清單，使用者可透過鍵盤或右側滾動條來導航。 使用者可以在一個或多個項目旁放置勾選標記，並可用 and CheckedListBox.CheckedIndexCollection來導航CheckedListBox.CheckedItemCollection勾選項目。
執行時要將物件加入清單，請將物件參考陣列與方法一起 AddRange 指派。 清單接著顯示每個物件的預設字串值。 你可以用這個 Add 方法把個別項目加入清單。
CheckedListBox物件透過CheckState枚舉支持三個狀態：Checked、、 IndeterminateUnchecked和 。 你必須在程式碼中設定 狀態 Indeterminate ，因為 的 CheckedListBox 使用者介面沒有提供這樣的機制。
若 UseTabStops 是 true，則 CheckedListBox 會辨識並展開項目文字中的制表字元，建立欄位。 這些制表點是預設的，無法更改。 要使用自訂制表停止，請將 設falseUseTabStops為 ，設UseCustomTabOffsets為 true，並將自訂值加入集合。CustomTabOffsets
備註
若 UseCompatibleTextRendering 屬性為 false， CustomTabOffsets 該屬性將被忽略，並以標準制表偏移取代。
該 CheckedListBox 類別支援以下三個索引集合：
| Collection | 封裝類別 |
|---|---|
| 所有項目都包含在控制中 CheckedListBox 。 | CheckedListBox.ObjectCollection |
| 檢查項目（包括處於不確定狀態的項目），這是控制項中項目 CheckedListBox 的子集。 | CheckedListBox.CheckedItemCollection |
| 檢查索引，這是項目集合索引的子集。 這些索引指定處於檢查狀態或不確定狀態的項目。 | CheckedListBox.CheckedIndexCollection |
以下三個表格是該 CheckedListBox 類別所支援的三個索引集合的範例。
第一個表格提供了控制項中項目的索引集合範例（控制項中包含的所有項目）。
| 指數 | 項目 | 檢查狀態 |
|---|---|---|
| 0 | 物件一 | Unchecked |
| 1 | 物件二 | Checked |
| 2 | 物件3 | Unchecked |
| 3 | 物件4 | Indeterminate |
| 4 | 物件5 | Checked |
第二張表格提供了檢查項目索引集合的範例。
| 指數 | 項目 |
|---|---|
| 0 | 物件二 |
| 1 | 物件4 |
| 2 | 物件5 |
第三張表格提供了已檢查項目索引集合的範例。
| 指數 | 項目索引 |
|---|---|
| 0 | 1 |
| 1 | 3 |
| 2 | 4 |
建構函式
| 名稱 | Description |
|---|---|
| CheckedListBox() |
初始化 CheckedListBox 類別的新執行個體。 |
欄位
| 名稱 | Description |
|---|---|
| DefaultItemHeight |
指定擁有者抽取 ListBox的預設物品高度。 (繼承來源 ListBox) |
| NoMatches |
規定搜尋過程中未找到匹配。 (繼承來源 ListBox) |
屬性
| 名稱 | Description |
|---|---|
| AccessibilityObject |
讓被 AccessibleObject 指派到控制室。 (繼承來源 Control) |
| AccessibleDefaultActionDescription |
取得或設定控制項的預設動作描述，供無障礙客戶端應用程式使用。 (繼承來源 Control) |
| AccessibleDescription |
取得或設定無障礙客戶端應用程式所使用的控制項描述。 (繼承來源 Control) |
| AccessibleName |
取得或設定無障礙客戶端應用程式所使用的控制項名稱。 (繼承來源 Control) |
| AccessibleRole |
取得或設定控制的可及角色。 (繼承來源 Control) |
| AllowDrop |
取得或設定一個值，指示控制器是否能接受使用者拖曳到的資料。 (繼承來源 Control) |
| AllowSelection |
會取得一個值，表示目前 ListBox 是否啟用清單項目的選擇。 (繼承來源 ListBox) |
| Anchor |
取得或設定控制項綁定容器的邊緣，並決定控制項如何與父控制項進行調整大小。 (繼承來源 Control) |
| AutoScrollOffset |
取得或設定，將此控制捲動至。ScrollControlIntoView(Control) (繼承來源 Control) |
| AutoSize |
此性質對此類別無關。 (繼承來源 Control) |
| BackColor |
取得或設定控制點的背景色。 (繼承來源 ListBox) |
| BackgroundImage |
此性質與此類別無關。 (繼承來源 ListBox) |
| BackgroundImageLayout |
取得或設定 的 ListBox 背景影像佈局，依照列舉定義 ImageLayout 。 (繼承來源 ListBox) |
| BindingContext |
取得或設定 BindingContext 控制。 (繼承來源 Control) |
| BorderStyle |
取得或設定圍繞 的邊界 ListBox類型。 (繼承來源 ListBox) |
| Bottom |
取得控制項底部邊緣與容器用戶端區域頂部邊緣之間的距離（像素）。 (繼承來源 Control) |
| Bounds |
取得或設定控制項的大小與位置，包括非用戶端元素，以像素為單位，相對於父控制項。 (繼承來源 Control) |
| CanEnableIme |
會取得一個值，表示該屬性是否 ImeMode 能被設定為主動值，以支援 IME。 (繼承來源 Control) |
| CanFocus |
會獲得一個值，表示控制點是否能獲得焦點。 (繼承來源 Control) |
| CanRaiseEvents |
判斷事件是否能在控制組上引發。 (繼承來源 Control) |
| CanSelect |
會得到一個值，表示是否可以選擇該控制項。 (繼承來源 Control) |
| Capture |
取得或設定一個值，表示控制器是否已捕捉該滑鼠。 (繼承來源 Control) |
| CausesValidation |
取得或設定一個值，指示該控制是否導致在收到焦點時對需要驗證的控制項進行驗證。 (繼承來源 Control) |
| CheckedIndices |
本 CheckedListBox集中檢查過的索引集合。 |
| CheckedItems |
本書中已檢查項目 CheckedListBox的集合。 |
| CheckOnClick |
取得或設定一個值，指示在選取項目時是否應該切換勾選框。 |
| ClientRectangle |
取得代表控制區客戶端區域的矩形。 (繼承來源 Control) |
| ClientSize |
取得或設定控制區客戶區域的高度與寬度。 (繼承來源 Control) |
| ColumnWidth |
取得或設定多欄 ListBox中欄位的寬度。 (繼承來源 ListBox) |
| CompanyName |
取得包含控制權的公司名稱或應用程式的創建者名稱。 (繼承來源 Control) |
| Container |
得到 IContainer 包含 Component的 。 (繼承來源 Component) |
| ContainsFocus |
會獲得一個值，表示該控制項或其子控制項目前是否擁有輸入焦點。 (繼承來源 Control) |
| ContextMenu |
已淘汰.
取得或設定與控制鍵相關的捷徑選單。 (繼承來源 Control) |
| ContextMenuStrip |
取得或設定 ContextMenuStrip 與此控制相關聯的 (繼承來源 Control) |
| Controls |
取得控制中包含的控制項集合。 (繼承來源 Control) |
| Created |
會得到一個值，表示控制是否已被建立。 (繼承來源 Control) |
| CreateParams |
當控制句柄建立時，會取得所需的建立參數。 |
| Cursor |
當滑鼠指標位於控制器上時，會顯示或設定游標。 (繼承來源 Control) |
| CustomTabOffsets |
取得 . 中項目 ListBox之間分頁的寬度。 (繼承來源 ListBox) |
| DataBindings |
取得控制項的資料綁定。 (繼承來源 Control) |
| DataContext |
取得或設定資料上下文以進行資料綁定。 這是一個環境音屬性。 (繼承來源 Control) |
| DataManager |
與 CurrencyManager 這種控制相關。 (繼承來源 ListControl) |
| DataSource |
取得或設定控制系統的資料來源。 |
| DefaultCursor |
取得或設定控制鍵的預設游標。 (繼承來源 Control) |
| DefaultImeMode |
可獲得控制項所支援的預設輸入法編輯器（IME）模式。 (繼承來源 Control) |
| DefaultMargin |
取得預設控制點間設定的像素空間。 (繼承來源 Control) |
| DefaultMaximumSize |
取得控制項預設最大大小的長度與高度（像素數）。 (繼承來源 Control) |
| DefaultMinimumSize |
取得控制項預設最小大小的長度與高度（像素）。 (繼承來源 Control) |
| DefaultPadding |
取得控制項內容的預設內部間距（像素）。 (繼承來源 Control) |
| DefaultSize |
會得到預設大小的控制器。 (繼承來源 ListBox) |
| DesignMode |
會得到一個值，表示目前 Component 是否處於設計模式。 (繼承來源 Component) |
| DeviceDpi |
取得目前顯示控制項所在顯示器的 DPI 值。 (繼承來源 Control) |
| DisplayMember |
取得或設定一個字串，指定你想顯示的清單框中物件的屬性。 |
| DisplayRectangle |
取得代表控制器顯示區域的矩形。 (繼承來源 Control) |
| Disposing |
會取得一個值，表示基底 Control 類別是否正在處理中。 (繼承來源 Control) |
| Dock |
取得或設定哪些控制邊界對接到其父控制，並決定控制點如何與父控制進行調整大小。 (繼承來源 Control) |
| DoubleBuffered |
會取得或設定一個值，指示該控制器是否應該使用次級緩衝區重新繪製表面以減少或防止閃爍。 (繼承來源 Control) |
| DrawMode |
獲得一個值，表示繪製 CheckedListBox元素的模式。 此性質與此類別無關。 |
| Enabled |
取得或設定一個值，表示控制項是否能回應使用者互動。 (繼承來源 Control) |
| Events |
會取得與此 Component連結的事件處理程序清單。 (繼承來源 Component) |
| Focused |
會得到一個值，表示控制器是否有輸入焦點。 (繼承來源 Control) |
| Font |
取得或設定控制項顯示文字的字型。 (繼承來源 ListBox) |
| FontHeight |
取得或設定控制鍵字型的高度。 (繼承來源 Control) |
| ForeColor |
取得或設定控制鍵的前景色。 (繼承來源 ListBox) |
| FormatInfo |
取得或設定 IFormatProvider ，提供自訂格式行為。 (繼承來源 ListControl) |
| FormatString |
取得或設定格式指定字元，指示值如何顯示。 (繼承來源 ListControl) |
| FormattingEnabled |
取得或設定一個值，指示是否對 的ListControl屬性套用DisplayMember格式化。 (繼承來源 ListControl) |
| Handle |
它會得到控制項綁定的視窗把手。 (繼承來源 Control) |
| HasChildren |
會取得一個值，表示該控制是否包含一個或多個子控制項。 (繼承來源 Control) |
| Height |
取得或設定控制點的高度。 (繼承來源 Control) |
| HorizontalExtent |
設定或設定可以讓水平捲動條 ListBox 捲動的寬度。 (繼承來源 ListBox) |
| HorizontalScrollbar |
取得或設定一個值，指示控制鍵中是否顯示水平捲動條。 (繼承來源 ListBox) |
| ImeMode |
取得或設定控制器的輸入法編輯器（IME）模式。 (繼承來源 Control) |
| ImeModeBase |
取得或設定控制的 IME 模式。 (繼承來源 Control) |
| IntegralHeight |
取得或設定一個值，指示控制項是否應該調整大小以避免顯示部分項目。 (繼承來源 ListBox) |
| InvokeRequired |
會獲得一個值，表示呼叫者在呼叫控制項時是否必須呼叫呼叫方法，因為呼叫者使用的執行緒與該控制項建立的執行緒不同。 (繼承來源 Control) |
| IsAccessible |
取得或設定一個值，指示該控制項是否對無障礙應用程式可見。 (繼承來源 Control) |
| IsAncestorSiteInDesignMode |
顯示該控制點的前祖是否被設置在 DesignMode 中。 這個屬性是唯讀的。 (繼承來源 Control) |
| IsDisposed |
會有一個值，表示控制權是否已被處理掉。 (繼承來源 Control) |
| IsHandleCreated |
會得到一個值，表示該控制項是否有與其相關的 handle。 (繼承來源 Control) |
| IsMirrored |
會得到一個值，表示該控制是否為鏡像。 (繼承來源 Control) |
| ItemHeight |
會取得物品區域的高度。 |
| Items |
會獲得這個 CheckedListBox物品的集合。 |
| LayoutEngine |
會取得控制點的佈局引擎的快取實例。 (繼承來源 Control) |
| Left |
取得或設定控制項左邊與容器客戶端區域左邊之間的距離（像素）。 (繼承來源 Control) |
| Location |
取得或設定控制器左上角相對於容器左上角的座標。 (繼承來源 Control) |
| Margin |
取得或設定控制區之間的空格。 (繼承來源 Control) |
| MaximumSize |
取得或設定的上限是可以指定的上限 GetPreferredSize(Size) 。 (繼承來源 Control) |
| MinimumSize |
取得或設定的尺寸是可指定的下限 GetPreferredSize(Size) 。 (繼承來源 Control) |
| MultiColumn |
取得或設定一個值，表示是否 ListBox 支援多欄。 (繼承來源 ListBox) |
| Name |
取得或設定控制的名稱。 (繼承來源 Control) |
| Padding |
在 中 CheckedListBox取得或設定填充。 此性質與此類別無關。 |
| Parent |
取得或設定控制的父容器。 (繼承來源 Control) |
| PreferredHeight |
取得所有項目 ListBox的總高度。 (繼承來源 ListBox) |
| PreferredSize |
大小相當於一個長方形區域，控制器可以放進去。 (繼承來源 Control) |
| ProductName |
取得包含控制項的組件產品名稱。 (繼承來源 Control) |
| ProductVersion |
取得包含控制項的組裝版本。 (繼承來源 Control) |
| RecreatingHandle |
會取得一個值，表示該控制項目前是否正在重新建立其句柄。 (繼承來源 Control) |
| Region |
取得或設定與控制項相關的視窗區域。 (繼承來源 Control) |
| RenderRightToLeft |
已淘汰.
已淘汰.
該物業現已過時。 (繼承來源 Control) |
| ResizeRedraw |
會取得或設定一個值，表示控制項在調整時是否會自行重新繪製。 (繼承來源 Control) |
| Right |
取得控制器右邊與容器用戶端區域左邊之間的距離（像素）。 (繼承來源 Control) |
| RightToLeft |
取得或設定一個值，指示控制器顯示的文字是否從右向左顯示。 (繼承來源 ListBox) |
| ScaleChildren |
會得到一個決定子控制項縮放的值。 (繼承來源 Control) |
| ScrollAlwaysVisible |
會取得或設定一個值，指示垂直捲動條是否隨時顯示。 (繼承來源 ListBox) |
| SelectedIndex |
取得或設定目前選取項目 ListBox的零基索引。 (繼承來源 ListBox) |
| SelectedIndices |
取得一個集合，包含所有目前選取 ListBox項目的零為基礎索引。 (繼承來源 ListBox) |
| SelectedItem |
取得或設定目前選取的項目。ListBox (繼承來源 ListBox) |
| SelectedItems |
會獲得一個包含目前選取項目的集合。ListBox (繼承來源 ListBox) |
| SelectedValue |
取得或設定由 ValueMember 該屬性指定的成員屬性的值。 (繼承來源 ListControl) |
| SelectionMode |
取得或設定一個指定選擇模式的值。 |
| ShowFocusCues |
會得到一個值，指示控制器是否應該顯示焦點矩形。 (繼承來源 Control) |
| ShowKeyboardCues |
會取得一個值，表示使用者介面是否處於顯示或隱藏鍵盤加速器的適當狀態。 (繼承來源 Control) |
| Site |
取得或設定控制點。 (繼承來源 Control) |
| Size |
設定控制器的高度與寬度。 (繼承來源 Control) |
| Sorted |
取得或設定一個值，表示 中的 ListBox 項目是否按字母順序排序。 (繼承來源 ListBox) |
| TabIndex |
取得或設定容器內控制項的制表順序。 (繼承來源 Control) |
| TabStop |
取得或設定一個值，指示使用者是否能使用 TAB 鍵將焦點分配給此控制項。 (繼承來源 Control) |
| Tag |
取得或設定包含控制項資料的物件。 (繼承來源 Control) |
| Text |
取得或搜尋目前選取項目 ListBox的文字。 (繼承來源 ListBox) |
| ThreeDCheckBoxes |
取得或設定一個值，表示勾選框 ButtonState 是否有 或 |
| Top |
取得或設定控制面板頂端與容器用戶端區域頂端之間的距離（以像素為單位）。 (繼承來源 Control) |
| TopIndex |
取得或設定第一個可見項目的 ListBox索引。 (繼承來源 ListBox) |
| TopLevelControl |
取得沒有被其他 Windows Forms 控制項保護的父控制權。 通常，這是控制所包含的最 Form 外層。 (繼承來源 Control) |
| UseCompatibleTextRendering |
取得或設定一個值，決定是使用 Graphics 類別（GDI+）還是 TextRenderer 類別（GDI）來呈現文字。 |
| UseCustomTabOffsets |
會取得或設定一個值，表示在 ListBox 使用整數陣列繪製字串 CustomTabOffsets 時是否能辨識並展開制表字元。 (繼承來源 ListBox) |
| UseTabStops |
取得或設定一個值，表示在 ListBox 繪製字串時是否能辨識並展開制表符字元。 (繼承來源 ListBox) |
| UseWaitCursor |
取得或設定一個值，指示是否使用等待游標來控制目前的控制項及所有子控制項。 (繼承來源 Control) |
| ValueMember |
取得或設定一個字串，指定要從中取值的資料來源屬性。 |
| Visible |
取得或設定一個值，表示該控制項及其所有子控制項是否被顯示。 (繼承來源 Control) |
| Width |
設定或設定控制寬度。 (繼承來源 Control) |
| WindowTarget |
此性質對此類別無關。 (繼承來源 Control) |
方法
事件
| 名稱 | Description |
|---|---|
| AutoSizeChanged |
這個活動與本班無關。 (繼承來源 Control) |
| BackColorChanged |
發生於 BackColor 屬性的值變更時。 (繼承來源 Control) |
| BackgroundImageChanged |
當標籤的性質改變時 BackgroundImage ，會發生這種情況。 (繼承來源 ListBox) |
| BackgroundImageLayoutChanged |
當房產變更時 BackgroundImageLayout 發生。 (繼承來源 ListBox) |
| BindingContextChanged |
發生於 BindingContext 屬性的值變更時。 (繼承來源 Control) |
| CausesValidationChanged |
發生於 CausesValidation 屬性的值變更時。 (繼承來源 Control) |
| ChangeUICues |
當焦點或鍵盤使用者介面（UI）提示改變時，會發生這種情況。 (繼承來源 Control) |
| Click |
當使用者點擊 CheckedListBox 控制鍵時會發生。 |
| 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 發生。 |
| DisplayMemberChanged |
當房產變更時 DisplayMember 發生。 |
| 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 |
當擁有者繪 CheckedListBox 製的視覺元素改變時，會發生這種情況。 這個活動與本課程無關。 |
| 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) |
| ItemCheck |
當項目的檢查狀態改變時，會發生這種情況。 |
| KeyDown |
當按鍵時，控制器處於焦點狀態時會發生。 (繼承來源 Control) |
| KeyPress |
當按鍵在控制鍵處於焦點狀態時，按下字元、空白鍵或退格鍵時會發生。 (繼承來源 Control) |
| KeyUp |
當控制鍵處於對焦狀態時放開鍵時會發生。 (繼承來源 Control) |
| Layout |
當控制項應該重新定位其子控制項時，會發生這種情況。 (繼承來源 Control) |
| Leave |
當輸入焦點離開控制器時會發生。 (繼承來源 Control) |
| LocationChanged |
發生於 Location 屬性值變更時。 (繼承來源 Control) |
| LostFocus |
當控制失焦時會發生。 (繼承來源 Control) |
| MarginChanged |
當對照組的邊界改變時會發生。 (繼承來源 Control) |
| MeasureItem |
當建立擁有者繪製 ListBox 並確定清單項目大小時，會發生這種情況。 這個活動與本課程無關。 |
| MouseCaptureChanged |
當控制組失去滑鼠捕捉時會發生。 (繼承來源 Control) |
| MouseClick |
當使用者用滑鼠點擊 CheckedListBox 控制鍵時會發生。 |
| MouseDoubleClick |
當滑鼠雙擊控制鍵時會發生。 (繼承來源 Control) |
| MouseDown |
當滑鼠指標放在控制器上，按下滑鼠按鈕時會發生。 (繼承來源 Control) |
| MouseEnter |
當滑鼠指標進入控制鍵時會發生。 (繼承來源 Control) |
| MouseHover |
當滑鼠指標放在控制器上時會發生。 (繼承來源 Control) |
| MouseLeave |
當滑鼠指標離開控制鍵時會發生。 (繼承來源 Control) |
| MouseMove |
當滑鼠指標移到控制器上時會發生。 (繼承來源 Control) |
| MouseUp |
當滑鼠指標放在控制器上方並放開滑鼠按鈕時，會發生這種情況。 (繼承來源 Control) |
| MouseWheel |
當滑鼠滾輪移動時，控制器仍保持對焦。 (繼承來源 Control) |
| Move |
當控制桿移動時會發生。 (繼承來源 Control) |
| PaddingChanged |
發生於 Padding 屬性的值變更時。 (繼承來源 ListBox) |
| Paint |
當控制器被塗漆時 ListBox 會發生。 (繼承來源 ListBox) |
| ParentChanged |
當房產價值變動時 Parent 發生。 (繼承來源 Control) |
| PreviewKeyDown |
當按鍵在該控制鍵上時，會發生在事件發生 KeyDown 前。 (繼承來源 Control) |
| QueryAccessibilityHelp |
當 AccessibleObject 提供無障礙應用程式協助時，會發生這種情況。 (繼承來源 Control) |
| QueryContinueDrag |
發生在拖放操作期間，使拖曳源判斷是否應該取消拖放操作。 (繼承來源 Control) |
| RegionChanged |
發生於 Region 屬性的值變更時。 (繼承來源 Control) |
| Resize |
當控制大小被調整時會發生。 (繼承來源 Control) |
| RightToLeftChanged |
當房產價值變動時 RightToLeft 發生。 (繼承來源 Control) |
| SelectedIndexChanged |
當財產或SelectedIndices收藏發生變化時SelectedIndex。 (繼承來源 ListBox) |
| SelectedValueChanged |
當房產變更時 SelectedValue 發生。 (繼承來源 ListControl) |
| SizeChanged |
當房產價值變動時 Size 發生。 (繼承來源 Control) |
| StyleChanged |
當控制風格改變時會發生。 (繼承來源 Control) |
| SystemColorsChanged |
當系統顏色改變時會發生。 (繼承來源 Control) |
| TabIndexChanged |
當房產價值變動時 TabIndex 發生。 (繼承來源 Control) |
| TabStopChanged |
當房產價值變動時 TabStop 發生。 (繼承來源 Control) |
| TextChanged |
當房產變更時 Text 會發生。 (繼承來源 ListBox) |
| Validated |
當控制驗證完成時發生。 (繼承來源 Control) |
| Validating |
當對照組進行驗證時會發生。 (繼承來源 Control) |
| ValueMemberChanged |
當房產變更時 ValueMember 發生。 |
| VisibleChanged |
當房產價值變動時 Visible 發生。 (繼承來源 Control) |
明確介面實作
| 名稱 | Description |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |
