InlineUIContainer Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit un élément de contenu inline qui permet aux types UIElement d’être incorporés dans le contenu d’un RichTextBlock.
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>
- Héritage
- Attributs
Exemples
L’exemple de code suivant montre comment insérer une image dans un RichTextBlock à l’aide d’InlineUIContainer.
<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>
Remarques
Le scénario le plus courant d’utilisation d’un objet InlineUIContainer consiste à introduire une image dans du contenu texte. Utilisez un nouvel objet Image pour l’image, en tant que contenu enfant d’un InlineUIContainer. Définissez Height et Width sur l’image si vous ne souhaitez pas qu’elle soit mise à l’échelle vers la taille de l’image naturelle.
Si vous souhaitez ajouter plusieurs éléments inclus dans la même position, envisagez d’utiliser un panneau comme enfant InlineUIContainer unique, puis de placer les plusieurs éléments dans ce panneau.
Si elle est placée dans un InlineUIContainer, un contrôle qui peut être concentré apparaît toujours dans la séquence d’onglets de niveau supérieur.
Si vous souhaitez du texte interactif, envisagez d’utiliser un élément Hyperlink (un type d’inline) plutôt que d’utiliser InlineUIContainer avec un bouton ou similaire dans celui-ci. Consultez recommandations pour obtenir des liens.
InlineUIContainer hérite des propriétés de la classe TextElement . Toutefois, la plupart de ces propriétés n’ont aucun effet visible. Il est le plus courant de déclarer un élément objet InlineUIContainer en XAML sans avoir à définir d’attributs (sauf éventuellement un attribut x :Name) avec l’élément enfant unique que vous inlinez en tant que contenu de l’élément objet InlineUIContainer.
Définir des propriétés sur InlineUIContainer qui affectent autrement la hauteur de ligne de caractère d’un élément de texte (par exemple FontSize, FontFamily) n’a aucun effet sur le rendu et l’apparence. Le contenu détermine sa taille et les tailles InlineUIContainer pour l’adapter.
S’il existe un texte supplémentaire dans le contenu enfant (comme TextBlock.Text ou d’autres éléments de texte dans un RichTextBlock imbriqué), les propriétés de l’élément de texte du parent InlineUIContainer n’héritent pas du contenu, elles sont ignorées.
Constructeurs
| Nom | Description |
|---|---|
| InlineUIContainer() |
Initialise une nouvelle instance de la classe InlineUIContainer . |
Propriétés
| Nom | Description |
|---|---|
| AccessKey |
Obtient ou définit la clé d’accès pour cet élément. (Hérité de TextElement) |
| AccessKeyScopeOwner |
Obtient ou définit un élément source qui fournit l’étendue de clé d’accès pour cet élément, même s’il n’est pas dans l’arborescence visuelle de l’élément source. (Hérité de TextElement) |
| AllowFocusOnInteraction |
Obtient ou définit une valeur qui indique si l’élément obtient automatiquement le focus lorsque l’utilisateur interagit avec lui. (Hérité de TextElement) |
| CharacterSpacing |
Obtient ou définit l’espacement uniforme entre les caractères, en unités de 1/1000 d’un em. (Hérité de TextElement) |
| Child |
Obtient ou définit l’UIElement hébergé par InlineUIContainer. |
| ContentEnd |
Obtient un TextPointer qui représente la fin du contenu dans l’élément. (Hérité de TextElement) |
| ContentStart |
Obtient un TextPointer qui représente le début du contenu dans l’élément. (Hérité de TextElement) |
| Dispatcher |
Retourne |
| DispatcherQueue |
Obtient le |
| ElementEnd |
Obtient un TextPointer qui représente la position juste après la fin de l’élément. (Hérité de TextElement) |
| ElementStart |
Obtient un TextPointer qui représente la position juste avant le début de l’élément. (Hérité de TextElement) |
| ExitDisplayModeOnAccessKeyInvoked |
Obtient ou définit une valeur qui spécifie si l’affichage de la clé d’accès est ignoré lorsqu’une clé d’accès est appelée. (Hérité de TextElement) |
| FontFamily |
Obtient ou définit la famille de polices de niveau supérieur préférée pour le contenu de l’élément. (Hérité de TextElement) |
| FontSize |
Obtient ou définit la taille de police pour le contenu de l’élément. (Hérité de TextElement) |
| FontStretch |
Obtient ou définit la largeur du glyphe de la police dans une famille à sélectionner. (Hérité de TextElement) |
| FontStyle |
Obtient ou définit le style de police pour le contenu de cet élément. (Hérité de TextElement) |
| FontWeight |
Obtient ou définit l’épaisseur de police de niveau supérieur à sélectionner dans la famille de polices pour le contenu de cet élément. (Hérité de TextElement) |
| Foreground |
Obtient ou définit le pinceau à appliquer au contenu de cet élément. (Hérité de TextElement) |
| IsAccessKeyScope |
Obtient ou définit une valeur qui indique si un élément définit sa propre étendue de clé d’accès. (Hérité de TextElement) |
| IsTextScaleFactorEnabled |
Obtient ou définit si l’élargissement automatique du texte, pour refléter le paramètre de taille de texte système, est activé. (Hérité de TextElement) |
| KeyTipHorizontalOffset |
Obtient ou définit une valeur qui indique la gauche ou la droite de l’info-bulle placée par rapport à l’élément de texte. (Hérité de TextElement) |
| KeyTipPlacementMode |
Obtient ou définit une valeur qui indique où l’info-bulle est placée par rapport à l’élément de texte. (Hérité de TextElement) |
| KeyTipVerticalOffset |
Obtient ou définit une valeur qui indique jusqu’à quel point l’info-bulle est placée par rapport à l’élément de texte. (Hérité de TextElement) |
| Language |
Obtient ou définit les informations de langue de localisation/globalisation qui s’appliquent à un TextElement. (Hérité de TextElement) |
| Name |
Obtient ou définit une identification unique pour l’objet. Le nom ne peut être défini qu’à partir de l’analyse initiale du code XAML. (Hérité de TextElement) |
| TextDecorations |
Obtient ou définit une valeur qui indique les décorations appliquées au texte. (Hérité de TextElement) |
| XamlRoot |
Obtient ou définit le xamlRoot dans lequel cet élément est en cours d’affichage. (Hérité de TextElement) |
Méthodes
| Nom | Description |
|---|---|
| ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject) |
| FindName(String) |
Récupère un objet dans le modèle objet/ graphique d’objet runtime en référençant la valeur d’attribut x :Name ou Name de l’objet. (Hérité de TextElement) |
| GetAnimationBaseValue(DependencyProperty) |
Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active. (Hérité de DependencyObject) |
| GetValue(DependencyProperty) |
Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un DependencyObject. (Hérité de DependencyObject) |
| OnDisconnectVisualChildren() |
Remplacez cette méthode pour implémenter le comportement de la disposition et de la logique lorsque les éléments sont supprimés d’un contenu spécifique à une classe ou d’une propriété enfant. (Hérité de TextElement) |
| ReadLocalValue(DependencyProperty) |
Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Inscrit une fonction de notification pour écouter les modifications apportées à une dependencyProperty spécifique sur cette instance DependencyObject . (Hérité de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Annule une notification de modification qui a été précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject) |
Événements
| Nom | Description |
|---|---|
| AccessKeyDisplayDismissed |
Se produit lorsque la séquence de clés d’accès est terminée pour avertir les contrôles qu’ils doivent masquer les visuels de clé d’accès. (Hérité de TextElement) |
| AccessKeyDisplayRequested |
Se produit lorsque la séquence de clés d’accès est démarrée pour avertir les contrôles qu’ils doivent afficher les visuels de clé d’accès. (Hérité de TextElement) |
| AccessKeyInvoked |
Se produit lorsqu’un utilisateur termine une séquence de clés d’accès pour avertir l’élément que l’action de clé d’accès doit être appelée. (Hérité de TextElement) |