ListBox Control Changes in Visual Basic .NET

Visual Basic Concepts

The ListBox control in Visual Basic 6.0 is replaced by either the Windows Forms ListBox control or the CheckedListBox control in Visual Basic .NET. The names of some properties, methods, events, and constants are different, and in some cases there are differences in behavior.

During upgrade, if the Style property of a Visual Basic 6.0 Listbox is set to 1 – Checkbox, it is upgraded to the CheckedListBox control; otherwise, it is upgraded to the ListBox control.

The following tables list Visual Basic 6.0 properties, methods, and events and their Visual Basic .NET equivalents. Where applicable, constants are indented beneath the property or method. All Visual Basic .NET constants map to the System.Windows.Forms namespace unless otherwise noted.

Links are provided as necessary to topics explaining differences in behavior. Where there is no direct equivalent in Visual Basic .NET, links are provided to topics that present alternatives.

ListBox Properties

Visual Basic 6.0	Visual Basic .NET Equivalent
Appearance	No equivalent. For more information, see Appearance and BorderStyle Property Changes in Visual Basic .NET.
BackColor	BackColor Note Colors are handled differently in Visual Basic .NET. For more information, see Color Behavior Changes in Visual Basic .NET. For a list of constants, see Color Changes in Visual Basic .NET.
CausesValidation	CausesValidation
Columns	MultiColumn and ColumnWidth Note The Columns property took an integer specifying the number of columns. The MultiColumn property takes a Boolean value, and the ColumnWidth property takes an integer specifying the width in pixels. If the width of the ListBox control is changed at run time, you may also need to set the ColumnWidth property for each column.
Container	Parent
DataChanged	No equivalent. For more information, see Data Changes in Visual Basic .NET.
DataField	No equivalent. For more information, see Data Changes in Visual Basic .NET.
DataFormat	No equivalent. For more information, see Data Changes in Visual Basic .NET.
DataMember	No equivalent. For more information, see Data Changes in Visual Basic .NET.
DataSource	No equivalent. For more information, see Data Changes in Visual Basic .NET.
DragIcon	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
DragMode	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
Enabled	Enabled
Font	Font Note Fonts are handled differently in Visual Basic .NET. For more information, see Font Changes in Visual Basic .NET.
FontBold	Font Note Fonts are handled differently in Visual Basic .NET. For more information, see Font Changes in Visual Basic .NET.
FontItalic	Font Note Fonts are handled differently in Visual Basic .NET. For more information, see Font Changes in Visual Basic .NET.
FontName	Font Note Fonts are handled differently in Visual Basic .NET. For more information, see Font Changes in Visual Basic .NET.
FontSize	Font Note Fonts are handled differently in Visual Basic .NET. For more information, see Font Changes in Visual Basic .NET.
FontStrikethru	Font Note Fonts are handled differently in Visual Basic .NET. For more information, see Font Changes in Visual Basic .NET.
FontUnderline	Font Note Fonts are handled differently in Visual Basic .NET. For more information, see Font Changes in Visual Basic .NET.
ForeColor	ForeColor Note Colors are handled differently in Visual Basic .NET. For more information, see Color Behavior Changes in Visual Basic .NET. For a list of constants, see Color Changes in Visual Basic .NET.
Height	Height, Size Note Coordinates are handled differently in Visual Basic .NET. For more information, see Coordinate System Changes in Visual Basic .NET.
HelpContextID	No equivalent. For more information, see Help Support Changes in Visual Basic .NET.
HWnd	Handle
Index	No equivalent. For more information, see Control Array Changes in Visual Basic .NET.
IntegralHeight	IntegralHeight
ItemData	No equivalent. For more information, see ItemData property cannot be upgraded.
Left	Left Note Coordinates are handled differently in Visual Basic .NET. For more information, see Coordinate System Changes in Visual Basic .NET.
List	Items
ListCount	Items.Count
ListIndex	SelectedIndex
MouseIcon	No equivalent. For more information, see Cannot set a custom MousePointer.
MousePointer	Cursor For a list of constants, see MousePointer Changes in Visual Basic .NET.
MultiSelect 0 – None 1 – Simple 2 – Extended	SelectionMode SelectionMode.One SelectionMode.MultiSimple SelectionMode.MultiExtended
Name	Name
NewIndex	No equivalent. For more information, see NewIndex property cannot be upgraded.
OLEDragMode	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
OLEDropMode	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
Parent	FindForm method
RightToLeft True False	RightToLeft RightToLeft.Yes RightToLeft.No
SelCount	SelectedItems.Count
Selected	GetSelected, SetSelected (ListBox control) GetItemChecked, SetItemChecked (CheckedListBox control)
Sorted	Sorted
Style 0 - Standard 1 - Checkbox	No equivalent property. 0 – Standard maps to the ListBox control, 1 – Checkbox maps to the CheckedListBox control.
TabIndex	TabIndex
TabStop	TabStop
Tag	Tag
Text	Text
ToolTipText	ToolTip component For more information, see ToolTip Changes in Visual Basic .NET.
Top	Top Note Coordinates are handled differently in Visual Basic .NET. For more information, see Coordinate System Changes in Visual Basic .NET.
TopIndex	TopIndex
Visible	Visible
WhatsThisHelpID	No equivalent. For more information, see Help Support Changes in Visual Basic .NET.
Width	Width, Size Note Coordinates are handled differently in Visual Basic .NET. For more information, see Coordinate System Changes in Visual Basic .NET.

ListBox Methods

Name	Visual Basic .NET Equivalent
AddItem	Items.Insert or Items.Add
Clear	Items.Clear
Drag	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
Move	SetBounds Note Coordinates are handled differently in Visual Basic .NET. For more information, see Coordinate System Changes in Visual Basic .NET.
OLEDrag	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
Refresh	Refresh
RemoveItem	Items.Remove
SetFocus	Focus
ShowWhatsThis	No equivalent. For more information, see Help Support Changes in Visual Basic .NET.
ZOrder 0 – vbBringToFront 1 - vbSendToBack	BringToFront() or SendToBack() functions BringToFront() SendToBack()

ListBox Events

Visual Basic 6.0	Visual Basic .NET Equivalent
Click	SelectedIndexChanged Note In Visual Basic 6.0, the Click event was raised when the CheckBox state was changed programmatically. In Visual Studio .NET, the Click event is not raised; therefore, you should use the CheckStateChanged event.
DblClick	No equivalent. Use the SelectedIndexChanged or TextChanged events.
DragDrop	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
DragOver	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
GotFocus	Enter
ItemCheck	ItemCheck (CheckedListBox only) Note In Visual Basic 6.0, when an event was raised, the check state was already changed. In Visual Basic .NET, the check state has not yet changed. You can get the pending value from the ItemCheckEventArgs argument passed to the event.
KeyDown	KeyDown
KeyPress	KeyPress
KeyUp	KeyUp
LostFocus	Leave
MouseDown	MouseDown
MouseMove	MouseMove
MouseUp	MouseUp
OLECompleteDrag	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
OLEDragDrop	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
OLEDragOver	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
OLEGiveFeedback	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
OLESetData	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
OLEStartDrag	No equivalent. For more information, see Drag and Drop Changes in Visual Basic .NET.
Scroll	No equivalent. For more information, see TopIndex Property and Scroll Event Changes in Visual Basic .NET.
Validate	Validating

See Also