Span 類別

定義

命名空間:

Windows.UI.Xaml.Documents

將其他 內嵌 內容專案分組。 Bold、Hyperlink、Italic和Underline的父類別。

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
class Span : Inline

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
public class Span : Inline

Public Class Span
Inherits Inline

<Span .../>
-or-
<Span ...>
  oneOrMoreInlines
</Span>
-or-
<Span ...>
  mixedContent
</Span>

繼承

Object IInspectable DependencyObject TextElement Inline Span

衍生

Windows.UI.Xaml.Documents.Bold

Windows.UI.Xaml.Documents.Hyperlink

Windows.UI.Xaml.Documents.Italic

Windows.UI.Xaml.Documents.Underline

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

您可以使用 Span 做為 XAML 中的物件專案來括住文字。 這可讓您使用 HTML 標籤的方式 span 類似。 針對此用法，您會設定 TextElement 所支援的屬性，例如 FontSize 或 FontFamily，讓您可以將這些文字格式設定決策套用至文字的封閉範圍。 Run 具有將 TextElement 屬性套用至一系列文字的類似功能，但 Run 不支援混合內容 (其 Run.Text XAML 內容屬性只能包含文字，而不能包含混合內容，以及進一步內嵌) 。

如果您以 XAML 設定內容，Span 支援混合內容。 這表示您可以混合 內嵌 標籤，例如 Run、 Bold 等等與 XAML 文字內容， (純文字) ，而且標記與文字必須出現的順序沒有任何限制。 純文字或內 嵌 標籤中括住的所有文字，都會以混合內容中定義文字的順序呈現。 例如，這是合法的 XAML：

<RichTextBlock>
  <Paragraph>
    <Span>This is <Bold>mixed content</Bold> with multiple text areas <Italic> and inlines</Italic>.</Span>
  </Paragraph>
</RichTextBlock>

從 XAML 剖析混合內容，並在執行時間檢查文字物件模型時，來自純文字的任何文字區域都會在InlineCollection集合類別中適當的讀取順序位置產生Run物件，以啟用執行時間存取。 該 Run 元素包含文字，但未設定任何屬性。

注意

因為 Span 表示其 Inlines 屬性是 XAML 內容屬性，所以支援直接在 Span 元素內放置 XAML 內容。 For more info on XAML content properties, see "XAML content properties" section of XAML syntax guide.

Span 元素通常用來做為InlineCollection內的元素，可能是 Paragraph (的子項目會成為Paragraph.Inlines) 的一部分，或當另一個 Span (的內容變成Span.Inlines) 的一部分。

跨越 衍生類別

Span 是數個衍生類別的父類別，可定義具有特定格式慣例的內嵌文字區域：

• 粗體字
• 超連結
• 斜體
• 底線超連結 可啟用流覽至 NavigateUri的按一下行為。 其他 Span 衍生類別可以視為文字的類別特有裝飾，否則不會新增互動。

建構函式

Span()

初始化 Span 類別的新實例。

屬性

AccessKey	取得或設定這個專案的存取索引鍵。 (繼承來源 TextElement)
AccessKeyScopeOwner	取得或設定來源專案，這個元素會提供這個專案的存取索引鍵範圍，即使它不在來源專案的視覺化樹狀結構中也一樣。 (繼承來源 TextElement)
AllowFocusOnInteraction	取得或設定值，這個值表示當使用者與其互動時，專案是否會自動取得焦點。 (繼承來源 TextElement)
CharacterSpacing	取得或設定字元之間的統一間距，單位為 em 的 1/1000。 (繼承來源 TextElement)
ContentEnd	取得 TextPointer ，表示 專案中內容的結尾。 (繼承來源 TextElement)
ContentStart	取得 TextPointer ，表示 專案中內容的開頭。 (繼承來源 TextElement)
Dispatcher	取得與此物件相關聯的 CoreDispatcher 。 CoreDispatcher代表可以存取 UI 執行緒上DependencyObject的功能，即使程式碼是由非 UI 執行緒起始也一樣。 (繼承來源 DependencyObject)
ElementEnd	取得 TextPointer ，表示專案結尾之後的位置。 (繼承來源 TextElement)
ElementStart	取得 TextPointer ，表示專案開頭之前的位置。 (繼承來源 TextElement)
ExitDisplayModeOnAccessKeyInvoked	取得或設定值，指定叫用存取金鑰時是否關閉存取金鑰顯示。 (繼承來源 TextElement)
FontFamily	取得或設定項目內容慣用的最上層字型家族。 (繼承來源 TextElement)
FontSize	取得或設定項目內容的字型大小。 (繼承來源 TextElement)
FontStretch	取得或設定要選取之系列中字型的字元寬度。 (繼承來源 TextElement)
FontStyle	取得或設定這個專案中內容的字型樣式。 (繼承來源 TextElement)
FontWeight	取得或設定最上層字型粗細，以從這個專案中內容的字型系列中選取。 (繼承來源 TextElement)
Foreground	取得或設定要套用至這個專案中內容的 Brush 。 (繼承來源 TextElement)
Inlines	取得 InlineCollection ，其中包含 包含 Span內容的最上層內嵌專案。
IsAccessKeyScope	取得或設定值，這個值表示專案是否定義自己的存取金鑰範圍。 (繼承來源 TextElement)
IsTextScaleFactorEnabled	取得或設定是否啟用自動放大文字，以反映系統文字大小設定。 (繼承來源 TextElement)
KeyTipHorizontalOffset	取得或設定值，這個值表示相對於文字元素放置索引鍵提示的左邊或右邊。 (繼承來源 TextElement)
KeyTipPlacementMode	取得或設定值，這個值表示 KeyTip 相對於文字元素的位置。 (繼承來源 TextElement)
KeyTipVerticalOffset	取得或設定值，這個值表示相對於文字元素放置索引鍵提示的上下距離。 (繼承來源 TextElement)
Language	取得或設定適用于 TextElement的當地語系化/全球化語言資訊。 (繼承來源 TextElement)
Name	取得或設定 物件的唯一識別。 名稱只能從 XAML 的初始剖析設定。 (繼承來源 TextElement)
TextDecorations	取得或設定值，這個值表示哪些裝飾會套用至文字。 (繼承來源 TextElement)
XamlRoot	取得或設定正在檢視這個專案的 XamlRoot。 (繼承來源 TextElement)

方法

ClearValue(DependencyProperty)	清除相依性屬性的本機值。 (繼承來源 DependencyObject)
FindName(String)	藉由參考物件的 x：Name 或 Name 屬性值，擷取物件模型中的物件/ 執行時間物件圖形。 (繼承來源 TextElement)
GetAnimationBaseValue(DependencyProperty)	傳回針對相依性屬性所建立的任何基底值，如果動畫未使用中，則會套用。 (繼承來源 DependencyObject)
GetValue(DependencyProperty)	從 DependencyObject傳回相依性屬性的目前有效值。 (繼承來源 DependencyObject)
OnDisconnectVisualChildren()	覆寫這個方法，以實作從類別特定內容或子屬性移除專案時，配置和邏輯的行為。 (繼承來源 TextElement)
ReadLocalValue(DependencyProperty)	如果已設定本機值，則傳回相依性屬性的本機值。 (繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	註冊通知函式，以接聽此DependencyObject實例上特定DependencyProperty的變更。 (繼承來源 DependencyObject)
SetValue(DependencyProperty, Object)	在 DependencyObject上設定相依性屬性的本機值。 (繼承來源 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消先前透過呼叫 RegisterPropertyChangedCallback註冊的變更通知。 (繼承來源 DependencyObject)

事件

AccessKeyDisplayDismissed	發生于存取金鑰序列完成以通知控制項應該隱藏存取金鑰視覺效果時。 (繼承來源 TextElement)
AccessKeyDisplayRequested	發生于啟動存取金鑰序列以通知控制項應該顯示存取金鑰視覺效果時。 (繼承來源 TextElement)
AccessKeyInvoked	發生于使用者完成存取金鑰序列以通知專案應該叫用存取金鑰動作時。 (繼承來源 TextElement)

另請參閱

• Inline
• Paragraph