InlineUIContainer 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.
Stellt ein Inlineinhaltselement bereit, mit dem UIElement-Typen in den Inhalt eines RichTextBlock eingebettet werden können.
public ref class InlineUIContainer sealed : Inline
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Child")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [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 InlineUIContainer final : Inline
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Child")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[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 sealed class InlineUIContainer : Inline
Public NotInheritable Class InlineUIContainer
Inherits Inline
<InlineUIContainer .../>
-or-
<InlineUIContainer ...>
singleChild
</InlineUIContainer>
- Vererbung
- Attribute
Beispiele
Das folgende Codebeispiel zeigt, wie Sie mithilfe von InlineUIContainer ein Bild in einen RichTextBlock einfügen können.
<RichTextBlock>
<Paragraph>
<Italic>This is an inline image.</Italic>
<InlineUIContainer>
<Image Source="Assets/SmallLogo.png" Height="30" Width="30"/>
</InlineUIContainer>
Mauris auctor tincidunt auctor.
</Paragraph>
</RichTextBlock>
Hinweise
Das häufigste Szenario für die Verwendung eines InlineUIContainer-Objekts besteht darin, ein Bild in Textinhalte einzufügen. Verwenden Sie ein neues Image-Objekt für das Bild als untergeordneten Inhalt für einen InlineUIContainer. Legen Sie Höhe und Breite für das Bild fest, wenn es nicht auf die natürliche Bildgröße skaliert werden soll.
Wenn Sie mehrere Elemente an derselben Position inlineieren möchten, sollten Sie ein Panel als einzelnes untergeordnetes InlineUIContainer-Element verwenden und dann mehrere Elemente innerhalb dieses Bereichs platzieren.
Wenn sie in einem InlineUIContainer platziert wird, wird ein Steuerelement, das fokussiert werden kann, weiterhin in der Registerkartensequenz der obersten Ebene angezeigt.
Wenn Sie interaktiven Text möchten, sollten Sie ein Hyperlink-Element (einen Typ von Inline) anstelle von InlineUIContainer mit einer Schaltfläche oder ähnlichem verwenden. Links finden Sie unter Richtlinien.
InlineUIContainer erbt Eigenschaften von der TextElement-Klasse . Die meisten dieser Eigenschaften haben jedoch keine sichtbaren Auswirkungen. Es ist am häufigsten, ein InlineUIContainer-Objektelement in XAML zu deklarieren, ohne dass Attribute (mit Ausnahme des x:Name-Attributs) mit dem einzelnen untergeordneten Element festgelegt sind, das Sie als Inhalt des InlineUIContainer-Objektelements angeben.
Das Festlegen von Eigenschaften für InlineUIContainer, die sich andernfalls auf die Zeichenzeilenhöhe eines Textelements auswirken (z. B . FontSize, FontFamily), hat keine Auswirkungen auf das Rendering und die Darstellung. Der Inhalt bestimmt seine Größe und die InlineUIContainer-Größen, um ihn zu passen.
Wenn im untergeordneten Inhalt weitere Text enthalten ist (z . B. TextBlock.Text oder andere Textelemente in einem geschachtelten RichTextBlock), werden die Textelementeigenschaften des übergeordneten Elements InlineUIContainer nicht in den Inhalt übernommen, sie werden ignoriert.
Konstruktoren
InlineUIContainer() |
Initialisiert eine neue instance der InlineUIContainer-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 dem Element 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) |
Child |
Ruft das vom InlineUIContainer gehostete UIElement ab oder legt es fest. |
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 |
Gibt immer in einer Windows App SDK-App zurück |
DispatcherQueue |
Ruft den |
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 Anfang des Elements darstellt. (Geerbt von TextElement) |
ExitDisplayModeOnAccessKeyInvoked |
Ruft einen Wert ab, der angibt, ob die Anzeige der Zugriffsschlüssel geschlossen wird, wenn ein Zugriffsschlüssel aufgerufen 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 diese 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 Schriftartfamilie 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) |
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 Beziehung 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 Bezug auf das Textelement platziert wird, oder legt diesen fest. (Geerbt von TextElement) |
Language |
Ruft Lokalisierungs-/Globalisierungssprachinformationen 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 diesen 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-/Laufzeitobjektgraphen 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 eingerichtet wurde, der 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 durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject) |
Ereignisse
AccessKeyDisplayDismissed |
Tritt auf, wenn die Zugriffstastensequenz abgeschlossen ist, um Steuerelemente zu benachrichtigen, dass sie Visuals für Zugriffsschlüssel ausblenden sollen. (Geerbt von TextElement) |
AccessKeyDisplayRequested |
Tritt auf, wenn die Zugriffstastensequenz gestartet wird, um Steuerelemente zu benachrichtigen, dass sie Visuals für Zugriffsschlüssel anzeigen sollen. (Geerbt von TextElement) |
AccessKeyInvoked |
Tritt auf, wenn ein Benutzer eine Zugriffstastensequenz abschließt, um das Element zu benachrichtigen, dass die Zugriffstastenaktion aufgerufen werden soll. (Geerbt von TextElement) |