Contrôle ListView pour les utilisateurs de Visual Basic 6.0
Mise à jour : novembre 2007
Le contrôle ListView dans Visual Basic 6.0 est remplacé par le contrôle ListView 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é DropHighlight
Dans Visual Basic 6.0, lorsque le curseur passe au-dessus d'un objet ListItem dans un contrôle ListView, la propriété DropHighlight est utilisée pour mettre en surbrillance l'objet ListItem avec la couleur de surbrillance système. Cette propriété est communément utilisée dans les opérations de glisser-déplacer.
Dans Visual Basic 2008, la propriété DropHighlight n'existe plus ; vous pouvez obtenir le même effet par dessin ownerdrawing (également dénommé dessin personnalisé) de la surbrillance dans les événements MouseEnter et MouseLeave. Pour plus d'informations, consultez Contrôles avec prise en charge intégrée des dessins owner-drawn.
Propriété FlatScrollBar
Dans Visual Basic 6.0, la propriété FlatScrollBar détermine si la barre de défilement dans un contrôle ListView a une apparence bidimensionnelle.
Dans Visual Basic 2008, la propriété FlatScrollBar n'existe plus ; les barres de défilement dans le contrôle ListView ont toujours une apparence tridimensionnelle.
Propriété HideColumnHeaders
Dans Visual Basic 6.0, la propriété HideColumnHeaders détermine si les objets ColumnHeader dans un contrôle ListView sont masqués dans l'affichage Report.
Dans Visual Basic 2008, la propriété HideColumnHeaders n'existe plus ; vous pouvez contrôler la visibilité des en-têtes de colonnes en définissant la propriété HeaderStyle.
Événement ItemClick
Le contrôle ListView de Visual Basic 6.0 possède à la fois un événement Click et un événement ItemClick. L'événement ItemClick utilise un objet ListItem comme un argument.
Dans Visual Basic 2008, l'événement ItemClick n'est plus pris en charge. À la place, vous pouvez utiliser l'événement Click et l'argument EventSender.FocusedItem pour déterminer sur quel ListViewItem l'utilisateur a cliqué.
Tri
Dans Visual Basic 6.0, le tri d'un contrôle ListView est obtenu à l'aide d'une combinaison des propriétés Sorted, SortKey et SortOrder. Sorted détermine si le tri est activé, SortOrder si le tri est croissant ou décroissant, et SortKey spécifie le facteur de tri à utiliser à la place du texte.
Dans Visual Basic 2008, le tri s'effectue à l'aide de la propriété Sorting qui active le tri et définit l'ordre de tri au cours de la même étape. La propriété SortKey est remplacée par la propriété ListViewItemSorter.
Propriété View
Dans Visual Basic 6.0, la propriété View détermine comment les éléments sont affichés dans un contrôle ListView : comme de grandes icônes avec du texte (lvwIcon), comme de petites icônes avec du texte (lvwSmallIcon), comme une liste (lvwList) ou comme une liste contenant des sous-éléments (lvwReport).
Dans Visual Basic 2008, la propriété View existe encore, mais les énumérations sont différentes. lvwIcon est remplacé par LargeIcon, lvwSmallIcon par SmallIcon, lvwList par List et lvwReport par Details. De plus, il existe un nouvel affichage, Tile, où chaque élément apparaît sous forme d'une icône de taille normale avec l'étiquette de l'élément et les informations de sous-élément à sa droite.
Modifications apportées au code du contrôle ListView
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 pour déterminer l'élément sélectionné dans un contrôle ListView
L'exemple de code suivant assigne l'élément ListView sélectionné à une variable.
' Visual Basic 6.0
Dim theItem As ListItem
theItem = ListView1.SelectedItem
' Visual Basic
Dim theItem As ListViewItem
If ListView1.SelectedItems.Count > 0 Then
theItem = ListView1.SelectedItems(0)
Else
theItem = Nothing
End If
Modifications apportées au code pour déterminer tous les éléments sélectionnés dans un contrôle ListView
L'exemple de code suivant affiche un message avec le texte de chaque élément sélectionné dans un contrôle ListView.
' Visual Basic 6.0
For i = 1 To ListView1.ListItems.Count
If ListView1.ListItems(i).Selected = True Then
MsgBox(ListView1.SelectedItem
End If
Next i
' Visual Basic
For Each selectedItem As ListViewItem In ListView1.SelectedItems
MsgBox(selectedItem.Text)
Next
Équivalences des propriétés, méthodes et événements du contrôle ListView
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. |
||
Arrange |
|||
BackColor |
|
||
ColumnHeaderIcons |
|||
ColumnsHeaders |
|||
Container |
|||
DragIcon DragMode |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
||
DropHighlight |
Nouvelle implémentation. |
||
FlatScrollBar |
Nouvelle implémentation. |
||
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 |
|||
Icons |
|||
Index |
Nouvelle implémentation. Pour plus d'informations, consultez Tableaux de contrôles pour les utilisateurs de Visual Basic 6.0. |
||
Left |
|
||
ListItems |
|||
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 |
||
Picture |
|||
PictureAlignment |
|||
SelectedItem |
|||
SmallIcons |
|||
Sorted SortOrder |
|||
SortKey |
|||
TextBackground |
|||
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 |
|
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. |
||
FindItem |
|||
GetFirstVisible |
|||
Move |
|
||
OLEDrag |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
||
Refresh |
|||
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 |
---|---|
DblClick |
|
DragDrop DragOver |
Nouvelle implémentation. Pour plus d'informations, consultez Fonction de glisser-déplacer pour les utilisateurs de Visual Basic 6.0. |
GotFocus |
|
ItemClick |
Pas d'équivalent direct. |
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. |
Validate |
Mettre à niveau des remarques
Lorsqu'un projet Visual Basic 6.0 est mis à niveau vers Visual Basic 2008, tous les contrôles ListView sont mis à niveau vers des contrôles ListView 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.