List 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供用于在有序列表或无序列表中呈现内容的功能的块级别流内容元素。
public ref class List : System::Windows::Documents::Block[System.Windows.Markup.ContentProperty("ListItems")]
public class List : System.Windows.Documents.Block[<System.Windows.Markup.ContentProperty("ListItems")>]
type List = class
inherit BlockPublic Class List
Inherits Block- 继承
- 属性
示例
以下示例演示如何使用 XAML 定义 List 。
<FlowDocument Background="GhostWhite">
<List MarkerOffset="25" MarkerStyle="UpperRoman" StartIndex="5">
<ListItem>
<Paragraph>Boron</Paragraph>
</ListItem>
<ListItem>
<Paragraph>Carbon</Paragraph>
</ListItem>
<ListItem>
<Paragraph>Nitrogen</Paragraph>
</ListItem>
<ListItem>
<Paragraph>Oxygen</Paragraph>
</ListItem>
<ListItem>
<Paragraph>Fluorine</Paragraph>
</ListItem>
<ListItem>
<Paragraph>Neon</Paragraph>
</ListItem>
</List>
</FlowDocument>
以下示例演示如何以编程方式创建和填充 List 。
List listx = new List();
// Set the space between the markers and list content to 25 DIP.
listx.MarkerOffset = 25;
// Use uppercase Roman numerals.
listx.MarkerStyle = TextMarkerStyle.UpperRoman;
// Start list numbering at 5.
listx.StartIndex = 5;
// Create the list items that will go into the list.
ListItem liV = new ListItem(new Paragraph(new Run("Boron")));
ListItem liVI = new ListItem(new Paragraph(new Run("Carbon")));
ListItem liVII = new ListItem(new Paragraph(new Run("Nitrogen")));
ListItem liVIII = new ListItem(new Paragraph(new Run("Oxygen")));
ListItem liIX = new ListItem(new Paragraph(new Run("Fluorine")));
ListItem liX = new ListItem(new Paragraph(new Run("Neon")));
// Finally, add the list items to the list.
listx.ListItems.Add(liV);
listx.ListItems.Add(liVI);
listx.ListItems.Add(liVII);
listx.ListItems.Add(liVIII);
listx.ListItems.Add(liIX);
listx.ListItems.Add(liX);
Dim listx As New List()
' Set the space between the markers and list content to 25 DIP.
listx.MarkerOffset = 25
' Use uppercase Roman numerals.
listx.MarkerStyle = TextMarkerStyle.UpperRoman
' Start list numbering at 5.
listx.StartIndex = 5
' Create the list items that will go into the list.
Dim liV As New ListItem(New Paragraph(New Run("Boron")))
Dim liVI As New ListItem(New Paragraph(New Run("Carbon")))
Dim liVII As New ListItem(New Paragraph(New Run("Nitrogen")))
Dim liVIII As New ListItem(New Paragraph(New Run("Oxygen")))
Dim liIX As New ListItem(New Paragraph(New Run("Fluorine")))
Dim liX As New ListItem(New Paragraph(New Run("Neon")))
' Finally, add the list items to the list.
listx.ListItems.Add(liV)
listx.ListItems.Add(liVI)
listx.ListItems.Add(liVII)
listx.ListItems.Add(liVIII)
listx.ListItems.Add(liIX)
listx.ListItems.Add(liX)
下图显示了此示例的呈现效果。
以下示例演示如何使用 XAML 在列表) 定义嵌套 List (列表。
<FlowDocument Background="GhostWhite">
<List MarkerOffset="25" MarkerStyle="UpperRoman" StartIndex="5">
<ListItem>
<Paragraph>Boron</Paragraph>
<List Margin="0" Padding="0" >
<ListItem Margin="40,0,0,0">
<Paragraph>Symbol: B</Paragraph>
</ListItem>
<ListItem Margin="40,0,0,0">
<Paragraph>Atomic Mass: 10.811</Paragraph>
</ListItem>
</List>
</ListItem>
<ListItem>
<Paragraph>Carbon</Paragraph>
<List Margin="0" Padding="0" >
<ListItem Margin="40,0,0,0">
<Paragraph>Symbol: C</Paragraph>
</ListItem>
<ListItem Margin="40,0,0,0">
<Paragraph>Atomic Mass: 12.0107</Paragraph>
</ListItem>
</List>
</ListItem>
<ListItem>
<Paragraph>Nitrogen</Paragraph>
<List Margin="0" Padding="0" >
<ListItem Margin="40,0,0,0">
<Paragraph>Symbol: N</Paragraph>
</ListItem>
<ListItem Margin="40,0,0,0">
<Paragraph>Atomic Mass: 14.00674</Paragraph>
</ListItem>
</List>
</ListItem>
<ListItem>
<Paragraph>Oxygen</Paragraph>
<List Margin="0" Padding="0" >
<ListItem Margin="40,0,0,0">
<Paragraph>Symbol: O</Paragraph>
</ListItem>
<ListItem Margin="40,0,0,0">
<Paragraph>Atomic Mass: 15.9994</Paragraph>
</ListItem>
</List>
</ListItem>
<ListItem>
<Paragraph>Fluorine</Paragraph>
<List Margin="0" Padding="0" >
<ListItem Margin="40,0,0,0">
<Paragraph>Symbol: F</Paragraph>
</ListItem>
<ListItem Margin="40,0,0,0">
<Paragraph>Atomic Mass: 18.9984032</Paragraph>
</ListItem>
</List>
</ListItem>
<ListItem>
<Paragraph>Neon</Paragraph>
<List Margin="0" Padding="0" >
<ListItem Margin="40,0,0,0">
<Paragraph>Symbol: Ne</Paragraph>
</ListItem>
<ListItem Margin="40,0,0,0">
<Paragraph>Atomic Mass: 20.1797</Paragraph>
</ListItem>
</List>
</ListItem>
</List>
</FlowDocument>
下图显示了此示例的呈现效果。
注解
List 为子内容强制实施强内容模型。 有关内容模型的详细信息List，请参阅 TextElement 内容模型概述。
List 是设计为使用项目符号或编号等标记设置格式的流内容元素。
ListItem 元素是 元素的唯一 List 允许子元素。
构造函数
| List() |
初始化 List 类的新的空实例。 |
| List(ListItem) |
字段
| MarkerOffsetProperty |
标识 MarkerOffset 依赖项属性。 |
| MarkerStyleProperty |
标识 MarkerStyle 依赖项属性。 |
| StartIndexProperty |
标识 StartIndex 依赖项属性。 |
属性
| AllowDrop |
获取或设置一个值，该值指示此元素能否用作拖放操作的目标。 (继承自 ContentElement) |
| AreAnyTouchesCaptured |
获取一个值，该值指示在此元素上是否至少捕获了一次触摸。 (继承自 ContentElement) |
| AreAnyTouchesCapturedWithin |
获取一个值，该值指示在此元素或其可视化树中的任何子元素上是否至少捕获了一次触摸。 (继承自 ContentElement) |
| AreAnyTouchesDirectlyOver |
获取一个值，该值指示在此元素上是否至少按下了一次触摸设备。 (继承自 ContentElement) |
| AreAnyTouchesOver |
获取一个值，该值指示在此元素或其可视化树中的任何子元素上是否至少按下了一次触摸设备。 (继承自 ContentElement) |
| Background |
获取或设置用于填充内容区域背景的画笔。 (继承自 TextElement) |
| BindingGroup |
获取或设置用于该元素的 BindingGroup。 (继承自 FrameworkContentElement) |
| BorderBrush |
获取或设置绘制元素边框时使用的 Brush。 (继承自 Block) |
| BorderThickness |
获取或设置元素的边框粗细。 (继承自 Block) |
| BreakColumnBefore |
获取或设置一个值，该值指示当元素参与使用了分栏的内容呈现时，是否自动在此元素之前插入一个分栏符。 (继承自 Block) |
| BreakPageBefore |
获取或设置一个值，该值指示是否自动在此元素之前插入一个分页符。 (继承自 Block) |
| ClearFloaters |
获取或设置某个 Floater 元素所包含的任何 Block 元素的重新定位方向。 (继承自 Block) |
| CommandBindings |
获取与此元素关联的 CommandBinding 对象的集合。 (继承自 ContentElement) |
| ContentEnd |
获取表示元素中内容末尾的文本指针。 (继承自 TextElement) |
| ContentStart |
获取表示元素中内容开头的文本指针。 (继承自 TextElement) |
| ContextMenu |
获取或设置上下文菜单元素，每当通过用户界面 (UI 从此元素内) 请求上下文菜单时，应显示该元素。 (继承自 FrameworkContentElement) |
| Cursor |
获取或设置在鼠标指针位于此元素上时显示的光标。 (继承自 FrameworkContentElement) |
| DataContext |
获取或设置元素参与数据绑定时的数据上下文。 (继承自 FrameworkContentElement) |
| DefaultStyleKey |
获取或设置用于在主题中查找此控件的样式模板的键。 (继承自 FrameworkContentElement) |
| DependencyObjectType |
DependencyObjectType获取包装此实例的 CLR 类型的 。 (继承自 DependencyObject) |
| Dispatcher |
获取与此 Dispatcher 关联的 DispatcherObject。 (继承自 DispatcherObject) |
| ElementEnd |
获取表示紧接元素末尾之后位置的文本指针。 (继承自 TextElement) |
| ElementStart |
获取表示紧邻元素开头之前位置的文本指针。 (继承自 TextElement) |
| FlowDirection |
获取或设置 Block 元素中内容流的相对方向。 (继承自 Block) |
| Focusable |
获取或设置一个值，该值指示元素能否得到焦点。 (继承自 ContentElement) |
| FocusVisualStyle |
获取或设置一个对象，该对象允许自定义此元素在捕获到键盘焦点时要应用于此元素的外观、效果或其他样式特征。 (继承自 FrameworkContentElement) |
| FontFamily |
获取或设置元素内容的首选顶级字体系列。 (继承自 TextElement) |
| FontSize |
获取或设置元素内容的字体大小。 (继承自 TextElement) |
| FontStretch |
获取或设置元素内容的字体拉伸特征。 (继承自 TextElement) |
| FontStyle |
获取或设置元素内容的字体样式。 (继承自 TextElement) |
| FontWeight |
获取或设置元素内容的顶级字体粗细。 (继承自 TextElement) |
| ForceCursor |
获取或设置一个值，该值指示这 FrameworkContentElement 是否应强制用户界面 (UI) 呈现此实例的 属性声明的 Cursor 游标。 (继承自 FrameworkContentElement) |
| Foreground |
获取或设置要应用于 元素内容的画笔。 (继承自 TextElement) |
| HasAnimatedProperties |
获取一个值，该值指示此元素是否具有任何进行动画处理的属性。 (继承自 ContentElement) |
| InputBindings |
获取与此元素关联的输入绑定的集合。 (继承自 ContentElement) |
| InputScope |
获取或设置此 FrameworkContentElement 使用的输入的上下文。 (继承自 FrameworkContentElement) |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面 (UI) 中启用此元素。 (继承自 ContentElement) |
| IsEnabledCore |
获取一个值，该值成为派生类中 IsEnabled 的返回值。 (继承自 ContentElement) |
| IsFocused |
获取一个值，该值确定此元素是否具有逻辑焦点。 (继承自 ContentElement) |
| IsHyphenationEnabled |
获取或设置一个值，该值指示是否启用文字的自动断字功能。 (继承自 Block) |
| IsInitialized |
获取一个值，该值指示此元素是否已初始化，方法是加载为可扩展应用程序标记语言 (XAML) ，或者显式调用其 EndInit() 方法。 (继承自 FrameworkContentElement) |
| IsInputMethodEnabled |
获取一个值，该值指示是否启用输入法系统（例如输入法编辑器 (输入法) ）来处理此元素的输入。 (继承自 ContentElement) |
| IsKeyboardFocused |
获取一个值，该值表示此元素是否具有键盘焦点。 (继承自 ContentElement) |
| IsKeyboardFocusWithin |
获取一个值，该值指示键盘焦点是否位于元素或子元素内的任意位置。 (继承自 ContentElement) |
| IsLoaded |
获取一个值，该值指示是否已加载此元素以供显示。 (继承自 FrameworkContentElement) |
| IsMouseCaptured |
获取一个值，该值指示此元素是否捕获了鼠标。 (继承自 ContentElement) |
| IsMouseCaptureWithin |
获取一个值，该值确定此元素或其元素树中的子元素是否有鼠标捕获。 (继承自 ContentElement) |
| IsMouseDirectlyOver |
获取一个值，该值指示在考虑元素组合的情况下，鼠标指针的位置是否与命中测试结果相对应。 (继承自 ContentElement) |
| IsMouseOver |
获取一个值，该值指示鼠标指针是否位于此元素（包括可视子元素或其控件组合）上。 (继承自 ContentElement) |
| IsSealed |
获取一个值，该值指示此实例当前是否为密封的（只读）。 (继承自 DependencyObject) |
| IsStylusCaptured |
获取一个值，该值指示是否将触笔捕获到此元素。 (继承自 ContentElement) |
| IsStylusCaptureWithin |
获取一个值，该值确定此元素（包括子元素和控件组合）是否具有触笔捕获。 (继承自 ContentElement) |
| IsStylusDirectlyOver |
获取一个值，该值指示在考虑元素组合的情况下，触笔的位置是否与命中测试结果相对应。 (继承自 ContentElement) |
| IsStylusOver |
获取一个值，该值指示触笔是否位于此元素（包括可视子元素）上。 (继承自 ContentElement) |
| Language |
获取或设置应用于单个元素的本地化/全球化语言信息。 (继承自 FrameworkContentElement) |
| LineHeight |
获取或设置各行内容的高度。 (继承自 Block) |
| LineStackingStrategy |
获取或设置为块级别流内容元素内的每行文本确定行框的方式。 (继承自 Block) |
| ListItems |
获取一个 ListItemCollection，其中包含组成 ListItem 的内容的 List 元素。 |
| LogicalChildren |
获取一个可用于迭代该元素的逻辑子元素的枚举数。 (继承自 TextElement) |
| Margin |
获取或设置元素的边距粗细。 (继承自 Block) |
| MarkerOffset |
获取或设置每个 ListItem 元素内容与列表标记近边缘之间的所需距离。 |
| MarkerStyle |
获取或设置 List 的标记样式。 |
| Name |
获取或设置元素的标识名称。 该名称提供实例引用，以便在分析 XAML 期间构造元素后，编程代码隐藏（如事件处理程序代码）可以引用该元素。 (继承自 FrameworkContentElement) |
| NextBlock |
获取紧随当前 Block 元素之后的同级 Block 元素。 (继承自 Block) |
| OverridesDefaultStyle |
获取或设置一个值，该值指示此元素是否合并了主题样式的样式属性。 (继承自 FrameworkContentElement) |
| Padding |
获取或设置元素的填充厚度。 (继承自 Block) |
| Parent |
获取此元素的逻辑树中的父级。 (继承自 FrameworkContentElement) |
| PreviousBlock |
获取紧邻当前 Block 元素之前的同级 Block 元素。 (继承自 Block) |
| Resources |
获取或设置当前本地定义的资源字典。 (继承自 FrameworkContentElement) |
| SiblingBlocks |
获取一个 Block 元素的集合，这些元素是当前 Block 元素的同级元素。 (继承自 Block) |
| StartIndex |
获取或设置用于标记有序列表中的项的起始索引。 |
| Style |
获取或设置此元素要使用的样式。 (继承自 FrameworkContentElement) |
| Tag |
获取或设置任意对象值，该值可用于存储关于此元素的自定义信息。 (继承自 FrameworkContentElement) |
| TemplatedParent |
获取对此元素的模板父级的引用。 如果该元素不是通过模板创建的，则此属性无关。 (继承自 FrameworkContentElement) |
| TextAlignment |
获取或设置文本内容的水平对齐方式。 (继承自 Block) |
| TextEffects |
获取或设置应用于元素内容的文本效果集合。 (继承自 TextElement) |
| ToolTip |
获取或设置用户界面 (UI) 中为此元素显示的工具提示对象。 (继承自 FrameworkContentElement) |
| TouchesCaptured |
获取在此元素上捕获的所有触摸设备。 (继承自 ContentElement) |
| TouchesCapturedWithin |
获取在此元素或其可视化树中的任何子元素上捕获的所有触摸设备。 (继承自 ContentElement) |
| TouchesDirectlyOver |
获取此元素上的所有触摸设备。 (继承自 ContentElement) |
| TouchesOver |
获取在此元素或其可视化树中的任何子元素上的所有触摸设备。 (继承自 ContentElement) |
| Typography |
获取该元素内容的当前有效的版式变体。 (继承自 TextElement) |
方法
事件
显式接口实现
| IAddChild.AddChild(Object) |
添加子对象。 (继承自 TextElement) |
| IAddChild.AddText(String) |
将节点的文本内容添加到对象。 (继承自 TextElement) |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
有关此成员的说明，请参见 IsAmbientPropertyAvailable(String) 方法。 (继承自 FrameworkContentElement) |
