CheckBox-Steuerelement für Visual Basic 6.0-Benutzer

Artikel
09/02/2008

Aktualisiert: November 2007

In diesem Thema wird das CheckBox -Steuerelement von Visual Basic 6.0 mit seiner Entsprechung in Visual Basic 2008 verglichen.

Das CheckBox-Steuerelement von Visual Basic 6.0 wird in Visual Basic 2008 durch das CheckBox-Steuerelement von Windows Forms ersetzt. Die Namen einiger Eigenschaften, Methoden, Ereignisse und Konstanten wurden geändert, und in einigen Fällen weicht auch ihr Verhalten ab.

Konzeptionelle Unterschiede

Click-Ereignis

In Visual Basic 6.0 wird das Click-Ereignis ausgelöst, wenn der CheckBox-Zustand programmgesteuert geändert wird. Verwenden Sie in Visual Studio 2005 das CheckStateChanged-Ereignis und nicht das Click-Ereignis.

Zusätzliche Unterschiede

Außerdem gibt es zahlreiche konzeptionelle Unterschiede, die für alle Steuerelemente gelten, einschließlich Unterschiede bei Datenbindung, Schriftartbehandlung, Drag & Drop, Hilfeunterstützung usw. Weitere Informationen finden Sie unter Übersicht über Windows Forms und unter Ergänzungen zu Windows Forms für .NET Framework 2.0.

Codeänderungen beim CheckBox-Steuerelement

Im folgenden Beispiel werden Unterschiede in den Codierungstechniken von Visual Basic 6.0 und Visual Basic 2008 dargestellt.

Codeänderungen bei der Reaktion auf CheckBox-Klicks

Der folgende Code zeigt, wie der Text eines CheckBox-Steuerelements geändert wird, wenn ein Benutzer das Steuerelement aktiviert oder deaktiviert. Die Value-Eigenschaft von Visual Basic 6.0 wird durch die Visual Basic 2008Checked-Eigenschaft ersetzt, und die Caption-Eigenschaft wird durch die Text-Eigenschaft ersetzt. Beachten Sie, dass im Visual Basic 2008-Beispiel das CheckStateChanged-Ereignis verwendet wird, um das Verhalten des Click-Ereignisses in Visual Basic 6.0 zu kopieren.

' 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

Codeänderungen beim Bestimmen des Zustands eines CheckBox-Steuerelements

Im folgenden Beispiel wird gezeigt, wie der Zustand eines CheckBox-Steuerelements zur Laufzeit überprüft wird.

' 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

Entsprechungen für CheckBox-Eigenschaften, -Methoden und -Ereignisse

In den folgenden Tabellen werden Eigenschaften, Methoden und Ereignisse von Visual Basic 6.0 zusammen mit ihren Visual Basic 2008-Entsprechungen aufgeführt. Die Eigenschaften, Methoden und Ereignisse, die über denselben Namen und dasselbe Verhalten verfügen, werden dabei nicht berücksichtigt. Sofern vorhanden, wurden Konstanten unter der Eigenschaft oder Methode eingerückt aufgelistet. Alle Visual Basic 2008-Enumerationen werden, sofern nicht anders angegeben, dem System.Windows.Forms-Namespace zugeordnet.

Bei Bedarf werden Links zu Themen bereitgestellt, in denen die Unterschiede im Verhalten erläutert werden. Wenn in Visual Basic 2008 keine direkte Entsprechung vorhanden ist, werden Links zu Themen bereitgestellt, die Alternativen behandeln.

Eigenschaften

Visual Basic 6.0-Eigenschaft	Visual Basic 2008-Entsprechung
Alignment 0 (Linksbündig ausrichten) 1 (Rechtsbündig ausrichten)	CheckAlign MiddleLeft-Enumerationswert MiddleRight-Enumerationswert
Appearance 0 (Flach) 1 (3D)	FlatStyle-Enumeration Flat-Enumerationswert Standard-Enumerationswert
BackColor	BackColor Hinweis: Eine Liste mit Farbkonstanten finden Sie unter Behandeln von Farben für Visual Basic 6.0-Benutzer. Hinweis: Farben werden in Visual Basic 2008 anders behandelt. Weitere Informationen hierzu finden Sie unter Farbverhalten für Visual Basic 6.0-Benutzer.
Caption	Text
Container	Parent
DataChanged DataField DataFormat DataMember DataSource	Neue Implementierung. Weitere Informationen hierzu finden Sie unter Datenzugriff für Visual Basic 6.0-Benutzer.
DisabledPicture DownPicture	Neue Implementierung. Weitere Informationen finden Sie unter Gewusst wie: Emulieren eines Visual Basic 6.0-Steuerelements mit drei Zuständen in einer aktualisierten Anwendung.
DragIcon DragMode	Neue Implementierung. Weitere Informationen hierzu finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline	Font Hinweis: Schriftarten werden in Visual Basic 2008 anders behandelt. Weitere Informationen hierzu finden Sie unter Schriftartbehandlung für Visual Basic 6.0-Benutzer.
ForeColor	ForeColor Hinweis: Eine Liste mit Farbkonstanten finden Sie unter Behandeln von Farben für Visual Basic 6.0-Benutzer. Hinweis: Farben werden in Visual Basic 2008 anders behandelt. Weitere Informationen hierzu finden Sie unter Farbverhalten für Visual Basic 6.0-Benutzer.
Height	Height, Size Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen hierzu finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
HelpContextID	Neue Implementierung. Weitere Informationen hierzu finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.
HWnd	Handle
Index	Neue Implementierung. Weitere Informationen hierzu finden Sie unter Steuerelementarrays für Visual Basic 6.0-Benutzer.
Left	Left Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen hierzu finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
MaskColor	Neue Implementierung. Weitere Informationen hierzu finden Sie unter MaskColor für Visual Basic 6.0-Benutzer.
MouseIcon	Neue Implementierung. Weitere Informationen hierzu finden Sie unter Es kann kein benutzerdefinierter MousePointer festgelegt werden.
MousePointer	Cursor Eine Liste mit Konstanten finden Sie unter MousePointer für Visual Basic 6.0-Benutzer.
OLEDropMode	Neue Implementierung. Weitere Informationen hierzu finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
Parent	FindForm-Methode
Picture	Image
RightToLeft True	RightToLeft Yes-Enumerationswert No-Enumerationswert
Style 0 (Standard) 1 (Grafisch)	Appearance Normal-Enumerationswert Button-Enumerationswert Hinweis: Das Graphical-Format wird in Visual Basic 2008 unterschiedlich behandelt. Weitere Informationen finden Sie unter Gewusst wie: Emulieren eines Visual Basic 6.0-Steuerelements mit drei Zuständen in einer aktualisierten Anwendung.
Tag	Tag
ToolTipText	ToolTip-Komponente Weitere Informationen hierzu finden Sie unter QuickInfo-Unterstützung für Visual Basic 6.0-Benutzer.
Top	Top Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen hierzu finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
UseMaskColor	Neue Implementierung. Weitere Informationen hierzu finden Sie unter MaskColor für Visual Basic 6.0-Benutzer.
Value 0 (vbUnchecked) 1 (vbChecked) 2 (vbGrayed)	CheckState Unchecked-Enumerationswert Checked-Enumerationswert Indeterminate-Enumerationswert
WhatsThisHelpID	Neue Implementierung. Weitere Informationen hierzu finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.
Width	Width, Size Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen hierzu finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.

Methoden

Visual Basic 6.0-Methode	Visual Basic 2008-Entsprechung
Drag	Neue Implementierung. Weitere Informationen hierzu finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
Move	SetBounds Hinweis: Koordinaten werden in Visual Basic 2008 anders behandelt. Weitere Informationen hierzu finden Sie unter Koordinatensystem für Visual Basic 6.0-Benutzer.
OLEDrag	Neue Implementierung. Weitere Informationen hierzu finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
SetFocus	Focus
ShowWhatsThis	Neue Implementierung. Weitere Informationen hierzu finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer.
ZOrder 0 (vbBringToFront) 1 (vbSendToBack)	BringToFront, SendToBack

Ereignisse

Visual Basic 6.0-Ereignis	Visual Basic 2008-Entsprechung
Click	CheckStateChanged Hinweis: In Visual Basic 6.0 wird das Click-Ereignis ausgelöst, wenn der CheckBox-Zustand programmgesteuert geändert wird. In Visual Basic 2008 wird das Click-Ereignis nicht ausgelöst. Sie sollten daher das CheckStateChanged-Ereignis verwenden.
DragDrop DragOver	Neue Implementierung. Weitere Informationen hierzu finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
GotFocus	Enter
LostFocus	Leave
OLECompleteDrag OLEDragDrop OLEDragOver OLEGiveFeedback OLESetData OLEStartDrag	Neue Implementierung. Weitere Informationen hierzu finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer.
Validate	Validating

Hinweise zum Durchführen einer Aktualisierung

Beim Aktualisieren einer Visual Basic 6.0-Anwendung mit dem Aktualisierungs-Assistenten werden CheckBox-Steuerelemente auf CheckBox-Steuerelemente von Windows Forms aktualisiert. Code wird für die Verwendung äquivalenter Eigenschaften, Methoden und Ereignisse aktualisiert. Wenn es keine Entsprechungen gibt oder wo potenzielle Verhaltensunterschiede bestehen, werden Kommentare mit einem Link zu einem Hilfethema in den Code eingefügt.

Siehe auch

Freigeben über