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 ) == false )
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() != false )
{
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)== false)
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() != false)
{
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
備註
此控制項會顯示使用者可以使用控制項右側的鍵盤或捲軸來流覽的專案清單。 使用者可以將核取記號放在一或多個專案，而且可以使用 和 CheckedListBox.CheckedIndexCollection 來巡覽 CheckedListBox.CheckedItemCollection 核取的專案。
若要在執行時間將物件新增至清單，請使用 AddRange 方法指派物件參考陣列。 然後清單會顯示每個物件的預設字串值。 您可以使用 方法，將個別專案新增至清單 Add 。
物件 CheckedListBox 透過 CheckState 列舉支援三種狀態： Checked 、 Indeterminate 和 Unchecked 。 您必須在程式碼中設定 的狀態 Indeterminate ，因為 的使用者 CheckedListBox 介面不提供執行此動作的機制。
如果 UseTabStops 為 true ，則會 CheckedListBox 辨識並展開專案文字中的索引標籤字元，並建立資料行。 這些定位停駐點是預設的，而且無法變更。 若要使用自訂定位停駐點，請將 設定 UseTabStopsUseCustomTabOffsets 為 falsetrue ，並將自訂值新增至 CustomTabOffsets 集合。
注意
UseCompatibleTextRendering如果屬性為 false ， CustomTabOffsets 則會忽略屬性，並以標準索引標籤位移取代屬性。
類別 CheckedListBox 支援下列三個索引集合：
| 集合 | 封裝類別 |
|---|---|
| 控制項中包含的 CheckedListBox 所有專案。 | CheckedListBox.ObjectCollection |
| 已核取的專案 (包括處於不確定狀態的專案) ，這是 控制項中包含的 CheckedListBox 專案子集。 | CheckedListBox.CheckedItemCollection |
| 核取的索引，這是專案集合中索引的子集。 這些索引會指定處於已核取或不確定狀態的專案。 | CheckedListBox.CheckedIndexCollection |
下列三個數據表是 類別所支援之三個索引集合的 CheckedListBox 範例。
第一個資料表提供 控制項中專案索引集合的範例， (控制項中包含的所有專案) 。
| 索引 | Item | 檢查狀態 |
|---|---|---|
| 0 | 物件 1 | Unchecked |
| 1 | 物件 2 | Checked |
| 2 | 物件 3 | Unchecked |
| 3 | 物件 4 | Indeterminate |
| 4 | 物件 5 | Checked |
第二個數據表提供已核取專案的索引集合範例。
| 索引 | 項目 |
|---|---|
| 0 | 物件 2 |
| 1 | 物件 4 |
| 2 | 物件 5 |
第三個數據表提供已核取專案的索引索引集合範例。
| 索引 | 專案索引 |
|---|---|
| 0 | 1 |
| 1 | 3 |
| 2 | 4 |
建構函式
| CheckedListBox() |
初始化 CheckedListBox 類別的新執行個體。 |
欄位
| DefaultItemHeight |
指定主控描繪 ListBox 的預設項目高度。 (繼承來源 ListBox) |
| NoMatches |
指定搜尋中並未找到相符的項目。 (繼承來源 ListBox) |
屬性
| 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 |
取得控制項下邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 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 |
取得控制項的資料繫結 (Data Binding)。 (繼承來源 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 |
取得或設定值，指出這個控制項是否應使用次要緩衝區重繪其介面，以減少或防止重繪閃動 (Flicker)。 (繼承來源 Control) |
| DrawMode |
取得值，表示 CheckedListBox 繪製項目的模式。 這個屬性與這個類別無關。 |
| Enabled |
取得或設定值，指出控制項是否可回應使用者互動。 (繼承來源 Control) |
| Events |
取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component) |
| Focused |
取得指示控制項是否擁有輸入焦點的值。 (繼承來源 Control) |
| Font |
取得或設定控制項顯示之文字字型。 (繼承來源 ListBox) |
| FontHeight |
取得或設定控制項字型的高度。 (繼承來源 Control) |
| ForeColor |
取得或設定控制項的前景色彩。 (繼承來源 ListBox) |
| FormatInfo |
取得或設定提供自訂格式化行為的 IFormatProvider。 (繼承來源 ListControl) |
| FormatString |
取得或設定格式規範字元，表示要如何顯示值。 (繼承來源 ListControl) |
| FormattingEnabled |
取得或設定值，指出格式化是否會套用至 DisplayMember 的 ListControl 屬性。 (繼承來源 ListControl) |
| Handle |
取得控制項要繫結的目標視窗控制代碼。 (繼承來源 Control) |
| HasChildren |
取得指示控制項是否包含一或多個子控制項的值。 (繼承來源 Control) |
| Height |
取得或設定控制項的高度。 (繼承來源 Control) |
| HorizontalExtent |
取得或設定 ListBox 之水平捲軸可以捲動的寬度。 (繼承來源 ListBox) |
| HorizontalScrollbar |
取得或設定值，指出選取水平捲軸是否顯示於控制項中。 (繼承來源 ListBox) |
| ImeMode |
取得或設定控制項的輸入法 (IME) 模式。 (繼承來源 Control) |
| ImeModeBase |
取得或設定控制項的 IME 模式。 (繼承來源 Control) |
| IntegralHeight |
取得或設定值，指出控制項是否應該重新調整大小以避免僅顯示部分項目。 (繼承來源 ListBox) |
| InvokeRequired |
取得一個值。這個值會指示是否由於呼叫端是在建立控制項之執行緒以外的執行緒，因此在進行控制項的方法呼叫時，應呼叫叫用 (Invoke) 方法。 (繼承來源 Control) |
| IsAccessible |
取得或設定值，指出可及性應用程式是否見得到控制項。 (繼承來源 Control) |
| IsAncestorSiteInDesignMode |
指出這個控制項的其中一個上階是否已月臺，以及該月臺在 DesignMode 中。 這個屬性是唯讀的。 (繼承來源 Control) |
| IsDisposed |
取得指示控制項是否已經處置的值。 (繼承來源 Control) |
| IsHandleCreated |
取得指示控制項是否有相關控制代碼的值。 (繼承來源 Control) |
| IsMirrored |
取得值，指出是否左右反轉控制項。 (繼承來源 Control) |
| ItemHeight |
取得項目區域的高度。 |
| Items |
取得這個 CheckedListBox 中的項目集合。 |
| LayoutEngine |
取得控制項之配置引擎的快取執行個體。 (繼承來源 Control) |
| Left |
取得或設定控制項左邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| Location |
取得或設定對應至控制項容器左上角之控制項左上角的座標。 (繼承來源 Control) |
| Margin |
取得或設定控制項之間的空格。 (繼承來源 Control) |
| MaximumSize |
取得或設定 GetPreferredSize(Size) 可以指定的上限大小。 (繼承來源 Control) |
| MinimumSize |
取得或設定 GetPreferredSize(Size) 可以指定的下限大小。 (繼承來源 Control) |
| MultiColumn |
取得或設定值，指出 ListBox 是否支援多個資料行。 (繼承來源 ListBox) |
| Name |
取得或設定控制項的名稱。 (繼承來源 Control) |
| Padding |
取得或設定 CheckedListBox 內的邊框距離。 這個屬性與這個類別無關。 |
| Padding |
這個屬性與這個類別無關。 (繼承來源 ListBox) |
| Parent |
取得或設定控制項的父容器。 (繼承來源 Control) |
| PreferredHeight |
取得 ListBox 中所有項目的結合高度。 (繼承來源 ListBox) |
| PreferredSize |
取得能夠容納控制項的矩形區域的大小。 (繼承來源 Control) |
| ProductName |
取得包含控制項的組件的產品名稱。 (繼承來源 Control) |
| ProductVersion |
取得包含控制項的組件的版本。 (繼承來源 Control) |
| RecreatingHandle |
取得指示控制項目前是否正重新建立其控制代碼的值。 (繼承來源 Control) |
| Region |
取得或設定與控制項關聯的視窗區域。 (繼承來源 Control) |
| RenderRightToLeft |
已淘汰.
已淘汰.
此屬性現在已過時。 (繼承來源 Control) |
| ResizeRedraw |
取得或設定值，指出控制項重設大小時，是否會重繪本身。 (繼承來源 Control) |
| Right |
取得控制項右邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| RightToLeft |
取得或設定值，指出控制項所顯示的文字是否從右到左。 (繼承來源 ListBox) |
| ScaleChildren |
取得值，以判斷子控制項的縮放。 (繼承來源 Control) |
| ScrollAlwaysVisible |
取得或設定值，指出是否永遠顯示垂直捲軸。 (繼承來源 ListBox) |
| SelectedIndex |
取得或設定 ListBox 中目前選取項目之以零起始的索引。 (繼承來源 ListBox) |
| SelectedIndices |
取得集合，其中包含 ListBox 中所有目前選取項目之以零起始的索引。 (繼承來源 ListBox) |
| SelectedItem |
取得或設定 ListBox 中目前選取的項目。 (繼承來源 ListBox) |
| SelectedItems |
取得集合，其中含有 ListBox 中目前選取的項目。 (繼承來源 ListBox) |
| SelectedValue |
取得或設定 ValueMember 屬性指定的成員屬性值。 (繼承來源 ListControl) |
| SelectionMode |
取得或設定值以指定選取模式。 |
| ShowFocusCues |
取得指示控制項是否應顯示焦點矩形 (Focus Rectangle) 的值。 (繼承來源 Control) |
| ShowKeyboardCues |
取得值，指出使用者介面是否處於可顯示或隱藏鍵盤快速鍵的適當狀態下。 (繼承來源 Control) |
| Site |
取得或設定控制項的站台。 (繼承來源 Control) |
| Size |
取得或設定控制項的高度和寬度。 (繼承來源 Control) |
| Sorted |
取得或設定值，指出 ListBox 中的項目是否依照字母順序排序。 (繼承來源 ListBox) |
| TabIndex |
取得或設定控制項容器中的控制項定位順序。 (繼承來源 Control) |
| TabStop |
取得或設定值，指出使用者是否能使用 TAB 鍵，將焦點 (Focus) 給予這個控制項。 (繼承來源 Control) |
| Tag |
取得或設定物件，其包含控制項相關資料。 (繼承來源 Control) |
| Text |
取得或搜尋 ListBox 中目前選取項目的文字。 (繼承來源 ListBox) |
| ThreeDCheckBoxes |
取得或設定值，表示核取方塊是否有 |
| Top |
取得或設定控制項上邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| TopIndex |
取得或設定 ListBox 中第一個可見項目的索引。 (繼承來源 ListBox) |
| TopLevelControl |
取得沒有其他 Windows Form 父控制項的父控制項。 通常，這會是內含控制項最外層的 Form。 (繼承來源 Control) |
| UseCompatibleTextRendering |
取得或設定值，這個值會決定要使用 Graphics 類別 (GDI+) ，還是 TextRenderer 類別 (GDI) 轉譯文字。 |
| UseCustomTabOffsets |
取得或設定值，指出 ListBox 是否會在它繪製字串時，使用 CustomTabOffsets 整數陣列辨認並展開定位字元。 (繼承來源 ListBox) |
| UseTabStops |
取得或設定值，指出 ListBox 是否可在繪製自己的字串時辨識和展開定位字元。 (繼承來源 ListBox) |
| UseWaitCursor |
取得或設定值，指出是否將等待游標用於目前控制項和所有子控制項。 (繼承來源 Control) |
| ValueMember |
取得或設定字串，指定要向其取得值的資料來源屬性。 |
| Visible |
取得或設定值，這個值指出是否顯示控制項及其所有子控制項。 (繼承來源 Control) |
| Width |
取得或設定控制項的寬度。 (繼承來源 Control) |
| WindowTarget |
這個屬性與這個類別無關。 (繼承來源 Control) |
方法
事件
明確介面實作
| IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應