# ToggleButton 切换按钮
显示项目的选中状态。
用切换按钮显示某个项目是否被选中。如果将切换按钮绑定到了数据源，则切换按钮会将该数据源的值显示为 Yes/No、True/False、On/Off 的其中之一。如果选中了切换按钮，则当前设置为 Yes、True 或 On；如果未选中切换按钮，则设置为 No、False 或 Off。如果将切换按钮绑定到了数据源，则改变切换按钮设置将同时改变数据源中的值。禁用的切换按钮能够显示值，但会变暗，并且不能通过用户界面进行修改。
也可在框架中使用切换按钮，以在一组相关项目中选择一个或多个项目。例如，可以创建一个包含可选项目清单的订单窗体，每个项目前有一个切换按钮。用户可以通过选择相应的切换按钮来选择某个项目。
切换按钮的默认属性是 Value 属性。
切换按钮的默认事件是 Click 事件。
属性
| 属性 | 说明 |
|---|---|
| Accelerator | 设置或检索控件的加速键。 |
| Alignment | 规定控件与其题注的相对位置。 |
| AutoSize | 规定对象是否自动调整大小以显示其完整的内容。 |
| BackColor | 规定对象的背景色。 |
| BackStyle | 返回或设置对象的背景方式。 |
| BoundValue | 控件接受焦点时，包含控件的值。 |
| Caption | 在对象中出现的、用于标识或说明该对象的说明性文本。 |
| ControlSource | 标识用于设置或储存控件中 Value 属性的数据位置。ControlSource 属性可接受 Microsoft Excel 工作表区域。 |
| ControlTipText | 指定当用户将鼠标指针放在控件上但未按下时所显示的文本。 |
| Enabled | 指定一个控件能否接受焦点和响应用户产生的事件。 |
| Font对象 | 定义控件或窗体所用文字的特征。 |
| ForeColor | 指定对象的前景色。 |
| Height、Width | 对象的高度和宽度，以磅为单位。 |
| HelpContextID | HelpContextID 属性将一个自定义 Microsoft Windows 帮助文件中的特定主题与一个指定的控件相关联。 |
| LayoutEffect | 指定在改变布局期间控件是否移动。 |
| Left、Top | 控件与所在窗体的左边或顶边之间的距离。 |
| Locked | 指定一个控件能否被编辑。 |
| MouseIcon | 为对象指定一个自定义的图标。 |
| MousePointer | 指定当用户把鼠标放到特定对象上时，所显示鼠标指针的类型。 |
| Name | 指定一个控件或对象的名称或与 Font 对象相关的字体的名称。 |
| Object | 当新控件具有与标准属性或方法同名的属性或方法时，则覆盖相应的标准属性或方法。 |
| OldHeight、OldWidth | 返回控件先前的高度或宽度，以磅为单位。 |
| OldLeft、OldTop | 返回控件先前位置与所在窗体的左边或顶边之间的距离，以磅为单位。 |
| Parent | 返回包含指定控件、对象或集合的窗体、对象或集合的名字。 |
| Picture | 指定显示在对象上的位图。 |
| PicturePosition | 指定图片与其题注的的相对位置。 |
| SpecialEffect | 指定对象的外观。 |
| TabIndex | 指定单个对象在窗体 Tab 键顺序中的位置。 |
| TabStop | 指定当用户跳格到一个对象时，该对象能否获得焦点 。 |
| Tag | 存储对象的附加信息。 |
| TripleState | 决定用户能否在用户界面，为复选框或切换按钮指定 Null 状态。 |
| Value | 定义某给定的控件的状态或内容。 |
| Visible | 定义一个对象是可视的还是被隐藏的。 |
| WordWrap | 指出一个控件的内容在行末是否自动换行。 |
方法
| 方法 | 说明 |
|---|---|
| Move | 移动一个窗体或控件，或者移动 Controls 集合中的所有控件。 |
| SetFocus | 将焦点移动到对象的实例中。 |
| ZOrder | 将对象放在 Z-顺序的前面或后面。 |
事件
| 事件 | 说明 |
|---|---|
| AfterUpdate | 在通过用户界面更改了控件中的数据后，此事件发生。 |
| BeforeDragOver | 当拖放操作正在进行时该事件发生。 |
| BeforeDropOrPaste | 当用户即将在一个对象上放置或粘贴数据时，该事件发生。 |
| BeforeUpdate | 控件中的数据被改变之前该事件发生。 |
| Change | 当 Value 属性改变时该事件发生。 |
| Click | 用鼠标单击控件 |
| DblClick | 当用户指向一个对象并双击鼠标时，发生 DblClick 事件。 |
| Enter、Exit | 一个控件从同一窗体的另一个控件实际接收到焦点之前，Enter 事件发生。同一窗体中的一个控件即将把焦点转移到另一个控件之前，Exit 事件发生。 |
| Error | 当控件检测到一个错误，并且不能将该错误信息返回调用程序时该事件发生。 |
| KeyDown、KeyUp | 按下和释放某键时这两个事件依次发生。按下键时发生 KeyDown 事件，而释放键时发生 KeyUp 事件。 |
| KeyPress | 当用户按下一个 ANSI 键时该事件发生。 |
| MouseDown、MouseUp | 用户单击鼠标按键时发生。用户按下鼠标按键时发生 MouseDown 事件；用户释放鼠标按键时发生 MouseUp 事件。 |
| MouseMove | 用户移动鼠标时该事件发生。 |
示例