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 : InlinePublic NotInheritable Class InlineUIContainer
Inherits Inline<InlineUIContainer .../>
-or-
<InlineUIContainer ...>
singleChild
</InlineUIContainer>
- Vererbung
- Attribute
Beispiele
Das folgende Codebeispiel zeigt, wie Sie ein Bild mithilfe von InlineUIContainer 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ühren. 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 sie nicht auf die natürliche Bildgröße skaliert werden soll.
Wenn mehrere Elemente an derselben Position inlineiert werden sollen, sollten Sie ein Panel als untergeordnetes InlineUIContainer-Element verwenden und dann mehrere Elemente in diesem Bereich 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 verwenden möchten, sollten Sie ein Hyperlink-Element (einen Typ von Inline) anstelle von InlineUIContainer mit einer Schaltfläche oder einem ähnlichen Element verwenden. Links finden Sie unter "Richtlinien".
InlineUIContainer erbt Eigenschaften von der TextElement-Klasse . Die meisten dieser Eigenschaften haben jedoch keinen sichtbaren Effekt. Es ist am häufigsten, ein InlineUIContainer-Objektelement in XAML zu deklarieren, ohne dass attribute festgelegt werden (mit Ausnahme von x:Name-Attribut) mit dem einzelnen untergeordneten Element, das Sie als Inhalt des InlineUIContainer-Objektelements angeben.
Das Festlegen von Eigenschaften für InlineUIContainer, die sich andernfalls auf die Zeichenzeilenhöhe eines Textelements (z. B. FontSize, FontFamily) auswirken, hat keine Auswirkungen auf das Rendering und die Darstellung. Der Inhalt bestimmt seine Größe und die InlineUIContainer-Größen, um sie anzupassen.
Wenn innerhalb des untergeordneten Inhalts (z. B. TextBlock.Text oder andere Textelemente in einem geschachtelten RichTextBlock)-Element weitere Text enthalten sind, werden die Textelementeigenschaften des übergeordneten Elements "InlineUIContainer" nicht an den Inhalt geerbt, werden sie ignoriert.
Konstruktoren
| Name | Beschreibung |
|---|---|
| InlineUIContainer() |
Initialisiert eine neue Instanz der InlineUIContainer-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) |
| Child |
Ruft das uiElement ab, das vom InlineUIContainer gehostet wird, oder legt es fest. |
| 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) |
| 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) |