WPF 內容模型

Windows Presentation Foundation (WPF) 是展示平台，提供許多以顯示不同類型內容為主要目的的控制項和類似控制項的類型。 為了判斷要使用哪一種控制項或從哪一種控制項衍生，您應該了解特定控制項顯示哪些物件的效果最佳。

本主題摘要說明 WPF 控制項和類似控制項的類型所適用的內容模型。 內容模型描述控制項中可使用的內容。本主題同時列出每一個內容模型的內容屬性。 內容屬性是一種用於儲存物件內容的屬性。

這個主題包含下列章節。

• 包含任意內容的類別
• 包含 UIElement 物件集合的類別
• 影響 UIElement 外觀的類別
• 提供 UIElement 相關視覺化回應的類別
• 可讓使用者輸入文字的類別
• 顯示文字的類別
• 格式化文字的類別
• 相關主題

包含任意內容的類別

某些控制項可以包含任何類型的物件，例如字串、DateTime 物件，或是本身為其他項目之容器的 UIElement。 例如，Button 可以包含影像和某些文字；或是 CheckBox 可以包含 DateTime.Now 的值。

WPF 有四種可包含任意內容的類別。 下表列出繼承自 Control 的類別。

繼承自這些類別的控制項可以包含相同類型的內容，並且以相同方式處理內容。 下圖顯示每個內容模型中一個內含影像和某些文字的控制項。

包含單一任意物件的控制項

ContentControl 類別包含單獨一項任意內容。 其內容屬性為 Content。 下列控制項繼承自 ContentControl 並且使用其內容模型：

• Button

• ButtonBase

• CheckBox

• ComboBoxItem

• ContentControl

• Frame

• GridViewColumnHeader

• GroupItem

• Label

• ListBoxItem

• ListViewItem

• NavigationWindow

• RadioButton

• RepeatButton

• ScrollViewer

• StatusBarItem

• ToggleButton

• ToolTip

• UserControl

• Window

下圖顯示四個按鈕，其 Content 設為字串、DateTime 物件、Rectangle，以及包含 Ellipse 和 TextBlock 的 Panel。

這四個按鈕擁有不同類型的內容

如需如何設定 Content 屬性的範例，請參閱 ContentControl。

包含標頭和單一任意物件的控制項

HeaderedContentControl 類別繼承自 ContentControl，並且會顯示包含標頭的內容。 它會從 ContentControl 繼承內容屬性 Content，並且定義 Object 型別的 Header 屬性，因此兩者都可以是任意物件。

下列控制項繼承自 HeaderedContentControl 並且使用其內容模型：

• Expander

• GroupBox

• TabItem

下圖顯示兩個 TabItem 物件。 第一個 TabItem 擁有 UIElement 物件做為 Header 和 Content。 Header 設定為 StackPanel，其中包含 Ellipse 和 TextBlock。 Content 設定為 StackPanel，其中包含 TextBlock 和 Label。 第二個 TabItem 在 Header 中擁有字串，而且在 Content 中擁有 TextBlock。

在 Header 屬性中使用不同類型的 TabControl

如需如何建立 TabItem 物件的範例，請參閱 HeaderedContentControl。

包含任意物件集合的控制項

ItemsControl 類別繼承自 Control，並且可以包含多個項目 (Item)，例如字串、物件或其他項目 (Element)。 其內容屬性為 ItemsSource 和 Items。 ItemsSource 通常用來將資料集合填入 ItemsControl。 如果您不想要使用集合填入 ItemsControl，可以使用 Items 屬性加入項目。

下列控制項繼承自 ItemsControl 並且使用其內容模型：

• Menu

• MenuBase

• ContextMenu

• ComboBox

• ItemsControl

• ListBox

• ListView

• TabControl

• TreeView

• Selector

• StatusBar

下圖顯示的 ListBox 包含這些類型的項目：

• 字串。

• DateTime 物件。

• UIElement。

• 包含 Ellipse 和 TextBlock 的 Panel。

包含多種類型物件的 ListBox

包含標頭和任意物件集合的控制項

HeaderedItemsControl 類別繼承自 ItemsControl，並且可以包含多個項目 (Item)，例如字串、物件或其他項目 (Element) 及標題。 它會繼承 ItemsControl 內容屬性、ItemsSource 和 Items，並且定義可以是任意物件的 Header 屬性。

下列控制項繼承自 HeaderedItemsControl 並且使用其內容模型：

• MenuItem

• ToolBar

• TreeViewItem

包含 UIElement 物件集合的類別

Panel 類別會定位和排列子 UIElement 物件。 其內容屬性為 Children。

下列類別繼承自 Panel 類別，並且使用其內容模型：

• Canvas

• DockPanel

• Grid

• TabPanel

• ToolBarOverflowPanel

• ToolBarPanel

• UniformGrid

• StackPanel

• VirtualizingPanel

• VirtualizingStackPanel

• WrapPanel

如需詳細資訊，請參閱 面板概觀。

影響 UIElement 外觀的類別

Decorator 類別會將視覺效果套用至單一子 UIElement 上或周圍。 其內容屬性為 Child。 下列類別繼承自 Decorator 並且使用其內容模型：

• AdornerDecorator

• Border

• BulletDecorator

• ButtonChrome

• ClassicBorderDecorator

• InkPresenter

• ListBoxChrome

• SystemDropShadowChrome

• Viewbox

下圖顯示周圍有 Border (以其做為裝飾) 的 TextBox。

擁有框線的 TextBlock

提供 UIElement 相關視覺化回應的類別

Adorner 類別會對使用者提供視覺提示。 例如，使用 Adorner 可將功能控點加入至項目，或提供有關控制項的狀態資訊。 Adorner 類別會提供架構，讓您建立自己的裝飾項。 WPF 不會提供任何實作的裝飾項。 如需詳細資訊，請參閱 裝飾項概觀。

可讓使用者輸入文字的類別

WPF 提供三種可讓使用者輸入文字的主要控制項。 每一個控制項都會以不同方式顯示文字。 下表列出這三個文字相關控制項、其顯示文字時的功能，以及包含控制項文字的屬性。

顯示文字的類別

有數種類別可用來顯示純文字或格式化文字。 您可以使用 TextBlock 顯示數量較少的文字。 如果您要顯示大量文字，請使用 FlowDocumentReader、FlowDocumentPageViewer 或 FlowDocumentScrollViewer 控制項。

TextBlock 有兩個內容屬性：Text 和 Inlines。 當您要顯示使用一致格式設定的文字時，Text 屬性常是您最佳的選擇。 如果您打算在整個文字上使用不同的格式設定，請使用 Inlines 屬性。 Inlines 屬性是 Inline 物件的集合，會指定如何格式化文字。

下表列出 FlowDocumentReader、FlowDocumentPageViewer 及 FlowDocumentScrollViewer 等類別的內容屬性。

FlowDocument 會實作 IDocumentPaginatorSource 介面；因此這三種類別都可以採用 FlowDocument 做為內容。

格式化文字的類別

TextElement 及其相關類別可讓您格式化文字。 TextElement 物件包含 TextBlock 和 FlowDocument 物件中的文字，並且會將文字格式化。 TextElement 物件的兩種主要型別為 Block 項目和 Inline 項目。 Block 項目表示文字區塊，例如段落或清單。 Inline 項目表示區塊中一部分的文字。 許多 Inline 類別會指定可套用的文字格式。 每個 TextElement 都有自己的內容模型。 如需詳細資訊，請參閱 TextElement 內容模型概觀。

請參閱

其他資源

WPF 基本概念