Span 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Span : Inline[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Span : InlinePublic Class Span
Inherits Inline<Span .../>
-or-
<Span ...>
oneOrMoreInlines
</Span>
-or-
<Span ...>
mixedContent
</Span>
- 繼承
- 衍生
- 屬性
備註
你可以在 XAML 裡用 Span 作為物件元素來包圍文字。 這讓它能像你在 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 元素包含文字，但除此之外沒有任何屬性設定。
Note
支援將 XAML 內容（無論是標籤或文字）直接置入 Span 元素，因為 Span 表示其 Inline 屬性即為 XAML 內容屬性。 欲了解更多 XAML 內容屬性資訊，請參閱 XAML 語法指南中的「XAML 內容屬性」章節。
span 元素通常作為 InlineCollection 中的元素使用，無論是作為 段落 的子元素（成為 Paragraph.Inlines 的一部分），或作為另一個 Span 的內容（成為 Span.Inline 的一部分）。
張成 導出類別
Span 是多個衍生類別的父類別，這些類別定義了具有特定格式慣例的內嵌文字區域：
超連結 讓點擊行為導向 NavigateUri。 其他 Span 衍生的類別可以視為職業專屬的裝飾，並不會增加互動。
建構函式
| 名稱 | Description |
|---|---|
| Span() |
初始化一個新的 Span 類別實例。 |
屬性
| 名稱 | Description |
|---|---|
| AccessKey |
取得或設定此元素的存取金鑰。 (繼承來源 TextElement) |
| AccessKeyScopeOwner |
取得或設定一個來源元素，提供該元素的存取鍵作用域，即使該元素不在原始元素的視覺樹中。 (繼承來源 TextElement) |
| AllowFocusOnInteraction |
會獲得或設定一個值，指示該元素在使用者互動時是否自動獲得焦點。 (繼承來源 TextElement) |
| CharacterSpacing |
取得或設定字元間的均勻間距，單位為 1/1000 的 em。 (繼承來源 TextElement) |
| ContentEnd |
會得到一個 TextPointer ，代表元素中內容的結尾。 (繼承來源 TextElement) |
| ContentStart |
會取得一個 TextPointer ，代表元素中內容的起始。 (繼承來源 TextElement) |
| Dispatcher |
它總是在 Windows 應用程式 SDK 應用程式中回傳 |
| DispatcherQueue |
得到 |
| ElementEnd |
會得到一個 TextPointer ，代表元素結束後的位置。 (繼承來源 TextElement) |
| ElementStart |
會取得一個 TextPointer ，代表元素開始前的位置。 (繼承來源 TextElement) |
| ExitDisplayModeOnAccessKeyInvoked |
取得或設定一個值，指定在呼叫存取鍵時是否會關閉存取鍵顯示。 (繼承來源 TextElement) |
| FontFamily |
取得或設定元素內容的首選頂層字型家族。 (繼承來源 TextElement) |
| FontSize |
它會取得或設定元素內容的字型大小。 (繼承來源 TextElement) |
| FontStretch |
取得或設定字型在家族中要選擇的字型寬度。 (繼承來源 TextElement) |
| FontStyle |
取得或設定此元素內容的字體樣式。 (繼承來源 TextElement) |
| FontWeight |
取得或設定頂層字體權重，以便從該元素內容的字型家族中選擇。 (繼承來源 TextElement) |
| Foreground |
取得或設定筆 刷 套用到這個元素的內容上。 (繼承來源 TextElement) |
| Inlines |
會取得一個包含 Span 內容的頂層內聯元素的 InlineCollection。 |
| IsAccessKeyScope |
取得或設定一個值，指示元素是否定義其存取鍵作用域。 (繼承來源 TextElement) |
| IsTextScaleFactorEnabled |
取得或設定是否啟用自動文字放大（反映系統文字大小設定）。 (繼承來源 TextElement) |
| KeyTipHorizontalOffset |
取得或設定一個值，表示按鍵點與文字元素相對的左或右位置。 (繼承來源 TextElement) |
| KeyTipPlacementMode |
取得或設定一個值，指示鍵尖與文字元素相對於的位置。 (繼承來源 TextElement) |
| KeyTipVerticalOffset |
取得或設定一個值，表示鍵尖相對於文字元素的上下位置。 (繼承來源 TextElement) |
| Language |
取得或設定適用於 TextElement 的在地化/全球化語言資訊。 (繼承來源 TextElement) |
| Name |
取得或設定該物件的唯一識別碼。 名稱只能從 XAML 的初始解析中設定。 (繼承來源 TextElement) |
| TextDecorations |
取得或設定一個值，指示文字上所施加的裝飾。 (繼承來源 TextElement) |
| XamlRoot |
取得或設定該元素正在被查看的 XamlRoot。 (繼承來源 TextElement) |
方法
| 名稱 | Description |
|---|---|
| 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) |
事件
| 名稱 | Description |
|---|---|
| AccessKeyDisplayDismissed |
當存取鍵序列完成時，會通知控制單位應該隱藏存取鍵視覺。 (繼承來源 TextElement) |
| AccessKeyDisplayRequested |
當存取鍵序列啟動時，會通知控制單位應該顯示存取鍵視覺化。 (繼承來源 TextElement) |
| AccessKeyInvoked |
當使用者完成一個存取金鑰序列，通知元素應該呼叫存取金鑰動作時，會發生這種情況。 (繼承來源 TextElement) |