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 是一個流程內容項目，設計成使用專案符號或編號等標記來格式化。
建構函式
| 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 |
取得或設定 Block 專案所包含的任何 Floater 專案應重新定位的方向。 (繼承來源 Block) |
| CommandBindings |
取得與這個專案相關聯之 CommandBinding 物件的集合。 (繼承來源 ContentElement) |
| ContentEnd |
取得文字指標，表示 元素中內容的結尾。 (繼承來源 TextElement) |
| ContentStart |
取得文字指標，表示 元素中內容的開頭。 (繼承來源 TextElement) |
| ContextMenu |
取得或設定每當透過使用者介面 （UI） 從這個專案內要求操作功能表時，應該出現的操作功能表專案。 (繼承來源 FrameworkContentElement) |
| Cursor |
取得或設定游標，這個游標會在滑鼠指標位於這個專案上方時顯示。 (繼承來源 FrameworkContentElement) |
| DataContext |
取得或設定專案參與數據系結時的數據內容。 (繼承來源 FrameworkContentElement) |
| DefaultStyleKey |
取得或設定索引鍵，用來在主題中尋找此控件的樣式範本。 (繼承來源 FrameworkContentElement) |
| DependencyObjectType |
取得包裝這個實例 CLR 類型的 DependencyObjectType。 (繼承來源 DependencyObject) |
| Dispatcher |
取得與這個 DispatcherObject 相關聯的 Dispatcher。 (繼承來源 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 |
取得值，指出這個元素是否已初始化，方法是載入為Extensible Application Markup Language （XAML），或明確呼叫其 EndInit() 方法。 (繼承來源 FrameworkContentElement) |
| IsInputMethodEnabled |
取得值，這個值表示是否啟用輸入法編輯器 （IME） 等輸入法系統來處理這個項目的輸入。 (繼承來源 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，其中包含組成 List內容的 ListItem 專案。 |
| 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) |
