TextBlock Class

Fournit un contrôle léger pour afficher de petites quantités de texte.

Héritage

Object
DependencyObject
UIElement
FrameworkElement
TextBlock

Syntaxe


public sealed class TextBlock : FrameworkElement

Utilisation des éléments objets XAML


<TextBlock ...>text</TextBlock>
-or-
<TextBlock>
  oneOrMoreInlineElements
</TextBlock>
-or-
<TextBlock .../>

XAML Values

text: Texte interne affiché dans le TextBlock. Ce texte devient la valeur de la propriété Text. Il crée également un nouvel objet Run unique dans la collection Inlines qui contient le même texte.
oneOrMoreInlineElements: Un ou plusieurs éléments Run ou LineBreak.

Attributs

ActivatableAttribute(NTDDI_WIN8)
ContentPropertyAttribute()
MarshalingBehaviorAttribute(Agile)
StaticAttribute(Windows.UI.Xaml.Controls.ITextBlockStatics, NTDDI_WIN8)
ThreadingAttribute(Both)
VersionAttribute(NTDDI_WIN8)
WebHostHiddenAttribute()

Membres

TextBlockClasse comporte les types de membres suivants :

Constructeurs
Événements
Méthodes
Propriétés

Constructeurs

TextBlockClasse comporte les constructeurs suivants.

Constructeur	Description
TextBlock	Initializes a new instance of the TextBlock class.

Événements

TextBlockClasse comporte les événements suivants.

Événement	Description
ContextMenuOpening	Occurs when the system processes an interaction that displays a context menu.
DoubleTapped	Occurs when an otherwise unhandled DoubleTap interaction occurs over the hit test area of this element. (Hérité de UIElement)
DragEnter	Occurs when the input system reports an underlying drag event with this element as the target. (Hérité de UIElement)
DragLeave	Occurs when the input system reports an underlying drag event with this element as the origin. (Hérité de UIElement)
DragOver	Occurs when the input system reports an underlying drag event with this element as the potential drop target. (Hérité de UIElement)
Drop	Occurs when the input system reports an underlying drop event with this element as the drop target. (Hérité de UIElement)
GotFocus	Occurs when a UIElement receives focus. (Hérité de UIElement)
Holding	Occurs when an otherwise unhandled Hold interaction occurs over the hit test area of this element. (Hérité de UIElement)
KeyDown	Occurs when a keyboard key is pressed while the UIElement has focus. (Hérité de UIElement)
KeyUp	Occurs when a keyboard key is released while the UIElement has focus. (Hérité de UIElement)
LayoutUpdated	Occurs when the layout of the visual tree changes. (Hérité de FrameworkElement)
Loaded	Occurs when a FrameworkElement has been constructed and added to the object tree, and is ready for interaction. (Hérité de FrameworkElement)
LostFocus	Occurs when a UIElement loses focus. (Hérité de UIElement)
ManipulationCompleted	Occurs when a manipulation on the UIElement is complete. (Hérité de UIElement)
ManipulationDelta	Occurs when the input device changes position during a manipulation. (Hérité de UIElement)
ManipulationInertiaStarting	Occurs when the input device loses contact with the UIElement object during a manipulation and inertia begins. (Hérité de UIElement)
ManipulationStarted	Occurs when an input device begins a manipulation on the UIElement. (Hérité de UIElement)
ManipulationStarting	Occurs when the manipulation processor is first created. (Hérité de UIElement)
PointerCanceled	Occurs when a pointer that made contact abnormally loses contact. (Hérité de UIElement)
PointerCaptureLost	Occurs when pointer capture previously held by this element moves to another element or elsewhere. (Hérité de UIElement)
PointerEntered	Occurs when a pointer enters the hit test area of this element. (Hérité de UIElement)
PointerExited	Occurs when a pointer leaves the hit test area of this element. (Hérité de UIElement)
PointerMoved	Occurs when a pointer moves while the pointer remains within the hit test area of this element. (Hérité de UIElement)
PointerPressed	Occurs when the pointer device initiates a Press action within this element. (Hérité de UIElement)
PointerReleased	Occurs when the pointer device that previously initiated a Press action is released, while within this element. (Hérité de UIElement)
PointerWheelChanged	Occurs when the delta value of a pointer wheel changes. (Hérité de UIElement)
RightTapped	Occurs when a right-tap input stimulus happens while the pointer is over the element. (Hérité de UIElement)
SelectionChanged	Occurs when the text selection has changed.
SizeChanged	Occurs when either the ActualHeight or the ActualWidth property changes value on a FrameworkElement. (Hérité de FrameworkElement)
Tapped	Occurs when an otherwise unhandled Tap interaction occurs over the hit test area of this element. (Hérité de UIElement)
Unloaded	Occurs when this object is no longer connected to the main object tree. (Hérité de FrameworkElement)

Méthodes

The TextBlock Classe comporte les méthodes suivantes. Il hérite également des méthodes de Object Classe.

Méthode	Description
AddHandler	Adds a routed event handler for a specified routed event, adding the handler to the handler collection on the current element. Specify handledEventsToo as true to have the provided handler be invoked even if the event is handled elsewhere. (Hérité de UIElement)
Arrange	Positions child objects and determines a size for a UIElement. Parent objects that implement custom layout for their child elements should call this method from their layout override implementations to form a recursive layout update. (Hérité de UIElement)
ArrangeOverride	Provides the behavior for the Arrange pass of layout. Classes can override this method to define their own Arrange pass behavior. (Hérité de FrameworkElement)
CapturePointer	Sets pointer capture to a UIElement. Once captured, only the element that has capture will fire pointer-related events. (Hérité de UIElement)
ClearValue	Clears the local value of a dependency property. (Hérité de DependencyObject)
FindName	Retrieves an object that has the specified identifier name. (Hérité de FrameworkElement)
FindSubElementsForTouchTargeting	Enables a UIElement subclass to expose child elements that assist with resolving touch targeting. (Hérité de UIElement)
Focus	Focuses the TextBlock, as if it were a conventionally focusable control.
GetAnimationBaseValue	Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Hérité de DependencyObject)
GetValue	Returns the current effective value of a dependency property from a DependencyObject. (Hérité de DependencyObject)
InvalidateArrange	Invalidates the arrange state (layout) for a UIElement. After the invalidation, the UIElement will have its layout updated, which will occur asynchronously. (Hérité de UIElement)
InvalidateMeasure	Invalidates the measurement state (layout) for a UIElement. (Hérité de UIElement)
Measure	Updates the DesiredSize of a UIElement. Typically, objects that implement custom layout for their layout children call this method from their own MeasureOverride implementations to form a recursive layout update. (Hérité de UIElement)
MeasureOverride	Provides the behavior for the Measure pass of the layout cycle. Classes can override this method to define their own Measure pass behavior. (Hérité de FrameworkElement)
OnApplyTemplate	Invoked whenever application code or internal processes (such as a rebuilding layout pass) call ApplyTemplate. In simplest terms, this means the method is called just before a UI element displays in your app. Override this method to influence the default post-template logic of a class. (Hérité de FrameworkElement)
OnCreateAutomationPeer	When implemented in a derived class, returns class-specific AutomationPeer implementations for the Microsoft UI Automation infrastructure. (Hérité de UIElement)
OnDisconnectVisualChildren	Override this method to implement how layout and logic should behave when items are removed from a class-specific content or children property. (Hérité de UIElement)
ReadLocalValue	Returns the local value of a dependency property, if a local value is set. (Hérité de DependencyObject)
ReleasePointerCapture	Releases pointer captures for capture of one specific pointer by this UIElement. (Hérité de UIElement)
ReleasePointerCaptures	Releases all pointer captures held by this element. (Hérité de UIElement)
RemoveHandler	Removes the specified routed event handler from this UIElement. Typically the handler in question was added by AddHandler. (Hérité de UIElement)
Select	Selects a range of text in the TextBlock.
SelectAll	Selects the entire contents in the TextBlock.
SetBinding	Attaches a binding to a FrameworkElement, using the provided binding object. (Hérité de FrameworkElement)
SetValue	Sets the local value of a dependency property on a DependencyObject. (Hérité de DependencyObject)
TransformToVisual	Returns a transform object that can be used to transform coordinates from the UIElement to the specified object. (Hérité de UIElement)
UpdateLayout	Ensures that all positions of child objects of a UIElement are properly updated for layout. (Hérité de UIElement)

Propriétés

Le TextBlockClasse contient les propriétés suivantes.

Propriété	Type d’accès	Description
ActualHeight	en lecture seule	Gets the rendered height of a FrameworkElement. (Hérité de FrameworkElement)
ActualWidth	en lecture seule	Gets the rendered width of a FrameworkElement. (Hérité de FrameworkElement)
AllowDrop	en lecture/écriture	Gets or sets a value that determines whether this UIElement can be a drop target for purposes of drag-and-drop operations. (Hérité de UIElement)
BaselineOffset	en lecture seule	Returns a value by which each line of text is offset from a baseline.
BaseUri	en lecture seule	Gets a Uniform Resource Identifier (URI) that represents the base Uniform Resource Identifier (URI) for an XAML-constructed object at XAML load time. This property is useful for Uniform Resource Identifier (URI) resolution at run time. (Hérité de FrameworkElement)
CacheMode	en lecture/écriture	Gets or sets a value that indicates that rendered content should be cached as a composited bitmap when possible. (Hérité de UIElement)
CharacterSpacing	en lecture/écriture	Gets or sets the uniform spacing between characters, in units of 1/1000 of an em.
CharacterSpacingProperty	en lecture seule	Identifies the CharacterSpacing dependency property.
Clip	en lecture/écriture	Gets or sets the RectangleGeometry used to define the outline of the contents of a UIElement. (Hérité de UIElement)
ContentEnd	en lecture seule	Gets a TextPointer object for the end of text content in the TextBlock.
ContentStart	en lecture seule	Gets a TextPointer object for the start of text content in the TextBlock.
DataContext	en lecture/écriture	Gets or sets the data context for a FrameworkElement when it participates in data binding. (Hérité de FrameworkElement)
DesiredSize	en lecture seule	Gets the size that this UIElement computed during the measure pass of the layout process. (Hérité de UIElement)
Dispatcher	en lecture seule	Gets the CoreDispatcher that this object is associated with. (Hérité de DependencyObject)
FlowDirection	en lecture/écriture	Gets or sets the direction in which text and other UI elements flow within any parent element that controls their layout. This property can be set to either LeftToRight or RightToLeft. Setting FlowDirection to RightToLeft on any element sets the alignment to the right, the reading order to right-to-left and the layout of the control to flow from right to left. (Hérité de FrameworkElement)
FontFamily	en lecture/écriture	Gets or sets the preferred top-level font family for the text content in this element.
FontFamilyProperty	en lecture seule	Identifies the FontFamily dependency property.
FontSize	en lecture/écriture	Gets or sets the font size for the text content in this element.
FontSizeProperty	en lecture seule	Identifies the FontSize dependency property.
FontStretch	en lecture/écriture	Gets or sets the font stretch for the text content in this element.
FontStretchProperty	en lecture seule	Identifies the FontStretch dependency property.
FontStyle	en lecture/écriture	Gets or sets the font style for the content in this element.
FontStyleProperty	en lecture seule	Identifies the FontStyle dependency property.
FontWeight	en lecture/écriture	Gets or sets the top-level font weight for the TextBlock.
FontWeightProperty	en lecture seule	Identifies the FontWeight dependency property.
Foreground	en lecture/écriture	Gets or sets the Brush to apply to the text contents of the TextBlock.
ForegroundProperty	en lecture seule	Identifies the Foreground dependency property.
Height	en lecture/écriture	Gets or sets the suggested height of a FrameworkElement. (Hérité de FrameworkElement)
HorizontalAlignment	en lecture/écriture	Gets or sets the horizontal alignment characteristics that are applied to a FrameworkElement when it is composed in a layout parent, such as a panel or items control. (Hérité de FrameworkElement)
Inlines	en lecture seule	Gets the collection of inline text elements within a TextBlock.
IsDoubleTapEnabled	en lecture/écriture	Gets or sets a value that determines whether the DoubleTapped event can originate from that element. (Hérité de UIElement)
IsHitTestVisible	en lecture/écriture	Gets or sets whether the contained area of this UIElement can return true values for hit testing. (Hérité de UIElement)
IsHoldingEnabled	en lecture/écriture	Gets or sets a value that determines whether the Holding event can originate from that element. (Hérité de UIElement)
IsRightTapEnabled	en lecture/écriture	Gets or sets a value that determines whether the RightTapped event can originate from that element. (Hérité de UIElement)
IsTapEnabled	en lecture/écriture	Gets or sets a value that determines whether the Tapped event can originate from that element. (Hérité de UIElement)
IsTextSelectionEnabled	en lecture/écriture	Gets or sets a value that indicates whether text selection is enabled in the TextBlock, either through user action or calling selection-related API.
IsTextSelectionEnabledProperty	en lecture seule	Identifies the IsTextSelectionEnabled dependency property.
Language	en lecture/écriture	Gets or sets localization/globalization language information that applies to a FrameworkElement, and also to all child elements of the current FrameworkElement in the object representation and in UI. (Hérité de FrameworkElement)
LineHeight	en lecture/écriture	Gets or sets the height of each line of content.
LineHeightProperty	en lecture seule	Identifies the LineHeight dependency property.
LineStackingStrategy	en lecture/écriture	Gets or sets a value that indicates how a line box is determined for each line of text in the TextBlock.
LineStackingStrategyProperty	en lecture seule	Identifies the LineStackingStrategy dependency property.
ManipulationMode	en lecture/écriture	Gets or sets the ManipulationModes value used for UIElement behavior and interaction with gestures. (Hérité de UIElement)
Margin	en lecture/écriture	Gets or sets the outer margin of a FrameworkElement. (Hérité de FrameworkElement)
MaxHeight	en lecture/écriture	Gets or sets the maximum height constraint of a FrameworkElement. (Hérité de FrameworkElement)
MaxWidth	en lecture/écriture	Gets or sets the maximum width constraint of a FrameworkElement. (Hérité de FrameworkElement)
MinHeight	en lecture/écriture	Gets or sets the minimum height constraint of a FrameworkElement. (Hérité de FrameworkElement)
MinWidth	en lecture/écriture	Gets or sets the minimum width constraint of a FrameworkElement. (Hérité de FrameworkElement)
Name	en lecture/écriture	Gets or sets the identifying name of the object. When a XAML processor creates the object tree from XAML markup, run-time code can refer to the XAML-declared object by this name. (Hérité de FrameworkElement)
Opacity	en lecture/écriture	Gets or sets the degree of the object's opacity. (Hérité de UIElement)
Padding	en lecture/écriture	Gets or sets a value that indicates the thickness of padding space between the boundaries of the content area and the content displayed by a TextBlock.
PaddingProperty	en lecture seule	Identifies the Padding dependency property.
Parent	en lecture seule	Gets the parent object of this FrameworkElement in the object tree. (Hérité de FrameworkElement)
PointerCaptures	en lecture seule	Gets the set of all captured pointers, represented as Pointer values. (Hérité de UIElement)
Projection	en lecture/écriture	Gets or sets the perspective projection (3-D effect) to apply when rendering this element. (Hérité de UIElement)
RenderSize	en lecture seule	Gets the final render size of a UIElement. (Hérité de UIElement)
RenderTransform	en lecture/écriture	Gets or sets transform information that affects the rendering position of a UIElement. (Hérité de UIElement)
RenderTransformOrigin	en lecture/écriture	Gets or sets the origin point of any possible render transform declared by RenderTransform, relative to the bounds of the UIElement. (Hérité de UIElement)
Resources	en lecture/écriture	Gets the locally defined resource dictionary. In XAML, you can establish resource items as child object elements of a frameworkElement.Resources property element, through XAML implicit collection syntax. (Hérité de FrameworkElement)
SelectedText	en lecture seule	Gets a text range of selected text.
SelectedTextProperty	en lecture seule	Identifies the SelectedText dependency property.
SelectionEnd	en lecture seule	Gets the end position of the text selected in the TextBlock.
SelectionStart	en lecture seule	Gets the starting position of the text selected in the TextBlock.
Style	en lecture/écriture	Gets or sets an instance Style that is applied for this object during layout and rendering. (Hérité de FrameworkElement)
Tag	en lecture/écriture	Gets or sets an arbitrary object value that can be used to store custom information about this object. (Hérité de FrameworkElement)
Text	en lecture/écriture	Gets or sets the text contents of a TextBlock.
TextAlignment	en lecture/écriture	Gets or sets a value that indicates the horizontal alignment of text content.
TextAlignmentProperty	en lecture seule	Identifies the TextAlignment dependency property.
TextProperty	en lecture seule	Identifies the Text dependency property.
TextTrimming	en lecture/écriture	Gets or sets the text trimming behavior to employ when content overflows the content area.
TextTrimmingProperty	en lecture seule	Identifies the TextTrimming dependency property.
TextWrapping	en lecture/écriture	Gets or sets how the TextBlock wraps text.
TextWrappingProperty	en lecture seule	Identifies the TextWrapping dependency property.
Transitions	en lecture/écriture	Gets or sets the collection of Transition style elements that apply to a UIElement. (Hérité de UIElement)
Triggers	en lecture seule	Gets the collection of triggers for animations that are defined for a FrameworkElement. Not commonly used. (Hérité de FrameworkElement)
UseLayoutRounding	en lecture/écriture	Gets or sets a value that determines whether rendering for the object and its visual subtree should use rounding behavior that aligns rendering to whole pixels. (Hérité de UIElement)
VerticalAlignment	en lecture/écriture	Gets or sets the vertical alignment characteristics that are applied to a FrameworkElement when it is composed in a parent object such as a panel or items control. (Hérité de FrameworkElement)
Visibility	en lecture/écriture	Gets or sets the visibility of a UIElement. A UIElement that is not visible is not rendered and does not communicate its desired size to layout. (Hérité de UIElement)
Width	en lecture/écriture	Gets or sets the width of a FrameworkElement. (Hérité de FrameworkElement)

Exemples

L'exemple suivant montre comment utiliser la propriété LineStackingStrategy afin de déterminer de quelle manière sont créées les zones pour les lignes de texte d'un TextBlock. Le premier TextBlock a une valeur LineStackingStrategy de MaxHeight et le deuxième TextBlock a la valeur BlockLineHeight.

XAML


<StackPanel>

<!-- This TextBlock has a LineStackingStrategy set to "MaxHeight". -->
<TextBlock FontFamily="Verdana"
           LineStackingStrategy="MaxHeight" 
           LineHeight="10" 
           Width="500" 
           TextWrapping="Wrap" >
    Use the <Run FontSize="30">LineStackingStrategy</Run> property to determine how a line box is
    created for each line. A value of <Run FontSize="20">MaxHeight</Run> specifies that the stack
    height is the smallest value that contains all the inline elements on that line when those
    elements are properly aligned. A value of <Run FontSize="20">BlockLineHeight</Run> specifies
    that the stack height is determined by the block element LineHeight property value.
</TextBlock>

    <!-- With a margin pushing down 20 pixels, draw a line just above the second textblock. -->
    <!-- The fonts will reach above the LineHeight size and over the line. -->
<StackPanel Margin="0,20,0,0" HorizontalAlignment="Center">
    <Line Stroke="Green"  X2="500" />
</StackPanel>

            <!-- Here is the same TextBlock but the LineStackingStrategy is set to "BlockLineHeight". -->
<TextBlock FontFamily="Verdana"
           LineStackingStrategy="BlockLineHeight" 
           LineHeight="10" 
           Width="500" 
           TextWrapping="Wrap">
    Use the <Run FontSize="30">LineStackingStrategy</Run> property to determine how a line box is
    created for each line. A value of <Run FontSize="20">MaxHeight</Run> specifies that the stack
    height is the smallest value that contains all the inline elements on that line when those
    elements are properly aligned. A value of <Run FontSize="20">BlockLineHeight</Run> specifies
    that the stack height is determined by the block element LineHeight property value.
</TextBlock>

</StackPanel>

Configuration requise

Client minimal pris en charge	Windows 8 [Applications du Windows Store uniquement]
Serveur minimal pris en charge	Windows Server 2012 [Applications du Windows Store uniquement]
Espace de noms	Windows.UI.Xaml.Controls Windows::UI::Xaml::Controls [C++]
Métadonnées	Windows.winmd

Voir aussi

FrameworkElement

Deutsch	English	Español	Français
Italiano	日本語	한국어	Português
Pусский	简体中文	繁體中文