Control ListView para usuarios de Visual Basic 6.0

Actualización: noviembre 2007

El control ListView de Visual Basic 6.0 se reemplaza por el control ListView en Visual Basic 2008. Los nombres de algunas propiedades, métodos, eventos y constantes son diferentes y, en algunos casos, existen diferencias de comportamiento.

Diferencias conceptuales

Propiedad DropHighlight

En Visual Basic 6.0, cuando se mueve el cursor sobre un objeto ListItem de un control ListView, se utiliza la propiedad DropHighlight para resaltar el objeto ListItem con el color de resaltado del sistema. Esta propiedad se utiliza normalmente en operaciones de arrastrar y colocar.

En Visual Basic 2008, ya no existe la propiedad DropHighlight; puede lograr el mismo efecto aplicando el modo ownerdraw (dibujo propietario, también conocido como dibujo personalizado) al resaltado en los eventos MouseEnter y MouseLeave. Para obtener más información, vea Controles compatibles con dibujos propietarios integrados.

Propiedad FlatScrollBar

En Visual Basic 6.0, la propiedad FlatScrollBar determina si la barra de desplazamiento de un control ListView tiene una apariencia plana (bidimensional).

En Visual Basic 2008, ya no existe la propiedad FlatScrollBar; las barras de desplazamiento del control ListView siempre tienen una apariencia tridimensional.

Propiedad HideColumnHeaders

En Visual Basic 6.0, la propiedad HideColumnHeaders determina si los objetos ColumnHeader de un control ListView se ocultan en la vista Report.

En Visual Basic 2008, ya no existe la propiedad HideColumnHeaders; puede controlar la visibilidad de los encabezados de columna estableciendo la propiedad HeaderStyle.

Evento ItemClick

El control ListView de Visual Basic 6.0 tiene un evento Click y ItemClick. El evento ItemClick acepta objetos ListItem como argumento.

En Visual Basic 2008, ya no hay eventos ItemClick. En su lugar puede utilizar el evento Click y el argumento EventSender.FocusedItem para determinar en qué ListViewItem se ha hecho clic.

Ordenar

En Visual Basic 6.0, la ordenación de un control ListView se lleva a cabo utilizando una combinación de las propiedades Sorted, SortKey y SortOrder. Sorted determina si se ha habilitado la ordenación, SortOrder determina si la ordenación es ascendente o descendente y SortKey especifica un subelemento que se va a utilizar para ordenar en lugar del texto.

En Visual Basic 2008, la ordenación se lleva a cabo utilizando la propiedad Sorting, que habilita la ordenación y establece el criterio de ordenación en un solo paso. La propiedad ListViewItemSorter reemplaza a la propiedad SortKey.

Propiedad View

En Visual Basic 6.0, la propiedad View determina cómo se muestran los elementos de un control ListView, como iconos grandes con texto (lvwIcon), como iconos pequeños con texto (lvwSmallIcon), como una lista (lvwList) o como una lista con subelementos (lvwReport).

En Visual Basic 2008, todavía existe la propiedad View, pero las enumeraciones son distintas. lvwIcon se reemplaza por LargeIcon, lvwSmallIcon por SmallIcon, lvwList por List y lvwReport por Details. Además, hay una vista nueva, Tile, donde aparece cada elemento como un icono a tamaño completo con la etiqueta de elemento y la información de subelemento a la derecha de éste.

Cambios de código para el control ListView

En los ejemplos siguientes se muestran las diferencias entre las técnicas de codificación de Visual Basic 6.0 y Visual Basic 2008.

Cambios de código para determinar el elemento seleccionado de un control ListView

El ejemplo de código siguiente asigna el elemento ListView seleccionado a una 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

Codifique los cambios para determinar todos los elementos seleccionados de un control ListView

En el ejemplo de código siguiente se muestra un cuadro de mensaje con el texto de cada elemento seleccionado en el control 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

Equivalencias de propiedades, métodos y eventos del control ListView

En las siguientes tablas se muestran propiedades, métodos y eventos de Visual Basic 6.0, junto con sus equivalentes en Visual Basic 2008. No se enumeran aquellas propiedades, métodos y eventos que tienen el mismo nombre y el mismo comportamiento. Salvo que se indique lo contrario, todas las enumeraciones de Visual Basic 2008 se asignan al espacio de nombres System.Windows.Forms.

Esta tabla proporciona vínculos a temas en los que se explican las diferencias de comportamiento. Cuando no existe un equivalente directo en Visual Basic 2008, se proporcionan vínculos a temas en los que se incluyen alternativas.

Propiedades

Visual Basic 6.0	Equivalente en Visual Basic 2008
Appearance	Nueva implementación. Para obtener más información, vea Propiedades Appearance y BorderStyle para usuarios de Visual Basic 6.0.
Arrange	Alignment
BackColor	BackColor Nota: Los colores se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Comportamiento del color para los usuarios de Visual Basic 6.0.
ColumnHeaderIcons	ImageIndex, ImageKey
ColumnsHeaders	Columns
Container	Parent
DragIcon DragMode	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
DropHighlight	Nueva implementación.
FlatScrollBar	Nueva implementación.
FontFont FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline	Font Nota: Las fuentes se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Objeto Font para usuarios de Visual Basic 6.0.
Height	Height, Size Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
HelpContextID	Nueva implementación. Para obtener más información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0.
HWnd	Handle
Icons	LargeImageList
Index	Nueva implementación. Para obtener más información, vea Matrices de controles para usuarios de Visual Basic 6.0.
Left	Left Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
ListItems	Items
MouseIcon	Nueva implementación. Para obtener más información, vea No se puede personalizar la propiedad MousePointer.
MousePointer	Cursor Para obtener una lista de constantes, vea MousePointer para usuarios de Visual Basic 6.0.
OLEDragMode OLEDropMode	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
Parent	Método FindForm
Picture	BackgroundImage
PictureAlignment	BackgroundImageTiled
SelectedItem	SelectedItems
SmallIcons	SmallImageList
Sorted SortOrder	Sorting
SortKey	ListViewItemSorter
TextBackground	BackColor
ToolTipText	Componente ToolTip. Para obtener más información, vea Compatibilidad de la información sobre herramientas para usuarios de Visual Basic 6.0.
Top	Top Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
WhatsThisHelpID	Nueva implementación. Para obtener más información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0.
Width	Width, Size Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.

Métodos

Name	Equivalente en Visual Basic 2008
Drag	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
FindItem	FindItemWithText
GetFirstVisible	TopItem
Move	SetBounds Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
OLEDrag	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
Refresh	RedrawItems
SetFocus	Focus
ShowWhatsThis	Nueva implementación. Para obtener más información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0.
StartLabelEdit	BeginEdit
ZOrder	Método BringToFront o SendToBack

Eventos

Notas de actualización

Cuando se actualiza un proyecto de Visual Basic 6.0 a Visual Basic 2008, se actualizan todos los controles ListView a controles ListView de formularios Windows Forms. Cuando las propiedades, métodos y eventos no tienen ningún equivalente o presentan diferente comportamiento, se agregan notas o advertencias de actualización al código.

Vea también

Otros recursos

ListView (Control, formularios Windows Forms)