Contrôle TreeView pour les utilisateurs de Visual Basic 6.0
Mise à jour : novembre 2007
Le contrôle TreeView dans Visual Basic 6.0 est remplacé par le contrôle TreeView 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
Propriété SingleSel
Dans Visual Basic 6.0, la propriété SingleSel d'un contrôle TreeView détermine si un nœud se développe pour afficher ses nœuds enfants en cas de sélection. Attribuer à cette propriété la valeur True provoque le développement du nœud lorsqu'il est sélectionné et le repli du nœud précédemment sélectionné.
Dans Visual Basic 2008, la propriété SingleSel n'existe plus. Par défaut, un nœud ne se développe pas lorsqu'il est sélectionné (la valeur par défaut équivaut à attribuer à la propriété SingleSel la valeur False dans Visual Basic 6.0). Vous pouvez utiliser l'événement AfterSelect pour déterminer quand un nœud a été sélectionné, puis utiliser la méthode Expand ou Collapse pour contrôler le comportement de développement.
Propriétés Image et SelectedImage
Dans Visual Basic 6.0, il est possible d'assigner une propriété SelectedImage à un nœud de contrôle TreeView sans assigner une propriété Image.
Dans Visual Basic 2008, l'objet TreeNode d'un contrôle TreeView ne peut pas avoir de propriété SelectedImage s'il ne possède pas également de propriété Image. Si vous devez émuler le comportement de Visual Basic 6.0, vous pouvez assigner une image vide à la propriété Image.
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, les opérations de 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 apportées au code du contrôle TreeView
Les exemples ci-dessous illustrent les différences entre les techniques de codage dans Visual Basic 6.0 et dans Visual Basic 2008.
Modification de code pour le développement d'un nœud sélectionné dans un contrôle TreeView
Le code suivant montre comment développer un nœud TreeView lorsqu'un utilisateur le sélectionne.
' Visual Basic 6.0
TreeView1.SingleSel = True
' Visual Basic
Private Sub TreeView1_AfterSelect(ByVal sender As Object, ByVal e As _
System.Windows.Forms.TreeViewEventArgs) Handles TreeView1.AfterSelect
TreeView1.SelectedNode.Expand()
End Sub
Modifications de code pour l'ajout de nœuds dans un contrôle TreeView
Le code suivant montre comment ajouter un nouveau nœud en tant qu'enfant du nœud actuellement sélectionné.
' Visual Basic 6.0
Dim nodX As Node
Set nodX = TreeView1.Nodes.Add(Node, tvwChild, , "New Node")
' Visual Basic
Dim nodX As TreeNode = New TreeNode("New Node")
TreeView1.SelectedNode.Nodes.Add(nodX)
Équivalences des propriétés, méthodes et événements du contrôle TreeView
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. 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 des 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
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 |
|
||
Container |
|||
DragIcon DragMode |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
||
FontFont 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 |
|||
Indentation |
|||
Index |
Nouvelle implémentation. Pour plus d'informations, consultez Tableaux de contrôles pour les utilisateurs de Visual Basic 6.0. |
||
Left |
|
||
LineStyle |
|||
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. |
||
OLEDragMode 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 |
||
Scroll |
|||
SingleSel |
Nouvelle implémentation. Utilisez l'événement NodeMouseClick. |
||
Style |
Propriété de nouvelle implémentation. 0 ou Standard correspond au contrôle CheckedListBox, 1 ou Checkbox correspond au contrôle CheckedListBox. |
||
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 |
|
.gif "Remarque")
Remarque :Méthodes
Nom |
É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. |
||
GetVisibleCount |
Propriété VisibleCount. |
||
HitTest |
|||
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. |
||
StartLabelEdit |
|||
ZOrder |
Méthode BringToFront ou SendToBack |
Événements
Visual Basic 6.0 |
Équivalent Visual Basic 2008 |
|---|---|
Collapse |
|
DblClick |
|
DragDrop DragOver |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
Expand |
|
GotFocus |
|
LostFocus |
|
NodeCheck |
|
NodeClick |
|
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 |
Mettre à niveau des remarques
Lorsqu'un projet Visual Basic 6.0 est mis à niveau vers Visual Basic 2008, tous les contrôles TreeView sont mis à niveau vers des contrôles TreeView Windows Forms. Lorsque les propriétés, méthodes et événements n'ont aucun équivalent ou présentent des différences de comportement, des notes ou avertissements de mise à niveau sont ajoutés à votre code.
Voir aussi
Tâches
Comment : ajouter des informations personnalisées à un contrôle TreeView ou ListView (Windows Forms)
Comment : itérer dans tous les nœuds d'un contrôle TreeView Windows Forms