CheckBox 控件（针对 Visual Basic 6.0 用户）

项目
08/18/2008

更新：2007 年 11 月

本主题对 Visual Basic 6.0 的 CheckBox 控件与其在 Visual Basic 2008 中的等效项进行了比较。

Visual Basic 6.0 中的 CheckBox 控件在 Visual Basic 2008 中由 Windows 窗体 CheckBox 控件所取代。某些属性、方法、事件和常量的名称是不同的，在某些情况下，行为也有所不同。

概念差异

Click 事件

在 Visual Basic 6.0 中，在以编程方式更改 CheckBox 状态时引发 Click 事件。在 Visual Studio 2005 中，使用 CheckStateChanged 事件而不是 Click 事件。

其他差异

此外，还有许多适用于所有控件的概念性差异，例如数据绑定、字体处理、拖放、帮助支持等方面的差异。有关更多信息，请参见 Windows 窗体概述和对 .NET Framework 2.0 的 Windows 窗体的改进。

CheckBox 控件的代码更改

下面的示例演示 Visual Basic 6.0 与 Visual Basic 2008 在编码方法方面的差异。

响应单击 CheckBox 的代码更改

下面的代码演示如何在用户选中或取消选中 CheckBox 控件时更改该控件的文本。Visual Basic 6.0 Value 属性由 Visual Basic 2008Checked 属性取代，Caption 属性由 Text 属性取代。请注意，该 Visual Basic 2008 示例使用 CheckStateChanged 事件再现 Visual Basic 6.0 的 Click 事件的行为。

' Visual Basic 6.0
Private Sub Check1_Click()
    If Check1.Value = 1 Then
        Check1.Caption = "Checked"
    Else
        Check1.Caption = "Unchecked"
    End If
End Sub

' Visual Basic
Private Sub CheckBox1_CheckStateChanged(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles CheckBox1.CheckStateChanged
    If CheckBox1.Checked = True Then
        CheckBox1.Text = "Checked"
    Else
        CheckBox1.Text = "Unchecked"
    End If
End Sub

确定 CheckBox 状态的代码更改

下面的示例演示如何在运行时检查 CheckBox 控件的状态。

' Visual Basic 6.0
Select Case Check1.Value
    Case vbUnchecked
        Check1.Caption = "Unchecked"
    Case vbChecked
        Check1.Caption = "Checked"
    Case vbGrayed
        Check1.Caption = "Disabled"
End Select

' Visual Basic
Select Case CheckBox1.CheckState
    Case CheckState.Unchecked
        CheckBox1.Text = "Unchecked"
    Case CheckState.Checked
        CheckBox1.Text = "Checked"
    Case CheckState.Indeterminate
        CheckBox1.Text = "Disabled"
End Select

CheckBox 控件的属性、方法和事件等效项

下表列出了 Visual Basic 6.0 属性、方法和事件，以及它们的 Visual Basic 2008 等效项。具有相同的名称和行为的属性、方法和事件未予列出。如果适用，常量在属性或方法的下面缩进。除非另有说明，否则所有的 Visual Basic 2008 枚举都映射到 System.Windows.Forms 命名空间。

根据需要提供了解释行为差异的主题链接。如果 Visual Basic 2008 中没有直接等效项，则提供指向介绍其他替代项的主题的链接。

属性

Alignment

0（左对齐）

1（右对齐）

CheckAlign

MiddleLeft 枚举值

MiddleRight 枚举值

Appearance

0（平面）

1（三维）

FlatStyle 枚举

Flat 枚举值

Standard 枚举值

BackColor

说明：
有关颜色常量的列表，请参见颜色处理（针对 Visual Basic 6.0 用户）。

说明：
颜色在 Visual Basic 2008 中以不同方式处理。有关更多信息，请参见颜色行为（针对 Visual Basic 6.0 用户）。

Caption

Text

Container

Parent

DataChanged

DataField

DataFormat

DataMember

DataSource

新的实现。有关更多信息，请参见适用于 Visual Basic 6.0 用户的数据访问。

DisabledPicture

DownPicture

新的实现。有关更多信息，请参见如何：在升级应用程序中模拟 Visual Basic 6.0 三态控件。

DragIcon

DragMode

新的实现。有关更多信息，请参见拖放（针对 Visual Basic 6.0 用户）。

Font

FontBold

FontItalic

FontName

FontSize

FontStrikethrough

FontUnderline

Font

说明：
字体在 Visual Basic 2008 中以不同方式处理。有关更多信息，请参见字体处理（针对 Visual Basic 6.0 用户）。

ForeColor

说明：
有关颜色常量的列表，请参见颜色处理（针对 Visual Basic 6.0 用户）。

说明：
颜色在 Visual Basic 2008 中以不同方式处理。有关更多信息，请参见颜色行为（针对 Visual Basic 6.0 用户）。

Height

Height, Size

说明：
坐标在 Visual Basic 2008 中以不同方式处理。有关更多信息，请参见坐标系统（针对 Visual Basic 6.0 用户）。

HelpContextID

新的实现。有关更多信息，请参见帮助支持（针对 Visual Basic 6.0 用户）。

HWnd

Handle

Index

新的实现。有关更多信息，请参见控件数组（针对 Visual Basic 6.0 用户）。

Left

说明：
坐标在 Visual Basic 2008 中以不同方式处理。有关更多信息，请参见坐标系统（针对 Visual Basic 6.0 用户）。

MaskColor

新的实现。有关更多信息，请参见 MaskColor（针对 Visual Basic 6.0 用户）。

MouseIcon

新的实现。有关更多信息，请参见无法设置自定义 MousePointer。

MousePointer

Cursor

有关常量的列表，请参见 MousePointer（针对 Visual Basic 6.0 用户）。

OLEDropMode

新的实现。有关更多信息，请参见拖放（针对 Visual Basic 6.0 用户）。

Parent

FindForm 方法

Picture

Image

RightToLeft

True

RightToLeft

Yes 枚举值

No 枚举值

Style

0（标准）

1（图形）

Appearance

Normal 枚举值

Button 枚举值

说明：
Visual Basic 2008 中对 Graphical 样式的处理方式有所不同。有关更多信息，请参见如何：在升级应用程序中模拟 Visual Basic 6.0 三态控件。

Tag

ToolTipText

ToolTip 组件

有关更多信息，请参见工具提示支持（针对 Visual Basic 6.0 用户）。

Top

说明：
坐标在 Visual Basic 2008 中以不同方式处理。有关更多信息，请参见坐标系统（针对 Visual Basic 6.0 用户）。

UseMaskColor

新的实现。有关更多信息，请参见 MaskColor（针对 Visual Basic 6.0 用户）。

Value

0 (vbUnchecked)

1 (vbChecked)

2 (vbGrayed)

CheckState

Unchecked 枚举值

Checked 枚举值

Indeterminate 枚举值

WhatsThisHelpID

新的实现。有关更多信息，请参见帮助支持（针对 Visual Basic 6.0 用户）。

Width

Width, Size

说明：
坐标在 Visual Basic 2008 中以不同方式处理。有关更多信息，请参见坐标系统（针对 Visual Basic 6.0 用户）。

方法

Drag

新的实现。有关更多信息，请参见拖放（针对 Visual Basic 6.0 用户）。

Move

SetBounds

说明：
坐标在 Visual Basic 2008 中以不同方式处理。有关更多信息，请参见坐标系统（针对 Visual Basic 6.0 用户）。

OLEDrag

新的实现。有关更多信息，请参见拖放（针对 Visual Basic 6.0 用户）。

SetFocus

Focus

ShowWhatsThis

新的实现。有关更多信息，请参见帮助支持（针对 Visual Basic 6.0 用户）。

ZOrder

0 (vbBringToFront)

1 (vbSendToBack)

BringToFront, SendToBack

事件

Click

CheckStateChanged

说明：
在 Visual Basic 6.0 中，在以编程方式更改 CheckBox 状态时引发 Click 事件。Visual Basic 2008 中不引发 Click 事件；因此应使用 CheckStateChanged 事件。

DragDrop

DragOver

新的实现。有关更多信息，请参见拖放（针对 Visual Basic 6.0 用户）。

GotFocus

Enter

LostFocus

Leave

OLECompleteDrag

OLEDragDrop

OLEDragOver

OLEGiveFeedback

OLESetData

OLEStartDrag

新的实现。有关更多信息，请参见拖放（针对 Visual Basic 6.0 用户）。

Validate

Validating

升级说明

使用升级向导升级 Visual Basic 6.0 应用程序时，CheckBox 控件将升级为 Windows 窗体 CheckBox 控件，代码将更新为使用等效的属性、方法和事件。在没有等效项或存在潜在的行为差异时，将在代码中插入注释，注释中带有指向帮助主题的链接。

请参见

通过

CheckBox 控件（针对 Visual Basic 6.0 用户）

概念差异

Click 事件

其他差异

CheckBox 控件的代码更改

响应单击 CheckBox 的代码更改

确定 CheckBox 状态的代码更改

CheckBox 控件的属性、方法和事件等效项

属性

方法

事件

升级说明

请参见

概念

参考

其他资源

其他资源