Span Klasse

Referenz

Definition

Namespace:: Windows.UI.Xaml.Documents

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Gruppiert andere Inlineinhaltselemente . Übergeordnete Klasse für Fett, Hyperlink, Kursiv und Unterstrichen.

/// [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>

Vererbung: Object IInspectable DependencyObject TextElement Inline Span

Abgeleitet: Windows.UI.Xaml.Documents.Bold

Windows.UI.Xaml.Documents.Hyperlink

Windows.UI.Xaml.Documents.Italic

Windows.UI.Xaml.Documents.Underline

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Sie können Span als Objektelement in XAML verwenden, um Text einzuschließen. Dies ermöglicht eine ähnliche Verwendung wie die Verwendung des span Tags in HTML. Für diese Verwendung würden Sie die von TextElement unterstützten Attribute wie FontSize oder FontFamily festlegen, sodass Sie diese Textformatierungsentscheidungen auf die eingeschlossene Textspanne anwenden können. Run verfügt über eine ähnliche Funktionalität beim Anwenden von TextElement-Eigenschaften auf einen Textbereich, aber Run unterstützt keinen gemischten Inhalt (die Run.Text XAML-Inhaltseigenschaft kann nur Text enthalten, nicht gemischten Inhalt und weitere Inlines).

Span unterstützt gemischte Inhalte, wenn Sie den Inhalt in XAML festlegen. Dies bedeutet, dass Sie Inlinetags wie Ausführen, Fett usw. mit XAML-Textinhalt (Nur-Text) mischen können, ohne einschränkungen in der Reihenfolge, in der Tags und Text angezeigt werden müssen. Der gesamte Text, egal ob nur Text oder in einem Inlinetag eingeschlossen, wird in der Reihenfolge gerendert, in der der Text im gemischten Inhalt definiert ist. Dies ist beispielsweise legaler XAML-Code:

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

Wenn gemischter Inhalt aus XAML analysiert und das Textobjektmodell zur Laufzeit untersucht wird, generiert jeder Textbereich, der aus dem Nur-Text stammt, ein Run-Objekt an der entsprechenden Lesereihenfolgeposition in der InlineCollection-Auflistungsklasse , die den Laufzeitzugriff ermöglicht. Dieses Run-Element enthält den Text, andernfalls sind keine Eigenschaften festgelegt.

Hinweis

Das Platzieren von XAML-Inhalten, unabhängig davon, ob Tags oder Text direkt in einem Span-Element platziert werden, wird unterstützt, da Span angibt, dass seine Inlines-Eigenschaft die XAML-Inhaltseigenschaft ist. Weitere Informationen zu XAML-Inhaltseigenschaften finden Sie im Abschnitt "XAML-Inhaltseigenschaften" des XAML-Syntaxhandbuchs.

Span-Elemente werden in der Regel als Elemente innerhalb einer InlineCollection verwendet, entweder als untergeordnete Elemente eines Absatzes (wird Teil von Paragraph.Inlines) oder als Inhalt einer anderen Span (wird Teil von Span.Inlines).

Abgeleitete Span-Klassen

Span ist die übergeordnete Klasse für mehrere abgeleitete Klassen, die einen Inlinetextbereich mit einer bestimmten Formatierungskonvention definieren:

Fett
Link
Kursiv
Hyperlink unterstrichen aktiviert ein Klickverhalten, das zum NavigateUri navigiert. Die anderen von Span abgeleiteten Klassen können als klassenspezifische Dekorationen für den Text betrachtet werden und fügen sonst keine Interaktion hinzu.

Konstruktoren

Span()

Initialisiert eine neue instance der Span-Klasse.

Eigenschaften

AccessKey	Ruft den Zugriffsschlüssel für dieses Element ab oder legt diesen fest. (Geerbt von TextElement)
AccessKeyScopeOwner	Ruft ein Quellelement ab, das den Zugriffsschlüsselbereich für dieses Element bereitstellt, auch wenn es sich nicht in der visuellen Struktur des Quellelements befindet, oder legt es fest. (Geerbt von TextElement)
AllowFocusOnInteraction	Ruft einen Wert ab, der angibt, ob das Element automatisch den Fokus erhält, wenn der Benutzer mit ihm interagiert, oder legt diesen fest. (Geerbt von TextElement)
CharacterSpacing	Ruft den einheitlichen Abstand zwischen Zeichen in Einheiten von 1/1000 eines em ab oder legt diese fest. (Geerbt von TextElement)
ContentEnd	Ruft einen TextPointer ab , der das Ende des Inhalts im -Element darstellt. (Geerbt von TextElement)
ContentStart	Ruft einen TextPointer ab, der den Anfang des Inhalts im -Element darstellt. (Geerbt von TextElement)
Dispatcher	Ruft den CoreDispatcher ab, dem dieses Objekt zugeordnet ist. CoreDispatcher stellt eine Funktion dar, die auf das DependencyObject im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
ElementEnd	Ruft einen TextPointer ab, der die Position direkt nach dem Ende des Elements darstellt. (Geerbt von TextElement)
ElementStart	Ruft einen TextPointer ab, der die Position kurz vor dem Start des Elements darstellt. (Geerbt von TextElement)
ExitDisplayModeOnAccessKeyInvoked	Ruft einen Wert ab, der angibt, ob die Anzeige der Zugriffsschlüssel beim Aufrufen eines Zugriffsschlüssels geschlossen wird, oder legt diesen fest. (Geerbt von TextElement)
FontFamily	Ruft die bevorzugte Schriftfamilie der obersten Ebene für den Inhalt des Elements ab oder legt sie fest. (Geerbt von TextElement)
FontSize	Ruft den Schriftgrad für den Inhalt des Elements ab oder legt ihn fest. (Geerbt von TextElement)
FontStretch	Ruft die Glyphenbreite der Schriftart in einer Familie ab, die ausgewählt werden soll, oder legt sie fest. (Geerbt von TextElement)
FontStyle	Ruft den Schriftstil für den Inhalt in diesem Element ab oder legt diesen fest. (Geerbt von TextElement)
FontWeight	Ruft die Schriftstärke der obersten Ebene ab, die aus der Schriftfamilie für den Inhalt in diesem Element ausgewählt werden soll, oder legt diese fest. (Geerbt von TextElement)
Foreground	Ruft den Pinsel ab, der auf den Inhalt in diesem Element angewendet werden soll, oder legt diesen fest. (Geerbt von TextElement)
Inlines	Ruft eine InlineCollection ab, die die Inlineelemente der obersten Ebene enthält, die den Inhalt von Span enthalten.
IsAccessKeyScope	Ruft einen Wert ab, der angibt, ob ein Element seinen eigenen Zugriffsschlüsselbereich definiert, oder legt diesen fest. (Geerbt von TextElement)
IsTextScaleFactorEnabled	Ruft ab oder legt fest, ob die automatische Textvergrößerung aktiviert ist, um die Einstellung für die Systemtextgröße widerzuspiegeln. (Geerbt von TextElement)
KeyTipHorizontalOffset	Ruft einen Wert ab, der angibt, wie weit links oder rechts die Keytip in Relation zum Textelement platziert wird, oder legt diesen fest. (Geerbt von TextElement)
KeyTipPlacementMode	Ruft einen Wert ab, der angibt, wo die KeyTip in Relation zum Textelement platziert wird, oder legt diesen fest. (Geerbt von TextElement)
KeyTipVerticalOffset	Ruft einen Wert ab, der angibt, wie weit nach oben oder unten die Keytip in Relation zum Textelement platziert wird, oder legt diesen fest. (Geerbt von TextElement)
Language	Ruft Lokalisierungs-/Globalisierungsspracheninformationen ab, die für ein TextElement gelten, oder legt diese fest. (Geerbt von TextElement)
Name	Ruft eine eindeutige Identifikation für das -Objekt ab oder legt diese fest. Der Name kann nur bei der anfänglichen Analyse von XAML festgelegt werden. (Geerbt von TextElement)
TextDecorations	Ruft einen Wert ab, der angibt, welche Dekorationen auf den Text angewendet werden, oder legt diesen fest. (Geerbt von TextElement)
XamlRoot	Ruft die XamlRoot ab, in der dieses Element angezeigt wird, oder legt diese fest. (Geerbt von TextElement)

Methoden

ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
FindName(String)	Ruft ein Objekt im Objektmodell-/Laufzeitobjektdiagramm ab, indem auf den x:Name - oder Name-Attributwert des Objekts verwiesen wird. (Geerbt von TextElement)
GetAnimationBaseValue(DependencyProperty)	Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft festgelegt wurde, was in Fällen gilt, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject)
OnDisconnectVisualChildren()	Überschreiben Sie diese Methode, um zu implementieren, wie sich Layout und Logik verhalten sollen, wenn Elemente aus einem klassenspezifischen Inhalt oder einer untergeordneten Eigenschaft entfernt werden. (Geerbt von TextElement)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor registriert wurde, indem RegisterPropertyChangedCallback aufgerufen wurde. (Geerbt von DependencyObject)

Ereignisse

AccessKeyDisplayDismissed	Tritt auf, wenn die Zugriffstastensequenz abgeschlossen ist, um Steuerelemente zu benachrichtigen, dass sie Zugriffstastenvisuals ausblenden sollen. (Geerbt von TextElement)
AccessKeyDisplayRequested	Tritt auf, wenn die Zugriffsschlüsselsequenz gestartet wird, um Steuerelemente zu benachrichtigen, dass sie Zugriffstastenvisuals anzeigen sollen. (Geerbt von TextElement)
AccessKeyInvoked	Tritt auf, wenn ein Benutzer eine Zugriffsschlüsselsequenz abschließt, um das Element zu benachrichtigen, dass die Zugriffstastenaktion aufgerufen werden soll. (Geerbt von TextElement)

Gilt für: