Span Klasse
Definition
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.
Gruppiert andere Inlineinhaltselemente . Übergeordnete Klasse für "Bold", "Hyperlink", " Kursiv " und " Unterstrichen".
/// [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>
- Vererbung
- Abgeleitet
- Attribute
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 legen Sie die Attribute fest, die von TextElement wie FontSize oder FontFamily unterstützt werden, damit Sie diese Textformatierungsentscheidungen auf die eingeschlossene Textspanne anwenden können.
Run verfügt über ähnliche Funktionen zum Anwenden von TextElement-Eigenschaften auf einen Textbereich, aber Run unterstützt keine gemischten Inhalte (die Run.Text XAML-Inhaltseigenschaft kann nur Text, nicht gemischten Inhalt und weitere Inlines enthalten).
Span unterstützt gemischte Inhalte, wenn Sie den Inhalt in XAML festlegen. Dies bedeutet, dass Sie Inlinetags wie "Ausführen", " Fett" usw. mit XAML-Textinhalten (Nur-Text) kombinieren können, ohne Dass die Reihenfolge, in der Tags im Vergleich zu Text angezeigt werden müssen. Der gesamte Text, unabhängig davon, ob nur Text oder in ein Inlinetag eingeschlossen ist, wird in der Reihenfolge gerendert, in der der Text im gemischten Inhalt definiert ist. Dies ist z. B. rechtliches XAML:
<RichTextBlock>
<Paragraph>
<Span>This is <Bold>mixed content</Bold> with multiple text areas <Italic> and inlines</Italic>.</Span>
</Paragraph>
</RichTextBlock>
Wenn gemischte Inhalte aus XAML analysiert werden 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, hat aber andernfalls keine Eigenschaften festgelegt.
Hinweis
Das Platzieren von XAML-Inhalten, unabhängig davon, ob Tags oder Text direkt in einem Span-Element vorhanden sind, wird unterstützt, da Span angibt, dass die 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:
Link 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 andernfalls keine Interaktion hinzufügen.
Konstruktoren
| Name | Beschreibung |
|---|---|
| Span() |
Initialisiert eine neue Instanz der Span-Klasse . |
Eigenschaften
| Name | Beschreibung |
|---|---|
| AccessKey |
Dient zum Abrufen oder Festlegen der Zugriffstaste für dieses Element. (Geerbt von TextElement) |
| AccessKeyScopeOwner |
Dient zum Abrufen oder Festlegen eines Quellelements, das den Zugriffstastenbereich für dieses Element bereitstellt, auch wenn es sich nicht in der visuellen Struktur des Quellelements befindet. (Geerbt von TextElement) |
| AllowFocusOnInteraction |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element automatisch den Fokus erhält, wenn der Benutzer damit interagiert. (Geerbt von TextElement) |
| CharacterSpacing |
Ruft den gleichmäßigen Abstand zwischen Zeichen in Einheiten von 1/1000 einer Em ab oder legt den einheitlichen Abstand fest. (Geerbt von TextElement) |
| ContentEnd |
Ruft einen TextPointer , der das Ende des Inhalts im Element darstellt. (Geerbt von TextElement) |
| ContentStart |
Ruft einen TextPointer , der den Anfang des Inhalts im Element darstellt. (Geerbt von TextElement) |
| Dispatcher |
Gibt immer in einer Windows App SDK-App zurück |
| DispatcherQueue |
Ruft ab |
| ElementEnd |
Ruft einen TextPointer , der die Position direkt nach dem Ende des Elements darstellt. (Geerbt von TextElement) |
| ElementStart |
Ruft einen TextPointer , der die Position unmittelbar vor dem Start des Elements darstellt. (Geerbt von TextElement) |
| ExitDisplayModeOnAccessKeyInvoked |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Zugriffstastenanzeige geschlossen wird, wenn eine Zugriffstaste aufgerufen wird. (Geerbt von TextElement) |
| FontFamily |
Ruft die bevorzugte Schriftfamilie der obersten Ebene für den Inhalt des Elements ab oder legt diese fest. (Geerbt von TextElement) |
| FontSize |
Dient zum Abrufen oder Festlegen des Schriftgrads für den Inhalt des Elements. (Geerbt von TextElement) |
| FontStretch |
Dient zum Abrufen oder Festlegen der Glyphebreite der Schriftart in einer Familie, die ausgewählt werden soll. (Geerbt von TextElement) |
| FontStyle |
Dient zum Abrufen oder Festlegen des Schriftschnitts für den Inhalt in diesem Element. (Geerbt von TextElement) |
| FontWeight |
Dient zum Abrufen oder Festlegen der Schriftstärke der obersten Ebene, die aus der Schriftartfamilie für den Inhalt in diesem Element ausgewählt werden soll. (Geerbt von TextElement) |
| Foreground |
Dient zum Abrufen oder Festlegen des Pinsels , der auf den Inhalt in diesem Element angewendet werden soll. (Geerbt von TextElement) |
| Inlines |
Ruft eine InlineCollection mit den Inlineelementen der obersten Ebene ab, die den Inhalt von Span enthalten. |
| IsAccessKeyScope |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Element seinen eigenen Zugriffstastenbereich definiert. (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 |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie weit links oder rechts die Zugriffstasteninfo im Verhältnis zum Textelement platziert wird. (Geerbt von TextElement) |
| KeyTipPlacementMode |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, wo die Zugriffstasteninfo im Verhältnis zum Textelement platziert wird. (Geerbt von TextElement) |
| KeyTipVerticalOffset |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie weit nach oben oder unten die Zugriffstasteninfo im Verhältnis zum Textelement platziert wird. (Geerbt von TextElement) |
| Language |
Ruft Lokalisierungs-/Globalisierungsspracheninformationen ab, die für ein TextElement gelten, oder legt diese fest. (Geerbt von TextElement) |
| Name |
Dient zum Abrufen oder Festlegen einer eindeutigen Identifikation für das Objekt. Der Name kann nur aus der anfänglichen Analyse von XAML festgelegt werden. (Geerbt von TextElement) |
| TextDecorations |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, welche Dekorationen auf den Text angewendet werden. (Geerbt von TextElement) |
| XamlRoot |
Dient zum Abrufen oder Festlegen des XamlRoot-Elements, in dem dieses Element angezeigt wird. (Geerbt von TextElement) |
Methoden
| Name | Beschreibung |
|---|---|
| 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 Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, 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 wird. (Geerbt von DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty für diese DependencyObject-Instanz zu überwachen. (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 durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject) |
Ereignisse
| Name | Beschreibung |
|---|---|
| AccessKeyDisplayDismissed |
Tritt auf, wenn die Zugriffstastenabfolge abgeschlossen ist, um Steuerelemente zu benachrichtigen, dass sie visuelle Zugriffstasten ausblenden sollen. (Geerbt von TextElement) |
| AccessKeyDisplayRequested |
Tritt auf, wenn die Zugriffstastenabfolge gestartet wird, um Steuerelemente zu benachrichtigen, dass sie visuelle Zugriffstasten anzeigen sollen. (Geerbt von TextElement) |
| AccessKeyInvoked |
Tritt auf, wenn ein Benutzer eine Zugriffstastensequenz abgeschlossen hat, um das Element zu benachrichtigen, dass die Zugriffstastenaktion aufgerufen werden soll. (Geerbt von TextElement) |