Contrôle Label pour les utilisateurs de Visual Basic 6.0
Mise à jour : novembre 2007
Cette rubrique compare le contrôle Label de Visual Basic 6.0 avec son équivalent dans Visual Basic 2008.
Le contrôle Label de Visual Basic 6.0 est remplacé par le contrôle Windows Forms Label dans Visual Basic 2008. Certains noms de propriétés, méthodes, événements et constantes ont changé. En outre, dans certains cas, leur comportement est également différent.
Différences conceptuelles
BackStyle, propriété
Dans Visual Basic 6.0, la propriété BackStyle du contrôle Label indique si l'étiquette a un arrière-plan transparent. L'affectation de la valeur 0 – Transparent à la propriété BackStyle permet d'afficher une image d'arrière-plan à travers l'étiquette. Si l'étiquette est placée sur d'autres contrôles, les contrôles apparaissent également à travers celle-ci.
Dans Visual Basic 2008, la propriété BackStyle n'existe plus et le comportement de la transparence est légèrement différent. Pour émuler le comportement de la transparence dans Visual Basic 2008, affectez la valeur Transparent à la propriété BackColor. Cela permet à l'image d'arrière-plan d'apparaître à travers l'étiquette. Si l'étiquette est placée sur d'autres contrôles, les contrôles apparaissent uniquement à travers celle-ci s'ils sont plus hauts dans l'ordre de plan.
Remarque : |
---|
La méthode ZOrder n'existe plus dans Visual Basic 2008. Au moment du design, vous pouvez utiliser la commande Mettre au premier plan ou Mettre en arrière-plan dans le menu Format ; au moment de l'exécution, vous pouvez utiliser la fonction BringToFront ou SendToBack. |
WordWrap, propriété
Dans Visual Basic 6.0, la propriété WordWrap détermine si le texte est renvoyé à la ligne sur plusieurs lignes lorsqu'il est trop long pour contenir dans une étiquette.
Dans Visual Basic 2008, le texte dans un contrôle Label est automatiquement renvoyé à la ligne. La seule façon d'empêcher le renvoi à la ligne est de faire en sorte que la hauteur du contrôle Label soit équivalente à une seule ligne de texte.
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, la fonctionnalité glisser-déplacer, la prise en charge de l'aide, etc. Pour plus d'informations, consultez Concepts Windows Forms pour les utilisateurs de Visual Basic 6.0.
Modifications du code pour le contrôle Label
L'exemple de code ci-dessous illustre les différences entre les techniques de codage dans Visual Basic 6.0 et dans Visual Basic 2008.
Modifications du code pour rendre une étiquette transparente
L'exemple suivant illustre comment rendre l'arrière-plan d'un contrôle Label transparent. Dans Visual Basic 6.0, s'il existe d'autres contrôles derrière Label, ces contrôles apparaissent à travers celle-ci. Dans l'exemple Visual Basic 2008, tous les contrôles situés derrière Label peuvent apparaître en transparence, si besoin, à l'aide des fonctions BringToFront et SendToBack.
' Visual Basic 6.0
Private Sub MakeTransparent()
Label1.BackStyle = vbTransparent
End Sub
' Visual Basic
Private Sub MakeTransparent()
Label1.BackColor = System.Drawing.Color.Transparent
' Let controls behind the label show through.
Label1.SendToBack()
' Make the portion of controls behind the label transparent
Label1.BringToFront()
End Sub
Équivalences des propriétés, méthodes et événements du contrôle Label
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. Ces propriétés, méthodes et événements qui ont les mêmes nom et comportement 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.
Ce tableau fournit des liens vers les rubriques qui expliquent 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 du contrôle Label
Visual Basic 6.0 |
Équivalent Visual Basic 2008 |
||||
---|---|---|---|---|---|
Alignment: 0 - Left Justify 1 - Right Justify |
Valeur d'énumération MiddleLeft Valeur d'énumération MiddleRight |
||||
Appearance |
Nouvelle implémentation. Pour plus d'informations, consultez Propriétés Appearance et BorderStyle pour les utilisateurs de Visual Basic 6.0. |
||||
AutoSize |
|||||
BackColor |
Remarque Pour obtenir la liste des constantes, consultez Gestion des couleurs pour les utilisateurs de Visual Basic 6.0.
|
||||
BackStyle |
Nouvelle implémentation. Pour plus d'informations, reportez-vous aux différences conceptuelles. |
||||
Caption |
|||||
Container |
|||||
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. |
||||
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 |
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 |
|
||||
Height |
|
||||
Index |
Nouvelle implémentation. Pour plus d'informations, consultez Tableaux de contrôles pour les utilisateurs de Visual Basic 6.0. |
||||
Left |
|
||||
LinkItem LinkMode LinkTimeOut LinkTopic |
Pas d'équivalent. Pour plus d'informations, consultez Échange dynamique de données 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 |
||||
RightToLeft: True False |
Valeur d'énumération Yes Valeur d'énumération No |
||||
ToolTipText |
Composant ToolTip Pour plus d'informations, consultez Prise en charge des info-bulles pour les utilisateurs de Visual Basic 6.0. |
||||
Top |
|
||||
WhatsThisHelpID |
Nouvelle implémentation. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0. |
||||
Width |
|
||||
WordWrap |
Nouvelle implémentation.
|
Méthodes du contrôle Label
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. |
||
LinkExecute LinkPoke LinkRequest LinkSend |
Pas d'équivalent. Pour plus d'informations, consultez Échange dynamique de données 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. |
||
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 |
Méthode BringToFront ou SendToBack |
Événements du contrôle Label
Visual Basic 6.0 |
Équivalent Visual Basic 2008 |
---|---|
Change |
|
DblClick |
|
DragDrop DragOver |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
LinkClose LinkError LinkNotify LinkOpen |
Pas d'équivalent. Pour plus d'informations, consultez Échange dynamique de données pour les utilisateurs de Visual Basic 6.0. |
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
Lorsqu'une application Visual Basic 6.0 est mise à niveau vers Visual Basic 2008, tous les contrôles Label sont mis à niveau vers des contrôles Windows Forms Label, et les propriétés, méthodes et événements sont mis à niveau en conséquence. Des commentaires de mise à niveau sont insérés dans le code aux endroits où des différences de comportement sont susceptibles de se produire.