ListBox-Steuerelement für Visual Basic 6.0-Benutzer
Aktualisiert: November 2007
Das ListBox-Steuerelement von Visual Basic 6.0 wird in Visual Basic 2008 entweder durch das ListBox-Steuerelement oder durch das CheckedListBox-Steuerelement ersetzt. Die Namen einiger Eigenschaften, Methoden, Ereignisse und Konstanten wurden geändert, und in einigen Fällen weicht auch ihr Verhalten ab.
Konzeptionelle Unterschiede
Aktiviertes ListBox-Steuerelement
In Visual Basic 6.0 bestimmt die Style-Eigenschaft eines ListBox-Steuerelements, ob neben den Textelementen jeweils ein Kontrollkästchen angezeigt wird. Im ListBox-Steuerelement können mehrere Elemente durch Aktivieren des entsprechenden Kontrollkästchens ausgewählt werden, auch wenn die MultiSelect-Eigenschaft auf False festgelegt ist. Es gibt keine Möglichkeit, den Aktivierungszustand eines Elements programmgesteuert festzustellen. Wenn dies möglich sein soll, müssen Sie stattdessen ein ListView-Steuerelement verwenden.
In Visual Basic 2008 bewirkt das neue CheckedListBox-Steuerelement die Anzeige von Kontrollkästchen neben den einzelnen Elementen. Es ist nicht mehr möglich, Kontrollkästchen im ListBox-Steuerelement anzuzeigen. Mit dem CheckedListBox-Steuerelement können Sie den Aktivierungszustand jedes Elements programmgesteuert durch eine CheckedListBox.CheckedItemCollection-Auflistung bestimmen.
Columns-Eigenschaft
In Visual Basic 6.0 nimmt die Columns-Eigenschaft eine ganze Zahl an, die die Anzahl der anzuzeigenden Spalten angibt.
In Visual Basic 2008 nimmt die MultiColumn-Eigenschaft einen booleschen Wert an. Die ColumnWidth-Eigenschaft nimmt dagegen eine Ganzzahl an, die die Breite in Pixeln angibt. Wenn die Breite des ListBox-Steuerelements zur Laufzeit geändert wird, müssen Sie ggf. auch die ColumnWidth-Eigenschaft für jede Spalte festlegen.
ItemCheck-Ereignis
Wenn in Visual Basic 6.0 ein ItemCheck-Ereignis ausgelöst wurde, war der Aktivierungszustand des ListBox-Steuerelements bereits geändert.
Wenn in Visual Basic 2008 das ItemCheck-Ereignis ausgelöst wird, hat sich der Aktivierungszustand des CheckedListBox-Steuerelements noch nicht geändert. Sie können den ausstehenden Wert vom ItemCheckEventArgs-Argument abrufen, das an das Ereignis übergeben wird.
Änderungen am Code für das ListBox-Steuerelement
Im folgenden Beispiel werden Unterschiede in den Codierungstechniken von Visual Basic 6.0 und Visual Basic 2008 dargestellt.
Änderungen am Code zum Hinzufügen und Entfernen von Elementen in einem ListBox-Steuerelement
Im folgenden Code wird veranschaulicht, wie ListBox-Elemente hinzugefügt und entfernt werden.
' Visual Basic 6.0
' Add an item at the end of the list.
List1.AddItem "Tokyo"
' Insert an item at the top of the list.
List1.AddItem "Copenhagen", 0
' Remove the first item.
List1.RemoveItem 0
'Visual Basic
' Add an item at the end of the list.
ListBox1.Items.Add("Tokyo")
' Insert an item at the top of the list.
ListBox1.Items.Insert(0, "Copenhagen")
' Remove the first item.
ListBox1.Items.RemoveAt(0)
Änderungen am Code für den Zugriff auf bestimmte Elemente in einem ListBox-Steuerelement
Im folgenden Code wird veranschaulicht, wie der Wert eines ListBox-Elements zurückgegeben wird.
' Visual Basic 6.0
Private Function GetItemText(i As Integer) As String
' Return the text of the item using the index:
GetItemText = ListBox1.List(i)
End Function
' Visual Basic
Private Function GetItemText(ByVal i As Integer) As String
' Return the text of the item using the index:
GetItemText = CStr(ListBox1.Items(i))
End Function
Änderungen am Code zum Ermitteln aktivierter Elemente in einem CheckedListBox-Steuerelement
Im folgenden Code wird veranschaulicht, wie der Aktivierungszustand von Elementen in einem CheckedListBox-Steuerelement bestimmt wird.
' Visual Basic 6.0
' The Visual Basic 6.0 ListBox control didn't support this scenario,
' a ListView control had to be used instead.
Dim s As String
Dim i As Integer
' Loop through all items
For i = 1 To ListView1.ListItems.Count
' If an item is checked, add it to the string
If ListView1.ListItems(i).Checked = True Then
s = s & "Checked Item" & CStr(i) & " = " & _
ListView1.ListItems(i) & vbCrLf
End If
Next
' Determine if any items are checked.
If s <> "" Then
MsgBox s
End If
' Visual Basic
' Determine if there are any items checked.
If CheckedListBox1.CheckedItems.Count <> 0 Then
' If so, loop through all checked items and print results.
Dim x As Integer
Dim s As String = ""
For x = 0 To CheckedListBox1.CheckedItems.Count - 1
s = s & "Checked Item " & CStr(x + 1) & " = " & _
CStr(CheckedListBox1.CheckedItems(x)) & ControlChars.CrLf
Next x
MessageBox.Show(s)
End If
Entsprechungen zu Eigenschaften, Methoden und Ereignissen des ListBox-Steuerelements
In den folgenden Tabellen werden Eigenschaften, Methoden und Ereignisse von Visual Basic 6.0 zusammen mit ihren Visual Basic 2008-Entsprechungen aufgeführt. Die Eigenschaften, Methoden und Ereignisse, die den gleichen Namen und das gleiche Verhalten haben, werden nicht aufgeführt. Sofern vorhanden, wurden Konstanten unter der Eigenschaft oder Methode eingerückt aufgelistet. Alle Visual Basic 2008-Enumerationen werden, sofern nicht anders angegeben, dem System.Windows.Forms-Namespace zugeordnet.
In dieser Tabelle werden Links zu Themen bereitgestellt, in denen Unterschiede im Verhalten erläutert werden. Wenn in Visual Basic 2008 keine direkte Entsprechung vorhanden ist, werden Links zu Themen bereitgestellt, die Alternativen behandeln.
Eigenschaften
Visual Basic 6.0 |
Visual Basic 2008-Entsprechung |
||
|---|---|---|---|
Appearance |
Neue Implementierung. Weitere Informationen finden Sie unter Appearance-Eigenschaft und BorderStyle-Eigenschaft für Visual Basic 6.0-Benutzer. |
||
BackColor |
|
||
Columns |
|||
Container |
|||
DataChanged DataField DataFormat DataMember DataSource |
Neue Implementierung. Weitere Informationen finden Sie unter Datenzugriff für Visual Basic 6.0-Benutzer. |
||
DragIcon DragMode |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
||
FontFont FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline |
|
||
ForeColor |
|
||
Height |
|
||
HelpContextID |
Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer. |
||
HWnd |
|||
Index |
Neue Implementierung. Weitere Informationen finden Sie unter Steuerelementarrays für Visual Basic 6.0-Benutzer. |
||
IntegralHeight |
|||
ItemData |
Neue Implementierung. Weitere Informationen finden Sie unter Die ItemData-Eigenschaft kann nicht aktualisiert werden. |
||
Left |
|
||
List |
|||
ListCount |
Count (List.Count) |
||
ListIndex |
|||
MouseIcon |
Neue Implementierung. Weitere Informationen finden Sie unter Es kann kein benutzerdefinierter MousePointer festgelegt werden. |
||
MousePointer |
Eine Liste mit Konstanten finden Sie unter MousePointer für Visual Basic 6.0-Benutzer. |
||
MultiSelect |
|||
NewIndex |
Neue Implementierung. Weitere Informationen finden Sie unter Die NewIndex-Eigenschaft kann nicht aktualisiert werden. |
||
OLEDragMode OLEDropMode |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
||
Parent |
FindForm-Methode |
||
SelCount |
Count (SelectedItem.Count) |
||
Selected |
GetSelected, SetSelected (ListBox-Steuerelement) GetItemChecked, SetItemChecked (CheckedListBox-Steuerelement) |
||
Style |
Neue Implementierungseigenschaft. 0 – Standard wird dem CheckedListBox-Steuerelement zugeordnet und 1 – Checkbox dem CheckedListBox-Steuerelement. |
||
ToolTipText |
ToolTip-Komponente Weitere Informationen finden Sie unter QuickInfo-Unterstützung für Visual Basic 6.0-Benutzer. |
||
Top |
|
||
WhatsThisHelpID |
Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer. |
||
Width |
|
.gif "Hinweis")
Hinweis:Methoden
Name |
Visual Basic 2008-Entsprechung |
||
|---|---|---|---|
AddItem |
|||
Clear |
|||
Drag |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
||
Move |
|
||
OLEDrag |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
||
RemoveItem |
|||
SetFocus |
|||
ShowWhatsThis |
Neue Implementierung. Weitere Informationen finden Sie unter Hilfeunterstützung für Visual Basic 6.0-Benutzer. |
||
ZOrder |
BringToFront-Methode oder SendToBack-Methode |
Ereignisse
Visual Basic 6.0 |
Visual Basic 2008-Entsprechung |
|---|---|
DblClick |
|
DragDrop DragOver |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
GotFocus |
|
ItemCheck |
ItemCheck (nur CheckedListBox) |
LostFocus |
|
OLECompleteDrag OLEDragDrop OLEDragOver OLEGiveFeedback OLESetData OLEStartDrag |
Neue Implementierung. Weitere Informationen finden Sie unter Drag & Drop für Visual Basic 6.0-Benutzer. |
Scroll |
Neue Implementierung. Weitere Informationen finden Sie unter TopIndex-Eigenschaft und Scroll-Ereignis für Visual Basic 6.0-Benutzer. |
Validate |
Hinweise zum Durchführen einer Aktualisierung
Wenn die Style-Eigenschaft eines Listbox-Steuerelements von Visual Basic 6.0 während der Aktualisierung auf 1 – Checkbox festgelegt ist, wird das Steuerelement auf das CheckedListBox-Steuerelement aktualisiert. Andernfalls wird es auf das ListBox-Steuerelement aktualisiert.
Siehe auch
Referenz
Übersicht über das ListBox-Steuerelement (Windows Forms)
Übersicht über das ListBox-Steuerelement (Windows Forms)
Übersicht über das CheckedListBox-Steuerelement (Windows Forms)