Visual Basic 6.0 使用者可用的 CheckBox 控制項

發行項
08/21/2008

更新：2007 年 11 月

這個主題會比較 Visual Basic 6.0 的 CheckBox 控制項以及這個控制項在 Visual Basic 2008 中的對等用法。

Visual Basic 6.0 的 CheckBox 控制項在 Visual Basic 2008 中會以 Windows Form CheckBox 控制項取代。有些屬性、方法、事件及常數的名稱會改變，而且在某些情況下，行為方面也會有差異。

概念上的差異

Click 事件

在 Visual Basic 6.0 中，以程式設計方式變更 CheckBox 狀態時，會引發 Click 事件。在 Visual Studio 2005 中，您會使用 CheckStateChanged 事件，而不是 Click 事件。

其他差異

此外，還有許多概念不同處，適用於所有控制項，包括資料繫結、字型處理、拖放、說明支援等方面的差別。如需詳細資訊，請參閱Windows Form 概觀和Windows Form 針對 .NET Framework 2.0 提供的額外功能。

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 列舉型別 (Enumeration) 都會對應到 System.Windows.Forms 命名空間 (Namespace)。

將視需要提供連結至解釋行為差異的主題。若 Visual Basic 2008 中沒有直接的對等用法，則提供連結至替代的主題。

屬性

Alignment

0 (靠左對齊)

1 (靠右對齊)

CheckAlign

MiddleLeft 列舉值

MiddleRight 列舉值

Appearance

0 (平面)

1 (3D)

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

新實作。如需詳細資訊，請參閱 HOW TO：在升級應用程式中模擬 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

新實作。如需詳細資訊，請參閱 Visual Basic 6.0 使用者可用的 MaskColor。

MouseIcon

新實作。如需詳細資訊，請參閱無法設定自訂 MousePointer。

MousePointer

Cursor

如需常數的清單，請參閱 Visual Basic 6.0 使用者可用的 MousePointer。

OLEDropMode

新實作。如需詳細資訊，請參閱 Visual Basic 6.0 使用者可用的拖放動作。

Parent

FindForm 方法

Picture

Image

RightToLeft

True

RightToLeft

Yes 列舉值

No 列舉值

Style

0 (標準)

1 (圖形)

Appearance

Normal 列舉值

Button 列舉值

注意事項：
Visual Basic 2008 中處理 Graphical 樣式的方法有所不同。如需詳細資訊，請參閱 HOW TO：在升級應用程式中模擬 Visual Basic 6.0 三種狀態的控制項。

Tag

ToolTipText

ToolTip 元件

如需詳細資訊，請參閱 Visual Basic 6.0 使用者可用的 ToolTip 支援。

Top

注意事項：
在 Visual Basic 2008 中會以不同方式處理座標。如需詳細資訊，請參閱 Visual Basic 6.0 使用者可用的座標系統。

UseMaskColor

新實作。如需詳細資訊，請參閱 Visual Basic 6.0 使用者可用的 MaskColor。

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 Form CheckBox 控制項，並更新程式碼，以使用對等的屬性、方法和事件。沒有對等用法或可能有行為上的差異時，會使用連結至說明主題的方法，在程式碼中插入註解。

請參閱

共用方式為

Visual Basic 6.0 使用者可用的 CheckBox 控制項

概念上的差異

Click 事件

其他差異

CheckBox 控制項的程式碼變更

回應 CheckBox 按鍵的程式碼變更

判斷 CheckBox 狀態的程式碼變更

CheckBox 控制項屬性、方法和事件的對等用法

屬性

方法

事件

升級注意事項

請參閱

概念

參考

其他資源

其他資源