Block Classe

Référence

Définition

Espace de noms:: Windows.UI.Xaml.Documents

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.

Modifier

Classe abstraite qui fournit une base pour tous les éléments de contenu au niveau du bloc.

public ref class Block : TextElement

/// [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)]
class Block : TextElement

[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)]
public class Block : TextElement

Public Class Block
Inherits TextElement

Héritage: Object Platform::Object IInspectable DependencyObject TextElement Block

Dérivé: Windows.UI.Xaml.Documents.Paragraph

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Block définit les propriétés de mise en forme de texte qui doivent s’appliquer à tous les types de contenu Bloquer. Ces propriétés sont : LineHeight, LineStackingStrategy, Margin et TextAlignment. Block hérite également des propriétés de mise en forme de texte et d’autres API de TextElement.

Dans le vocabulaire XAML Windows Runtime, le seul type de bloc est Paragraph. Vous utilisez Paragraph pour définir les blocs de texte à afficher dans un contrôle RichTextBlock . Chaque RichTextBlock doit inclure au moins un paragraphe.

BlockCollection est une classe de collection fortement typée utilisée par la propriété RichTextBlock.Blocks . En spécifiant des éléments d’objet XAML dans un RichTextBlock, vous pouvez affecter le contenu de texte de bloc pour RichTextBlock. Cela est généralement effectué à l’aide d’une collection implicite et d’une syntaxe de propriété XAML, de sorte que les éléments Paragraph apparaissent en tant qu’enfants directs de RichTextBlock dans le balisage XAML. Par exemple :

<RichTextBlock>
  <Paragraph>First paragraph.</Paragraph>
  <Paragraph>Second paragraph.</Paragraph>
  <Paragraph>Third paragraph. <Bold>With an inline.</Bold></Paragraph>
</RichTextBlock>

Classes dérivées de blocs

Block est la classe parente pour Paragraph.

Notes de migration

Le vocabulaire XAML Windows Runtime ne prend pas en charge une classe Section. Si vous migrez XAML à partir de Windows Presentation Foundation (WPF) ou Microsoft Silverlight, utilisez un élément de bloc Paragraph à la place.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1709	16299	HorizontalTextAlignment

Constructeurs

Block()

Fournit le comportement d’initialisation de classe de base pour les classes dérivées de Block .

Propriétés

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 la clé d’accès pour cet élément, même s’il ne se trouve 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)
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	Obtient le CoreDispatcher auquel cet objet est associé. CoreDispatcher représente une installation qui peut accéder à DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur. (Hérité de DependencyObject)
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 par défaut 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 du contenu de cet élément. (Hérité de TextElement)
FontWeight	Obtient ou définit le poids 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)
HorizontalTextAlignment	Obtient ou définit une valeur qui indique comment le texte est aligné dans le bloc.
HorizontalTextAlignmentProperty	Identifie la propriété de dépendance HorizontalTextAlignment.
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’agrandissement 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 distance à gauche ou à droite de l’info-bulle par rapport à l’élément de texte. (Hérité de TextElement)
KeyTipPlacementMode	Obtient ou définit une valeur qui indique où l’info-clé 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 élément TextElement. (Hérité de TextElement)
LineHeight	Obtient ou définit la hauteur de chaque ligne de contenu.
LineHeightProperty	Identifie la propriété de dépendance LineHeight .
LineStackingStrategy	Obtient ou définit une valeur qui indique comment une zone de ligne est déterminée pour chaque ligne de texte dans le bloc.
LineStackingStrategyProperty	Identifie la propriété de dépendance LineStackingStrategy .
Margin	Obtient ou définit la quantité d’espace autour d’un élément Block .
MarginProperty	Identifie la propriété de dépendance Margin .
Name	Obtient ou définit une identification unique pour l’objet. Le nom ne peut être défini qu’à partir de l’analyse initiale de XAML. (Hérité de TextElement)
TextAlignment	Obtient ou définit l’alignement horizontal du contenu du texte.
TextAlignmentProperty	Identifie la propriété de dépendance TextAlignment .
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 visualisé. (Hérité de TextElement)

Méthodes

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/le graphique d’objet runtime en référençant la valeur de l’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 objet DependencyObject. (Hérité de DependencyObject)
OnDisconnectVisualChildren()	Remplacez cette méthode pour implémenter le comportement de la disposition et de la logique lorsque des éléments sont supprimés d’un contenu ou d’une propriété enfant spécifique à une classe. (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 à un DependencyProperty spécifique sur ce 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 précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject)

Événements

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 des 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 informer l’élément que l’action de clé d’accès doit être appelée. (Hérité de TextElement)

S’applique à