Control TreeView para usuarios de Visual Basic 6.0

Actualización: noviembre 2007

El control TreeView de Visual Basic 6.0 se reemplaza por el control TreeView 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 SingleSel

En Visual Basic 6.0, la propiedad SingleSel de un control TreeView determina si se va a expandir un nodo cuando se selecciona para mostrar sus nodos secundarios. Establecer esta propiedad en True hace que se expanda el nodo cuando se selecciona y que el nodo anteriormente seleccionado se contraiga.

En Visual Basic 2008, la propiedad SingleSel ya no existe. De forma predeterminada, cuando se hace clic en un nodo no se expande (el valor predeterminado es equivalente a establecer la propiedad SingleSel en False en Visual Basic 6.0). Puede utilizar el evento AfterSelect para determinar cuándo se ha seleccionado un nodo y luego utilizar el método Expand o Collapse para controlar el comportamiento de expansión.

Propiedades Image y SelectedImage

En Visual Basic 6.0, es posible asignar una propiedad SelectedImage a un nodo de control TreeView sin asignar una propiedad Image.

En Visual Basic 2008, el objeto TreeNode de un control TreeView no puede tener una propiedad SelectedImage a menos que también tenga una propiedad Image. Si necesita emular el comportamiento de Visual Basic 6.0, puede asignar una imagen vacía a la propiedad Image.

Otras diferencias

Existen numerosas diferencias conceptuales que se aplican a todos los controles, como diferencias en los enlaces de datos, control de fuentes, operaciones de arrastrar y colocar, compatibilidad con Ayuda, y otras. Para obtener más información, vea Conceptos de formularios Windows Forms para usuarios de Visual Basic 6.0.

Cambios en el código del control TreeView

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 en el código para expandir un nodo seleccionado en un control TreeView

El código siguiente muestra cómo expandir un nodo TreeView cuando un usuario lo selecciona.

' 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

Codifique los cambios para agregar nodos a un control TreeView

El código siguiente muestra cómo agregar un nuevo nodo como un elemento secundario al nodo que está seleccionado.

' 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)

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

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.
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.
Container	Parent
DragIcon DragMode	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
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
Indentation	Indent
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.
LineStyle	ShowRootLines
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
Scroll	Scrollable
SingleSel	Nueva implementación. Utilice el evento NodeMouseClick.
Style	Nueva implementación de propiedad. Se asigna 0 o Standard al control CheckedListBox y 1 o Checkbox al control CheckedListBox.
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.
GetVisibleCount	Propiedad VisibleCount.
HitTest	GetNodeAt, GetNodeAt
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.
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 TreeView a controles TreeView de formularios Windows Forms. Cuando las propiedades, métodos y eventos no tienen ningún equivalente o tienen diferencias en comportamiento, se agregan notas o advertencias de actualización al código.

Vea también

Tareas

Cómo: Agregar información personalizada a los controles TreeView o ListView (formularios Windows Forms)

Cómo: Recorrer en iteración todos los nodos del control TreeView de formularios Windows Forms

Otros recursos

TreeView (Control, formularios Windows Forms)