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 将识别并展开项文本中的制表符，从而创建列。 这些制表位是预设的，不能更改。 若要使用自定义制表位，请将 设置为 UseTabStopsfalse，将 UseCustomTabOffsets 设置为 true，并将自定义值添加到集合。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 |
获取控件下边缘与其容器的工作区上边缘之间的距离（以像素为单位）。 (继承自 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 |
获取或设置一个值，该值指示是否将格式设置应用于 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 |
获取或设置控件左边缘与其容器的工作区左边缘之间的距离（以像素为单位）。 (继承自 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 |
获取控件右边缘与其容器的工作区左边缘之间的距离（以像素为单位）。 (继承自 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 |
获取或设置控件在其容器内的 Tab 键顺序。 (继承自 Control) |
| TabStop |
获取或设置一个值，该值指示用户能否使用 Tab 键将焦点放到该控件上。 (继承自 Control) |
| Tag |
获取或设置包含有关控件的数据的对象。 (继承自 Control) |
| Text |
获取或搜索 ListBox 中当前选定项的文本。 (继承自 ListBox) |
| ThreeDCheckBoxes |
获取或设置一个值，该值指示复选框是否有 |
| Top |
获取或设置控件上边缘与其容器的工作区上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| TopIndex |
获取或设置 ListBox 中第一个可见项的索引。 (继承自 ListBox) |
| TopLevelControl |
获取没有另一个 Windows 窗体控件作为其父级的父控件。 通常，这是控件所在的最外面的 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。
提交和查看相关反馈