Silverlight - 列表框

列表框是一个向用户提供项目列表以供选择项目的控件。用户可以一次从预定义的项目列表中选择一个或多个项目。在ListBox中，多个选项始终对用户可见，无需任何用户交互。

列表框呈现可滚动的项目列表。如果用户选择某个项目，则所选项目会更改外观以指示选择。它支持更广泛的内容模型和Button形式。按钮和列表框之间的主要区别在于，按钮包含单个内容，而列表框则允许列表中的每个项目。

ListBox 类的层次继承如下 -

下面给出了ListBox类的常用属性。

下面给出了 ListBox 最常用的属性。

先生。没有。	属性及描述
1	背景获取或设置提供控件背景的画笔。（继承自Control）
2	边框厚度获取或设置控件的边框粗细。（继承自Control）
3	字体系列获取或设置用于在控件中显示文本的字体。（继承自Control）
4	字体大小获取或设置此控件中文本的大小。（继承自Control）
5	字体样式获取或设置呈现文本的样式。（继承自Control）
6	字体粗细获取或设置指定字体的粗细。（继承自Control）
7	前景获取或设置描述前景色的画笔。（继承自Control）
8	团体风格获取定义每个级别组的外观的 GroupStyle 对象的集合。（继承自ItemsControl）
9	高度获取或设置 FrameworkElement 的建议高度。（继承自FrameworkElement）
10	水平对齐获取或设置在布局父级（例如面板或项控件）中组合 FrameworkElement 时应用于该 FrameworkElement 的水平对齐特征。（继承自FrameworkElement）
11	已启用获取或设置一个值，该值指示用户是否可以与控件交互。（继承自Control）
12	物品获取用于生成控件内容的集合。（继承自ItemsControl）
13	项目来源获取或设置用于生成 ItemsControl 内容的对象源。（继承自ItemsControl）
14	利润获取或设置 FrameworkElement 的外边距。（继承自FrameworkElement）
15	姓名获取或设置对象的标识名称。当 XAML 处理器从 XAML 标记创建对象树时，运行时代码可以通过该名称引用 XAML 声明的对象。（继承自FrameworkElement）
16	不透明度获取或设置对象的不透明度程度。（继承自UIElement）
17 号	选定索引获取或设置所选项目的索引。（继承自选择器）
18	选定的项目获取或设置选定的项目。（继承自选择器）
19	选定值获取或设置通过使用 SelectedValuePath 获得的所选项目的值。（继承自选择器）
20	风格获取或设置在布局和渲染期间应用于此对象的实例 Style。（继承自FrameworkElement）
21	垂直对齐获取或设置当 FrameworkElement 在父对象（例如面板或项控件）中组成时应用到 FrameworkElement 的垂直对齐特征。（继承自FrameworkElement）
22	宽度获取或设置 FrameworkElement 的宽度。（继承自FrameworkElement）

下面给出了ListBox最常用的事件。

下面给出了 ListBox 最常用的事件。

先生。没有。	活动及描述
1	拖拽输入当输入系统报告以此元素为目标的基础拖动事件时发生。（继承自UIElement）
2	拖动离开当输入系统报告以此元素为原点的基础拖动事件时发生。（继承自UIElement）
3	拖拽当输入系统报告将此元素作为潜在放置目标的基础拖动事件时发生。（继承自UIElement）
4	拖动启动当启动拖动操作时发生。（继承自UIElement）
5	降低当输入系统报告将此元素作为放置目标的基础放置事件时发生。（继承自UIElement）
6	删除完成当拖放操作结束时发生。（继承自UIElement）
7	获得焦点当 UIElement 获得焦点时发生。（继承自UIElement）
8	已启用更改当 IsEnabled 属性更改时发生。（继承自Control）
9	按键按下当 UIElement 具有焦点时按下键盘按键时发生。（继承自UIElement）
10	按键向上当 UIElement 具有焦点时释放键盘按键时发生。（继承自UIElement）
11	失去焦点当 UIElement 失去焦点时发生。（继承自UIElement）
12	选择已更改当当前选定的项目更改时发生。（继承自选择器）
13	尺寸已改变当 FrameworkElement 上的 ActualHeight 或 ActualWidth 属性更改值时发生。（继承自FrameworkElement）

下面给出了 ListBox最常用的方法。

下面给出了 ListBox 最常用的方法。

先生。没有。	方法及说明
1	安排定位子对象并确定 UIElement 的大小。为其子元素实现自定义布局的父对象应从其布局覆盖实现中调用此方法，以形成递归布局更新。（继承自UIElement）
2	查找名称检索具有指定标识符名称的对象。（继承自FrameworkElement）
3	重点尝试将焦点设置在控件上。（继承自Control）
4	获取价值从 DependencyObject 返回依赖属性的当前有效值。（继承自DependencyObject）
5	容器索引返回具有指定的生成容器的项目的索引。（继承自ItemsControl）
6	拖拽输入时在 DragEnter 事件发生之前调用。（继承自Control）
7	拖拽离开时在 DragLeave 事件发生之前调用。（继承自Control）
8	拖拽时在 DragOver 事件发生之前调用。（继承自Control）
9	点滴在 Drop 事件发生之前调用。（继承自Control）
10	按键按下在 KeyDown 事件发生之前调用。（继承自Control）
11	按键上键在 KeyUp 事件发生之前调用。（继承自Control）
12	失去焦点时在 LostFocus 事件发生之前调用。（继承自Control）
13	读取本地值如果设置了本地值，则返回依赖项属性的本地值。（继承自DependencyObject）
14	设置绑定使用提供的绑定对象将绑定附加到 FrameworkElement。（继承自FrameworkElement）
15	设定值设置 DependencyObject 上依赖项属性的本地值。（继承自DependencyObject）

让我们看一个简单的示例，其中将不同的 UI 元素添加到ListBox中。

<UserControl x:Class = "ListBoxExample.MainPage" 
   xmlns = "http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
   xmlns:x = "http://schemas.microsoft.com/winfx/2006/xaml" 
   xmlns:d = "http://schemas.microsoft.com/expression/blend/2008" 
   xmlns:mc = "http://schemas.openxmlformats.org/markup-compatibility/2006"  
   mc:Ignorable = "d" d:DesignWidth = "640" d:DesignHeight = "480"> 
   
   <Grid x:Name = "LayoutRoot">
	
      <ListBox x:Name = "myList">
		
         <TextBlock Text = "First item" /> 
         <Button Content = "Second item" /> 
         <Path Fill = "Blue" Data = "M4,0 l-4,10 8,0z M15,0 l-4,10 8,0z M26,0 l4,10 8,0z" 
            Margin = "10" /> 
			
         <StackPanel Orientation = "Horizontal"> 
            <Ellipse Fill = "Red" Height = "30" Width = "100" /> 
            <TextBlock Text = "Name: " /> 
            <TextBox Width = "200" /> 
         </StackPanel>
			
         <TextBlock Text = "More..." /> 
			
      </ListBox> 
		
   </Grid>
	
</UserControl>

下面给出的是 C# 实现。

using System.Windows.Controls; 
 
namespace ListBoxExample { 

   public partial class MainPage : UserControl { 
	
      public MainPage() { 
         InitializeComponent();  
			
         myList.Items.Add("String entry"); 
         myList.Items.Add(new Button { Content = "Content entry" });  
      } 
   } 
}

编译并执行上述代码后，您将看到一个列表框，其中包含图形文本的混合，以及一个可以在其中键入文本的可编辑字段。

先生。没有。	控制和说明
1	日历和日期选择器 Calendar & DatePicker 代表一个控件，使用户能够使用可视日历显示来选择日期。它使用鼠标或键盘提供一些基本导航。
2	选项卡控件一种容器，将项目放入单独的选项卡中，并允许用户一次仅查看一个选项卡。它允许用户通过单击选项卡标题从许多不同的视图中进行选择。
3	弹出窗口此类在应用程序窗口的范围内将内容显示在现有内容之上。它是暂时显示在其他内容上。
4	工具提示工具提示表示一个控件，该控件创建一个弹出窗口，显示 GUI 中元素的信息。Silverlight 允许您将工具提示附加到任何控件。