CheckBox-Steuerelement für Visual Basic 6.0-Benutzer

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

Konzepte

Datenzugriff für Visual Basic 6.0-Benutzer

Style-Eigenschaft für Visual Basic 6.0-Benutzer

Schriftartbehandlung für Visual Basic 6.0-Benutzer

Koordinatensystem für Visual Basic 6.0-Benutzer

Steuerelementarrays für Visual Basic 6.0-Benutzer

Hilfeunterstützung für Visual Basic 6.0-Benutzer

MousePointer für Visual Basic 6.0-Benutzer

QuickInfo-Unterstützung für Visual Basic 6.0-Benutzer

Referenz

Übersicht über das CheckBox-Steuerelement (Windows Forms)

Weitere Ressourcen

Aktualisieren von Anwendungen, die in früheren Versionen von Visual Basic erstellt wurden