Expandir Minimizar

TextBlock Class

Proporciona un control ligero que permite mostrar pequeños fragmentos de texto.

Herencia

Object
  DependencyObject
    UIElement
      FrameworkElement
        TextBlock

Sintaxis


public sealed class TextBlock : FrameworkElement


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

XAML Values

text

Texto interno que se muestra en TextBlock. Este texto se convierte en el valor de la propiedad Text. También crea un nuevo objeto Run único en la colección Inlines que contiene el mismo texto.

oneOrMoreInlineElements

Uno o más elementos Run o LineBreak.

Atributos

[ContentProperty("Name=Text")]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]
[WebHostHidden()]

Members

A continuación se indican los tipos de miembros de TextBlock (Clase):

Constructores

A continuación se indican los constructores de TextBlock (Clase).

ConstructorDescripción
TextBlock Initializes a new instance of the TextBlock class.

 

Eventos

A continuación se indican los eventos de TextBlock (Clase).

EventoDescripción
ContextMenuOpening Occurs when the system processes an interaction that displays a context menu.
DataContextChanged Occurs when the value of the FrameworkElement.DataContext property changes. (Se hereda de FrameworkElement)
DoubleTapped Occurs when an otherwise unhandled DoubleTap interaction occurs over the hit test area of this element. (Se hereda de UIElement)
DragEnter Occurs when the input system reports an underlying drag event with this element as the target. (Se hereda de UIElement)
DragLeave Occurs when the input system reports an underlying drag event with this element as the origin. (Se hereda de UIElement)
DragOver Occurs when the input system reports an underlying drag event with this element as the potential drop target. (Se hereda de UIElement)
Drop Occurs when the input system reports an underlying drop event with this element as the drop target. (Se hereda de UIElement)
GotFocus Occurs when a UIElement receives focus. (Se hereda de UIElement)
Holding Occurs when an otherwise unhandled Hold interaction occurs over the hit test area of this element. (Se hereda de UIElement)
KeyDown Occurs when a keyboard key is pressed while the UIElement has focus. (Se hereda de UIElement)
KeyUp Occurs when a keyboard key is released while the UIElement has focus. (Se hereda de UIElement)
LayoutUpdated Occurs when the layout of the visual tree changes, due to layout-relevant properties changing value or some other action that refreshes the layout. (Se hereda de FrameworkElement)
Loaded Occurs when a FrameworkElement has been constructed and added to the object tree, and is ready for interaction. (Se hereda de FrameworkElement)
LostFocus Occurs when a UIElement loses focus. (Se hereda de UIElement)
ManipulationCompleted Occurs when a manipulation on the UIElement is complete. (Se hereda de UIElement)
ManipulationDelta Occurs when the input device changes position during a manipulation. (Se hereda de UIElement)
ManipulationInertiaStarting Occurs when the input device loses contact with the UIElement object during a manipulation and inertia begins. (Se hereda de UIElement)
ManipulationStarted Occurs when an input device begins a manipulation on the UIElement. (Se hereda de UIElement)
ManipulationStarting Occurs when the manipulation processor is first created. (Se hereda de UIElement)
PointerCanceled Occurs when a pointer that made contact abnormally loses contact. (Se hereda de UIElement)
PointerCaptureLost Occurs when pointer capture previously held by this element moves to another element or elsewhere. (Se hereda de UIElement)
PointerEntered Occurs when a pointer enters the hit test area of this element. (Se hereda de UIElement)
PointerExited Occurs when a pointer leaves the hit test area of this element. (Se hereda de UIElement)
PointerMoved Occurs when a pointer moves while the pointer remains within the hit test area of this element. (Se hereda de UIElement)
PointerPressed Occurs when the pointer device initiates a Press action within this element. (Se hereda de UIElement)
PointerReleased Occurs when the pointer device that previously initiated a Press action is released, while within this element. (Se hereda de UIElement)
PointerWheelChanged Occurs when the delta value of a pointer wheel changes. (Se hereda de UIElement)
RightTapped Occurs when a right-tap input stimulus happens while the pointer is over the element. (Se hereda 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. (Se hereda de FrameworkElement)
Tapped Occurs when an otherwise unhandled Tap interaction occurs over the hit test area of this element. (Se hereda de UIElement)
Unloaded Occurs when this object is no longer connected to the main object tree. (Se hereda de FrameworkElement)

 

Métodos

The TextBlock Clase tiene estos métodos. También hereda métodos de Object Clase.

MétodoDescripción
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. (Se hereda 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. (Se hereda de UIElement)
ArrangeOverride Provides the behavior for the Arrange pass of layout. Classes can override this method to define their own Arrange pass behavior. (Se hereda de FrameworkElement)
CancelDirectManipulations Cancels ongoing direct manipulation processing (system-defined panning/zooming) on any ScrollViewer parent that contains the current UIElement. (Se hereda de UIElement)
CapturePointer Sets pointer capture to a UIElement. Once captured, only the element that has capture will fire pointer-related events. (Se hereda de UIElement)
ClearValue Clears the local value of a dependency property. (Se hereda de DependencyObject)
FindName Retrieves an object that has the specified identifier name. (Se hereda de FrameworkElement)
FindSubElementsForTouchTargeting Enables a UIElement subclass to expose child elements that assist with resolving touch targeting. (Se hereda 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. (Se hereda de DependencyObject)
GetBindingExpression Returns the BindingExpression that represents the binding on the specified property. (Se hereda de FrameworkElement)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (Se hereda de DependencyObject)
GoToElementStateCore When implemented in a derived class, enables per-state construction of a visual tree for a control template in code, rather than by loading XAML for all states at control startup. (Se hereda de FrameworkElement)
InvalidateArrange Invalidates the arrange state (layout) for a UIElement. After the invalidation, the UIElement will have its layout updated, which will occur asynchronously. (Se hereda de UIElement)
InvalidateMeasure Invalidates the measurement state (layout) for a UIElement. (Se hereda 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. (Se hereda 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. (Se hereda 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. (Se hereda de FrameworkElement)
OnCreateAutomationPeer When implemented in a derived class, returns class-specific AutomationPeer implementations for the Microsoft UI Automation infrastructure. (Se hereda 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. (Se hereda de UIElement)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (Se hereda de DependencyObject)
ReleasePointerCapture Releases pointer captures for capture of one specific pointer by this UIElement. (Se hereda de UIElement)
ReleasePointerCaptures Releases all pointer captures held by this element. (Se hereda de UIElement)
RemoveHandler Removes the specified routed event handler from this UIElement. Typically the handler in question was added by AddHandler. (Se hereda 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. (Se hereda de FrameworkElement)
SetValue Sets the local value of a dependency property on a DependencyObject. (Se hereda de DependencyObject)
TransformToVisual Returns a transform object that can be used to transform coordinates from the UIElement to the specified object. (Se hereda de UIElement)
UpdateLayout Ensures that all positions of child objects of a UIElement are properly updated for layout. (Se hereda de UIElement)

 

Propiedades

TextBlockClase tiene estas propiedades.

PropiedadTipo de accesoDescripción

ActualHeight

De sólo lecturaGets the rendered height of a FrameworkElement. (Se hereda de FrameworkElement)

ActualWidth

De sólo lecturaGets the rendered width of a FrameworkElement. (Se hereda de FrameworkElement)

AllowDrop

Lectura/escrituraGets or sets a value that determines whether this UIElement can be a drop target for purposes of drag-and-drop operations. (Se hereda de UIElement)

BaselineOffset

De sólo lecturaReturns a value by which each line of text is offset from a baseline.

BaseUri

De sólo lecturaGets 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. (Se hereda de FrameworkElement)

CacheMode

Lectura/escrituraGets or sets a value that indicates that rendered content should be cached as a composited bitmap when possible. (Se hereda de UIElement)

CharacterSpacing

Lectura/escrituraGets or sets the uniform spacing between characters, in units of 1/1000 of an em.

CharacterSpacingProperty

De sólo lecturaIdentifies the CharacterSpacing dependency property.

Clip

Lectura/escrituraGets or sets the RectangleGeometry used to define the outline of the contents of a UIElement. (Se hereda de UIElement)

CompositeMode

Lectura/escrituraGets or sets a property that declares alternate composition and blending modes for the element in its parent layout and window. This is relevant for elements that are involved in a mixed XAML / Microsoft DirectX UI. (Se hereda de UIElement)

ContentEnd

De sólo lecturaGets a TextPointer object for the end of text content in the TextBlock.

ContentStart

De sólo lecturaGets a TextPointer object for the start of text content in the TextBlock.

DataContext

Lectura/escrituraGets or sets the data context for a FrameworkElement when it participates in data binding. (Se hereda de FrameworkElement)

DesiredSize

De sólo lecturaGets the size that this UIElement computed during the measure pass of the layout process. (Se hereda de UIElement)

Dispatcher

De sólo lecturaGets the CoreDispatcher that this object is associated with. (Se hereda de DependencyObject)

FlowDirection

Lectura/escrituraGets 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. (Se hereda de FrameworkElement)

FontFamily

Lectura/escrituraGets or sets the preferred top-level font family for the text content in this element.

FontFamilyProperty

De sólo lecturaIdentifies the FontFamily dependency property.

FontSize

Lectura/escrituraGets or sets the font size for the text content in this element.

FontSizeProperty

De sólo lecturaIdentifies the FontSize dependency property.

FontStretch

Lectura/escrituraGets or sets the font stretch for the text content in this element.

FontStretchProperty

De sólo lecturaIdentifies the FontStretch dependency property.

FontStyle

Lectura/escrituraGets or sets the font style for the content in this element.

FontStyleProperty

De sólo lecturaIdentifies the FontStyle dependency property.

FontWeight

Lectura/escrituraGets or sets the top-level font weight for the TextBlock.

FontWeightProperty

De sólo lecturaIdentifies the FontWeight dependency property.

Foreground

Lectura/escrituraGets or sets the Brush to apply to the text contents of the TextBlock.

ForegroundProperty

De sólo lecturaIdentifies the Foreground dependency property.

Height

Lectura/escrituraGets or sets the suggested height of a FrameworkElement. (Se hereda de FrameworkElement)

HorizontalAlignment

Lectura/escrituraGets 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. (Se hereda de FrameworkElement)

Inlines

De sólo lecturaGets the collection of inline text elements within a TextBlock.

IsColorFontEnabled

Lectura/escrituraGets or sets a value that determines whether font glyphs that contain color layers, such as Segoe UI Emoji, are rendered in color.

IsColorFontEnabledProperty

De sólo lecturaIdentifies the IsColorFontEnabled dependency property.

IsDoubleTapEnabled

Lectura/escrituraGets or sets a value that determines whether the DoubleTapped event can originate from that element. (Se hereda de UIElement)

IsHitTestVisible

Lectura/escrituraGets or sets whether the contained area of this UIElement can return true values for hit testing. (Se hereda de UIElement)

IsHoldingEnabled

Lectura/escrituraGets or sets a value that determines whether the Holding event can originate from that element. (Se hereda de UIElement)

IsRightTapEnabled

Lectura/escrituraGets or sets a value that determines whether the RightTapped event can originate from that element. (Se hereda de UIElement)

IsTapEnabled

Lectura/escrituraGets or sets a value that determines whether the Tapped event can originate from that element. (Se hereda de UIElement)

IsTextSelectionEnabled

Lectura/escrituraGets or sets a value that indicates whether text selection is enabled in the TextBlock, either through user action or calling selection-related API.

IsTextSelectionEnabledProperty

De sólo lecturaIdentifies the IsTextSelectionEnabled dependency property.

Language

Lectura/escrituraGets 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. (Se hereda de FrameworkElement)

LineHeight

Lectura/escrituraGets or sets the height of each line of content.

LineHeightProperty

De sólo lecturaIdentifies the LineHeight dependency property.

LineStackingStrategy

Lectura/escrituraGets or sets a value that indicates how a line box is determined for each line of text in the TextBlock.

LineStackingStrategyProperty

De sólo lecturaIdentifies the LineStackingStrategy dependency property.

ManipulationMode

Lectura/escrituraGets or sets the ManipulationModes value used for UIElement behavior and interaction with gestures. Setting this value enables handling the manipulation events from this element in app code. (Se hereda de UIElement)

Margin

Lectura/escrituraGets or sets the outer margin of a FrameworkElement. (Se hereda de FrameworkElement)

MaxHeight

Lectura/escrituraGets or sets the maximum height constraint of a FrameworkElement. (Se hereda de FrameworkElement)

MaxLines

Lectura/escrituraGets or sets the maximum lines of text shown in the TextBlock.

MaxLinesProperty

De sólo lecturaIdentifies the MaxLines dependency property.

MaxWidth

Lectura/escrituraGets or sets the maximum width constraint of a FrameworkElement. (Se hereda de FrameworkElement)

MinHeight

Lectura/escrituraGets or sets the minimum height constraint of a FrameworkElement. (Se hereda de FrameworkElement)

MinWidth

Lectura/escrituraGets or sets the minimum width constraint of a FrameworkElement. (Se hereda de FrameworkElement)

Name

Lectura/escrituraGets 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. (Se hereda de FrameworkElement)

Opacity

Lectura/escrituraGets or sets the degree of the object's opacity. (Se hereda de UIElement)

OpticalMarginAlignment

Lectura/escrituraGet or sets a value that indicates how the font is modified to align with fonts of different sizes.

OpticalMarginAlignmentProperty

De sólo lecturaIdentifies the OpticalMarginAlignment dependency property.

Padding

Lectura/escrituraGets 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

De sólo lecturaIdentifies the Padding dependency property.

Parent

De sólo lecturaGets the parent object of this FrameworkElement in the object tree. (Se hereda de FrameworkElement)

PointerCaptures

De sólo lecturaGets the set of all captured pointers, represented as Pointer values. (Se hereda de UIElement)

Projection

Lectura/escrituraGets or sets the perspective projection (3-D effect) to apply when rendering this element. (Se hereda de UIElement)

RenderSize

De sólo lecturaGets the final render size of a UIElement. (Se hereda de UIElement)

RenderTransform

Lectura/escrituraGets or sets transform information that affects the rendering position of a UIElement. (Se hereda de UIElement)

RenderTransformOrigin

Lectura/escrituraGets or sets the origin point of any possible render transform declared by RenderTransform, relative to the bounds of the UIElement. (Se hereda de UIElement)

RequestedTheme

Lectura/escrituraGets or sets the UI theme that is used by the UIElement (and its child elements) for resource determination. The UI theme you specify with RequestedTheme can override the app-level RequestedTheme. (Se hereda de FrameworkElement)

Resources

Lectura/escrituraGets 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. (Se hereda de FrameworkElement)

SelectedText

De sólo lecturaGets a text range of selected text.

SelectedTextProperty

De sólo lecturaIdentifies the SelectedText dependency property.

SelectionEnd

De sólo lecturaGets the end position of the text selected in the TextBlock.

SelectionHighlightColor

Lectura/escrituraGets or sets the brush used to highlight the selected text.

SelectionHighlightColorProperty

De sólo lecturaIdentifies the SelectionHighlightColor dependency property.

SelectionStart

De sólo lecturaGets the starting position of the text selected in the TextBlock.

Style

Lectura/escrituraGets or sets an instance Style that is applied for this object during layout and rendering. (Se hereda de FrameworkElement)

Tag

Lectura/escrituraGets or sets an arbitrary object value that can be used to store custom information about this object. (Se hereda de FrameworkElement)

Text

Lectura/escrituraGets or sets the text contents of a TextBlock.

TextAlignment

Lectura/escrituraGets or sets a value that indicates the horizontal alignment of text content.

TextAlignmentProperty

De sólo lecturaIdentifies the TextAlignment dependency property.

TextLineBounds

Lectura/escrituraGets or sets a value that indicates how the line box height is determined for each line of text in the TextBlock.

TextLineBoundsProperty

De sólo lecturaIdentifies the TextLineBounds dependency property.

TextProperty

De sólo lecturaIdentifies the Text dependency property.

TextReadingOrder

Lectura/escrituraGets or sets a value that indicates how the reading order is determined for the TextBlock.

TextReadingOrderProperty

De sólo lecturaIdentifies the TextReadingOrder dependency property.

TextTrimming

Lectura/escrituraGets or sets the text trimming behavior to employ when content overflows the content area.

TextTrimmingProperty

De sólo lecturaIdentifies the TextTrimming dependency property.

TextWrapping

Lectura/escrituraGets or sets how the TextBlock wraps text.

TextWrappingProperty

De sólo lecturaIdentifies the TextWrapping dependency property.

Transitions

Lectura/escrituraGets or sets the collection of Transition style elements that apply to a UIElement. (Se hereda de UIElement)

Triggers

De sólo lecturaGets the collection of triggers for animations that are defined for a FrameworkElement. Not commonly used. (Se hereda de FrameworkElement)

UseLayoutRounding

Lectura/escrituraGets 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. (Se hereda de UIElement)

VerticalAlignment

Lectura/escrituraGets 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. (Se hereda de FrameworkElement)

Visibility

Lectura/escrituraGets 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. (Se hereda de UIElement)

Width

Lectura/escrituraGets or sets the width of a FrameworkElement. (Se hereda de FrameworkElement)

 

Ejemplos

En el ejemplo siguiente se muestra cómo se utiliza la propiedad LineStackingStrategy para determinar cómo se crean los cuadros de línea para las líneas de texto de un objeto TextBlock. El primer TextBlock tiene un valor LineStackingStrategy de MaxHeight y el segundo TextBlock tiene un valor de BlockLineHeight.


<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>


Requisitos

Cliente mínimo admitido

Windows 8 [Solo aplicaciones de la Tienda Windows]

Servidor mínimo admitido

Windows Server 2012 [Solo aplicaciones de la Tienda Windows]

Espacio de nombres

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

Metadatos

Windows.winmd

Vea también

FrameworkElement

 

 

Mostrar:
© 2014 Microsoft