Contrôle CommandButton pour les utilisateurs de Visual Basic 6.0
Mise à jour : novembre 2007
Le contrôle CommandButton de Visual Basic 6.0 est remplacé par le contrôle Windows Forms Button 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
Default et Cancel, propriétés
Dans Visual Basic 6.0, les propriétés booléennes Default et Cancel d'un contrôle CommandButton détermine si le contrôle répond respectivement aux touches ENTRÉE ou ÉCHAP.
Dans Visual Basic 2008, le contrôle Button ne dispose plus des propriétés Default ou Cancel. L'objet Form dispose des propriétés AcceptButton et CancelButton qui fournissent les mêmes fonctionnalités ; ces propriétés prennent le nom d'un contrôle Button comme argument.
Value, propriété
Dans Visual Basic 6.0, la propriété booléenne Value d'un contrôle CommandButton indique si le contrôle a été sélectionné ; l'affectation de True à la propriété appelle l'événement Click du bouton.
Dans Visual Basic 2008, la propriété Button ne possède plus de propriété Value. Vous pouvez utiliser l'événement GotFocus pour déterminer si le contrôle est sélectionné ; la méthode PerformClick peut être utilisée pour appeler l'événement Click.
Style, Picture, DownPicture et DisabledPicture, propriétés
Dans Visual Basic 6.0, l'affectation de la valeur 1 – Graphical à la propriété Style d'un contrôle CommandButton modifie l'apparence de ce contrôle pour permettre l'affichage d'images. Les propriétés Picture, DownPicture et DisabledPicture sont utilisées pour assigner des images à afficher en réponse à des changements d'état. Par exemple, lorsque l'utilisateur clique sur un contrôle CommandButton, l'image DownPicture est affichée ; si le contrôle est désactivé, l'image DisabledPicture est affichée.
Visual Basic 2008 ne prend plus en charge les propriétés Style, Picture, DownPicture ou DisabledPicture. La propriété Style n'est plus nécessaire ; l'assignation d'une image à la propriété Image a le même effet que l'affectation de Graphical à la propriété Style. La propriété Picture est remplacée par la propriété Image. Les fonctionnalités des propriétés DownPicture et DisabledPicture peuvent être émulées à l'aide d'un contrôle ImageList qui contient plusieurs images.
MaskColor, propriété
Dans Visual Basic 6.0, la propriété MaskColor d'un contrôle CommandButton est utilisée pour définir une couleur qui devient transparente, permettant ainsi l'affichage d'une image d'arrière plan. Pour utiliser cette propriété, Graphical doit être affecté à la propriété Style, True à la propriété UseMaskColor, et une bitmap doit être assignée à la propriété Picture.
Dans Visual Basic 2008, il n'existe aucun équivalent direct de la propriété MaskColor. Cependant, vous pouvez définir la transparence d'un contrôle à l'aide de la méthode MakeTransparent d'un objet Bitmap.
Autres différences
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 Contrôles Windows Forms pour les utilisateurs de Visual Basic 6.0.
Modifications apportées au code du contrôle CommandButton
Les exemples de code 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 pour définir les boutons Par défaut et Annuler
L'exemple suivant montre comment définir deux boutons pour qu'ils soient les boutons Par défaut et Annuler d'un formulaire.
' Visual Basic 6.0
' Set the first button to respond to the Enter key.
Command1.Default = True
' Set the second button to respond to the Esc key.
Command2.Cancel = True
' Visual Basic
' Set the first button to respond to the Enter key.
Me.AcceptButton = Button1
' Set the second button to respond to the Esc key.
Me.CancelButton = Button2
Modifications apportées au code pour ajouter la transparence à un bouton
L'exemple suivant illustre l'utilisation de méthodes permettant de définir une région transparente sur un bouton qui contient une image ; toute partie de l'image qui est blanche deviendra transparente.
' Visual Basic 6.0
' Assumes a picture has been assigned to the Picture property
' and that the Style property has been set to Graphical.
Command1.UseMaskColor = True
Command1.MaskColor = vbWhite
' Visual Basic
' Assumes a picture has been assigned to the BackgroundImage property.
Dim ButtonBitmap As New System.Drawing.Bitmap(Button1.BackgroundImage)
ButtonBitmap.MakeTransparent(System.Drawing.Color.White)
Button1.BackgroundImage = ButtonBitmap
Équivalences des propriétés, méthodes et événements du contrôle CommandButton
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.
Ces tableaux répertorient les liens vers les 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 alternatives.
Propriétés
Visual Basic 6.0 |
Équivalent Visual Basic 2008 |
||
|---|---|---|---|
Appearance |
Nouvelle implémentation. Pour plus d'informations, consultez Propriétés Appearance et BorderStyle pour les utilisateurs de Visual Basic 6.0. |
||
BackColor |
|
||
Cancel |
CancelButton (objet Form) |
||
Caption |
|||
Container |
|||
Default |
AcceptButton (objet Form) |
||
DisabledPicture DownPicture |
Nouvelle implémentation. Pour plus d'informations, consultez Propriété Style pour les utilisateurs de Visual Basic 6.0. |
||
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 |
|
||
Height |
|
||
HelpContextID |
Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0. |
||
HWnd |
|||
Index |
Nouvelle implémentation. Pour plus d'informations, consultez Tableaux de contrôles pour les utilisateurs de Visual Basic 6.0. |
||
Left |
|
||
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 |
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 |
|||
RightToLeft |
|||
Style |
Nouvelle implémentation. Pour plus d'informations, consultez Propriété Style pour les utilisateurs de Visual Basic 6.0. |
||
ToolTipText |
Composant ToolTip Pour plus d'informations, consultez Prise en charge des info-bulles pour les utilisateurs de Visual Basic 6.0. |
||
Top |
|
||
UseMaskColor |
Nouvelle implémentation. Pour plus d'informations, consultez MaskColor pour les utilisateurs de Visual Basic 6.0. |
||
Value |
Nouvelle implémentation. La méthode PerformClick est identique à l'affectation de True à Value ; il n'y a aucun équivalent pour les autres utilisations de la propriété Value. |
||
WhatsThisHelpID |
Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0. |
||
Width |
|
.gif "Remarque")
Remarque :Méthodes
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 |
|
||
OLEDrag |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
||
SetFocus |
|||
ShowWhatsThis |
Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0. |
||
ZOrder |
Fonction BringToFront ou SendToBack |
Événements
Visual Basic 6.0 |
Équivalent Visual Basic 2008 |
|---|---|
DragDrop DragOver |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
GotFocus |
|
LostFocus |
|
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. |
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 CommandButton sont mis à niveau vers des contrôles Button Windows Forms et le code est mis à jour pour utiliser les propriétés, méthodes et événements équivalents. Lorsqu'il n'y a pas d'équivalents ou qu'il existe des différences de comportement potentielles, des commentaires sont insérés dans le code avec des liens vers les rubriques d'aide.
Lorsqu'une application est mise à jour vers Visual Basic 2008, si la propriété Style a la valeur 1 – Graphical, la propriété FlatStyle du contrôle mis à jour prend la valeur Standard, et toute image assignée à la propriété Picture au moment du design est assignée à la propriété Image du contrôle mis à jour.
Si les propriétés DownPicture ou DisabledPicture ont été définies au moment du design ou de l'exécution, vous devrez modifier votre application mise à niveau pour utiliser un contrôle ImageList. Pour plus d'informations, consultez Comment : émuler un contrôle Tri-state Visual Basic 6.0 dans une application mise à niveau.
L'Assistant Mise à niveau ne met pas à niveau le code qui utilise la propriété MaskColor. Des avertissements de mise à niveau seront insérés dans votre code. Vous devrez modifier le code avant d'exécuter l'application.