Partager via


Contrôle CheckBox pour les utilisateurs de Visual Basic 6.0

Mise à jour : novembre 2007

Cette rubrique compare le contrôle CheckBox de Visual Basic 6.0 avec son équivalent dans Visual Basic 2008.

Le contrôle CheckBox de Visual Basic 6.0 est remplacé par le contrôle Windows Forms CheckBox dans Visual Basic 2008. Les noms de certains événements, propriétés, méthodes et constantes ont changé. En outre, dans certains cas, leur comportement est également différent.

Différences conceptuelles

Click, événement

Dans Visual Basic 6.0, l'événement Click est déclenché lorsque l'état CheckBox est modifié par programme. Dans Visual Studio 2005, vous utilisez l'événement CheckStateChanged et non l'événement Click.

Différences supplémentaires

De plus, de nombreuses différences conceptuelles s'appliquent à tous les contrôles, y compris des différences relatives à la liaison de données, la gestion des polices, le glisser-déplacer, la prise en charge de l'aide, etc. Pour plus d'informations, consultez Vue d'ensemble des Windows Forms et Ajouts dans les Windows Forms pour .NET Framework 2.0.

Modifications apportées au code du contrôle CheckBox

Les exemples ci-dessous illustrent les différences entre les techniques de codage dans Visual Basic 6.0 et dans Visual Basic 2008.

Modifications apportées au code de réponse à un clic du contrôle CheckBox

Le code suivant décrit la modification du texte d'un contrôle CheckBox lorsqu'un utilisateur active ou désactive le contrôle. La propriété de Visual Basic 6.0 Value est remplacée par la propriété Visual Basic 2008Checked, et la propriété Caption est remplacée par la propriété Text. Remarquez que l'exemple Visual Basic 2008 utilise l'événement CheckStateChanged pour dupliquer le comportement de l'événement Click de Visual Basic 6.0.

' 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

Modifications apportées au code de détermination de l'état d'une case à cocher

L'exemple suivant décrit la vérification de l'état d'un contrôle CheckBox au moment de l'exécution.

' 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

Propriété, méthode et événement équivalents du contrôle CheckBox

Les tableaux ci-dessous répertorient les propriétés, les méthodes et les événements de Visual Basic 6.0, ainsi que leurs équivalents dans Visual Basic 2008. Les propriétés, méthodes et événements qui ont les mêmes noms et comportements ne sont pas répertoriés. Lorsque des constantes s'appliquent, elles sont présentées en retrait sous le nom de la propriété ou de la méthode. Sauf indication contraire, toutes les énumérations Visual Basic 2008 sont mappées à l'espace de noms System.Windows.Forms.

Le cas échéant, des liens vous renvoient vers des rubriques expliquant les différences de comportement. Lorsqu'il n'existe pas d'équivalent direct dans Visual Basic 2008, des liens vous renvoient vers des rubriques proposant des alternatives.

Propriétés

Propriété de Visual Basic 6.0

Équivalent Visual Basic 2008

Alignment

0 (Justifier à gauche)

1 (Justifier à droite)

CheckAlign

Valeur d'énumération MiddleLeft

Valeur d'énumération MiddleRight

Appearance

0 (À deux dimensions)

1 (3D)

Énumération FlatStyle

Valeur d'énumération Flat

Valeur d'énumération Standard

BackColor

BackColor

Remarque :

Pour obtenir la liste des constantes de couleur, consultez Gestion des couleurs pour les utilisateurs de Visual Basic 6.0.

Remarque :

Les couleurs sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Comportement des couleurs pour les utilisateurs de Visual Basic 6.0.

Caption

Text

Container

Parent

DataChanged

DataField

DataFormat

DataMember

DataSource

Nouvelle implémentation. Pour plus d'informations, consultez Accès aux données pour les utilisateurs de Visual Basic 6.0.

DisabledPicture

DownPicture

Nouvelle implémentation. Pour plus d'informations, consultez Comment : émuler un contrôle Tri-state Visual Basic 6.0 dans une application mise à niveau.

DragIcon

DragMode

Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0.

Font

FontBold

FontItalic

FontName

FontSize

FontStrikethrough

FontUnderline

Font

Remarque :

Les polices sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Gestion des polices pour les utilisateurs de Visual Basic 6.0.

ForeColor

ForeColor

Remarque :

Pour obtenir la liste des constantes de couleur, consultez Gestion des couleurs pour les utilisateurs de Visual Basic 6.0.

Remarque :

Les couleurs sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Comportement des couleurs pour les utilisateurs de Visual Basic 6.0.

Height

Height, Size

Remarque :

Les coordonnées sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Système de coordonnées pour les utilisateurs de Visual Basic 6.0.

HelpContextID

Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0.

HWnd

Handle

Index

Nouvelle implémentation. Pour plus d'informations, consultez Tableaux de contrôles pour les utilisateurs de Visual Basic 6.0.

Left

Left

Remarque :

Les coordonnées sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Système de coordonnées pour les utilisateurs de Visual Basic 6.0.

MaskColor

Nouvelle implémentation. Pour plus d'informations, consultez MaskColor pour les utilisateurs de Visual Basic 6.0.

MouseIcon

Nouvelle implémentation. Pour plus d'informations, consultez Impossible de définir un pointeur de souris personnalisé.

MousePointer

Cursor

Pour obtenir la liste des constantes, consultez MousePointer pour les utilisateurs de Visual Basic 6.0.

OLEDropMode

Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0.

Parent

Méthode FindForm

Picture

Image

RightToLeft

True

RightToLeft

Valeur d'énumération Yes

Valeur d'énumération No

Style

0 (Standard)

1 (Graphique)

Appearance

Valeur d'énumération Normal

Valeur d'énumération Button

Remarque :

Il existe des différences relatives à la gestion du style Graphical dans Visual Basic 2008. Pour plus d'informations, consultez Comment : émuler un contrôle Tri-state Visual Basic 6.0 dans une application mise à niveau.

Tag

Tag

ToolTipText

Composant ToolTip

Pour plus d'informations, consultez Prise en charge des info-bulles pour les utilisateurs de Visual Basic 6.0.

Top

Top

Remarque :

Les coordonnées sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Système de coordonnées pour les utilisateurs de Visual Basic 6.0.

UseMaskColor

Nouvelle implémentation. Pour plus d'informations, consultez MaskColor pour les utilisateurs de Visual Basic 6.0.

Value

0 (vbUnchecked)

1 (vbChecked)

2 (vbGrayed)

CheckState

Valeur d'énumération Unchecked

Valeur d'énumération Checked

Valeur d'énumération Indeterminate

WhatsThisHelpID

Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0.

Width

Width, Size

Remarque :

Les coordonnées sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Système de coordonnées pour les utilisateurs de Visual Basic 6.0.

Méthodes

Méthode de Visual Basic 6.0

Équivalent Visual Basic 2008

Drag

Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0.

Move

SetBounds

Remarque :

Les coordonnées sont gérées différemment dans Visual Basic 2008. Pour plus d'informations, consultez Système de coordonnées pour les utilisateurs de Visual Basic 6.0.

OLEDrag

Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0.

SetFocus

Focus

ShowWhatsThis

Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0.

ZOrder

0 (vbBringToFront)

1 (vbSendToBack)

BringToFront, SendToBack

Événements

Événement de Visual Basic 6.0

Équivalent Visual Basic 2008

Click

CheckStateChanged

Remarque :

Dans Visual Basic 6.0, l'événement Click est déclenché lorsque l'état CheckBox est modifié par programme. Dans Visual Basic 2008, l'événement Click n'est pas déclenché ; par conséquent, vous devez utiliser l'événement CheckStateChanged.

DragDrop

DragOver

Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0.

GotFocus

Enter

LostFocus

Leave

OLECompleteDrag

OLEDragDrop

OLEDragOver

OLEGiveFeedback

OLESetData

OLEStartDrag

Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0.

Validate

Validating

Mettre à niveau des remarques

Lors de la mise à niveau d'une application Visual Basic 6.0 à l'aide de l'Assistant Mise à niveau, les contrôles CheckBox sont mis à niveau vers des contrôles CheckBox Windows Forms et le code est mis à jour pour utiliser des propriétés, des méthodes et des événements équivalents. Aux emplacements dans lesquels il n'y a aucun équivalent ou il existe des différences de comportement potentielles, les commentaires sont insérés dans le code avec un lien vers une rubrique d'aide.

Voir aussi

Concepts

Accès aux données pour les utilisateurs de Visual Basic 6.0

Propriété Style pour les utilisateurs de Visual Basic 6.0

Gestion des polices pour les utilisateurs de Visual Basic 6.0

Système de coordonnées pour les utilisateurs de Visual Basic 6.0

Tableaux de contrôles pour les utilisateurs de Visual Basic 6.0

Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0

MousePointer pour les utilisateurs de Visual Basic 6.0

Prise en charge des info-bulles pour les utilisateurs de Visual Basic 6.0

Référence

Vue d'ensemble du contrôle CheckBox (Windows Forms)

Autres ressources

Mise à niveau d'applications créées dans des versions précédentes de Visual Basic