ListBox Class
Assembly: PresentationFramework (in presentationframework.dll)
XML Namespace: http://schemas.microsoft.com/winfx/2006/xaml/presentation
'Declaration <StyleTypedPropertyAttribute(Property:="ItemContainerStyle", StyleTargetType:=GetType(ListBoxItem))> _ <LocalizabilityAttribute(LocalizationCategory.ListBox)> _ Public Class ListBox Inherits Selector 'Usage Dim instance As ListBox
/** @attribute StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=System.Windows.Controls.ListBoxItem) */ /** @attribute LocalizabilityAttribute(LocalizationCategory.ListBox) */ public class ListBox extends Selector
StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=System.Windows.Controls.ListBoxItem) LocalizabilityAttribute(LocalizationCategory.ListBox) public class ListBox extends Selector
<ListBox> Items </ListBox>
ListBox controls are often used with data styling. See Data Templates Overview for a discussion of data styling.
ContentModel: A ListBox is an ItemsControl. For more information on the content model for ListBox, see ItemsControl Content Model.
This example shows how to create a ListBox using the Extensible Application Markup Language (XAML) and implement event handlers in C# or Microsoft Visual Basic to handle selection changes.
The ListBox in the following XAML example contains multiple list items. When the user selects one of the items, the event handler displays the name of the selected item in the TextBox.
<TextBox Name="tb" Width="140" Height="30"></TextBox> <ListBox Name="lb" Width="100" Height="55" SelectionChanged="PrintText" SelectionMode="Single"> <ListBoxItem>Item 1</ListBoxItem> <ListBoxItem>Item 2</ListBoxItem> <ListBoxItem>Item 3</ListBoxItem> <ListBoxItem>Item 4</ListBoxItem> <ListBoxItem>Item 5</ListBoxItem> <ListBoxItem>Item 6</ListBoxItem> <ListBoxItem>Item 7</ListBoxItem> <ListBoxItem>Item 8</ListBoxItem> <ListBoxItem>Item 9</ListBoxItem> <ListBoxItem>Item 10</ListBoxItem> </ListBox>
Sub PrintText(ByVal sender As Object, ByVal e As SelectionChangedEventArgs) Dim lbsender As ListBox Dim li As ListBoxItem lbsender = CType(sender, ListBox) li = CType(lbsender.SelectedItem, ListBoxItem) tb.Text = " You selected " & li.Content.ToString & "." End Sub
For the complete sample see: List Box Sample.
System.Windows.Threading.DispatcherObject
System.Windows.DependencyObject
System.Windows.Media.Visual
System.Windows.UIElement
System.Windows.FrameworkElement
System.Windows.Controls.Control
System.Windows.Controls.ItemsControl
System.Windows.Controls.Primitives.Selector
System.Windows.Controls.ListBox
System.Windows.Controls.ListView
Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.