TextElement Clase

Definición

Espacio de nombres:

Windows.UI.Xaml.Documents

Una clase abstracta que se usa como clase base para las clases Block e Inline también abstractas. TextElement admite api común para las clases implicadas en el modelo de objetos de texto XAML, como propiedades que controlan el tamaño del texto, las familias de fuentes, etc.

public ref class TextElement : DependencyObject

/// [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 TextElement : DependencyObject

[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 TextElement : DependencyObject

Public Class TextElement
Inherits DependencyObject

Herencia

Object Platform::Object IInspectable DependencyObject TextElement

Derivado

Windows.UI.Xaml.Documents.Block

Windows.UI.Xaml.Documents.Inline

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Las distintas propiedades definidas por TextElement admiten una API común para las clases implicadas en el modelo de objetos de texto XAML. Esta es una lista de las propiedades más usadas:

• FontFamily
• FontSize
• FontStretch
• Primer plano

Al establecer las propiedades TextElement, puede aplicar propiedades de formato de texto comunes al texto, tanto en bloques como en líneas. También hay maneras adicionales de dar formato al texto, pero no son compatibles directamente con TextElement. En su lugar, puede usar las propiedades adjuntas de la clase Typography . Las propiedades adjuntas de tipografía suelen admitir características o convenciones tipográficas avanzadas, como el acceso a características tipográficas definidas en el nivel de fuente que no son necesariamente compatibles con todas las fuentes. Por ejemplo, podría establecer Typography.Variants como una propiedad adjunta en cualquier bloque de texto o insertado, y esto influiría en el comportamiento de las variantes de fuente como habilitado por la fuente determinada que eligió para establecer FontFamily en ese elemento de texto.

TextElement no define de forma inherente un punto de conexión a un árbol visual XAML. En otras palabras, un TextElement define el modelo de objetos de texto y texto dentro de ese texto, pero aún no habilita la presentación de ese texto dentro de una interfaz de usuario. Para ello, debes usar uno de los controles o elementos descendientes de UIElement y que se pueden conectar al árbol XAML y al objeto visual raíz de la ventana de la aplicación. Hay dos elementos de este tipo en el Windows Runtime:

• TextBlock: admite un modelo de objetos de texto de inlines solo con su colección Inlines .
• RichTextBlock: admite un modelo de objetos de texto en bloque con su colección Blocks . Los bloques pueden contener bloques e inlines.

Nota

PasswordBox, RichEditBox y TextBox no admiten un modelo de objetos de texto basado en TextElement. RichEditBox habilita el acceso mediante programación a un modelo de objetos de texto diferente a través de la interfaz ITextDocument .

TextElement define la API que admite el examen del modelo de objetos de texto como objetos de programación después de analizar el XAML. En concreto, TextElement implementa Name y Language, que las propiedades paralelas del mismo nombre en FrameworkElement. TextElement también implementa FindName (un método de utilidad para buscar objetos en tiempo de ejecución en función de cómo se estableció Name en XAML inicial) y OnDisconnectVisualChildren (para escenarios avanzados y compatibilidad con el diseñador).

TextElement tiene cuatro propiedades que proporcionan acceso a objetos TextPointer desde el texto. Estas propiedades son: ContentStart, ContentEnd, ElementStart, ElementEnd. Un Windows Runtime objeto TextPointer proporciona un punto de entrada para el recorrido del contenido. Para obtener más información, vea TextPointer.

TextElement es una clase derivada de DependencyObject. Esto significa que puede definir propiedades de dependencia y cada una de las propiedades de lectura y escritura de TextElement es una propiedad de dependencia, con su identificador de propiedad también definido por TextElement. Para obtener más información sobre qué propiedades de dependencia habilitan, consulte Información general sobre las propiedades de dependencia.

Clases derivadas textElement

TextElement es la clase primaria de dos clases derivadas que dividen el modelo de objetos de texto en dos convenciones de uso de texto: Block e Inline. Block e Inline se consideran clases base (normalmente no se ve una <Block> etiqueta en XAML) y existen en la jerarquía principalmente para ser la clase primaria de otros elementos de texto prácticos. Por ejemplo, Block es la clase primaria de Paragraph. Para obtener más información sobre cómo usar elementos de bloque e insertados, consulta Inicio rápido: Mostrar texto.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1607	14393	AccessKey
1607	14393	AllowFocusOnInteraction
1607	14393	ExitDisplayModeOnAccessKeyInvoked
1703	15063	AccessKeyDisplayDismissed
1703	15063	AccessKeyDisplayRequested
1703	15063	AccessKeyInvoked
1703	15063	AccessKeyScopeOwner
1703	15063	IsAccessKeyScope
1703	15063	KeyTipHorizontalOffset
1703	15063	KeyTipPlacementMode
1703	15063	KeyTipVerticalOffset
1703	15063	TextDecorations
1903	18362	XamlRoot

Propiedades

AccessKey	Obtiene o establece la clave de acceso de este elemento.
AccessKeyProperty	Identifica la propiedad de dependencia AccessKey .
AccessKeyScopeOwner	Obtiene o establece un elemento de origen que proporciona el ámbito de la clave de acceso para este elemento, incluso si no está en el árbol visual del elemento de origen.
AccessKeyScopeOwnerProperty	Identifica la propiedad de dependencia AccessKeyScopeOwner .
AllowFocusOnInteraction	Obtiene o establece un valor que indica si el elemento obtiene automáticamente el foco cuando el usuario interactúa con él.
AllowFocusOnInteractionProperty	Identifica la propiedad de dependencia AllowFocusOnInteraction .
CharacterSpacing	Obtiene o establece el espaciado uniforme entre caracteres, en unidades de 1/1000 de em.
CharacterSpacingProperty	Identifica la propiedad de dependencia CharacterSpacing .
ContentEnd	Obtiene un TextPointer que representa el final del contenido del elemento .
ContentStart	Obtiene un TextPointer que representa el inicio del contenido en el elemento .
Dispatcher	Obtiene el CoreDispatcher al que está asociado este objeto. CoreDispatcher representa una instalación que puede acceder a DependencyObject en el subproceso de la interfaz de usuario, incluso si un subproceso que no es de interfaz de usuario inicia el código. (Heredado de DependencyObject)
ElementEnd	Obtiene un TextPointer que representa la posición justo después del final del elemento.
ElementStart	Obtiene un TextPointer que representa la posición justo antes del inicio del elemento.
ExitDisplayModeOnAccessKeyInvoked	Obtiene o establece un valor que especifica si se descarta la presentación de la clave de acceso cuando se invoca una clave de acceso.
ExitDisplayModeOnAccessKeyInvokedProperty	Identifica la propiedad de dependencia ExitDisplayModeOnAccessKeyInvoked .
FontFamily	Obtiene o establece la familia de fuentes de nivel superior preferida para el contenido del elemento.
FontFamilyProperty	Identifica la propiedad de dependencia FontFamily .
FontSize	Obtiene o establece el tamaño de fuente para el contenido del elemento.
FontSizeProperty	Identifica la propiedad de dependencia FontSize .
FontStretch	Obtiene o establece el ancho del glifo de la fuente de una familia que se va a seleccionar.
FontStretchProperty	Identifica la propiedad de dependencia FontStretch .
FontStyle	Obtiene o establece el estilo de fuente del contenido de este elemento.
FontStyleProperty	Identifica la propiedad de dependencia FontStyle .
FontWeight	Obtiene o establece el peso de fuente de nivel superior que se va a seleccionar de la familia de fuentes para el contenido de este elemento.
FontWeightProperty	Identifica la propiedad de dependencia FontWeight .
Foreground	Obtiene o establece el pincel que se va a aplicar al contenido de este elemento.
ForegroundProperty	Identifica la propiedad de dependencia Foreground .
IsAccessKeyScope	Obtiene o establece un valor que indica si un elemento define su propio ámbito de clave de acceso.
IsAccessKeyScopeProperty	Identifica la propiedad de dependencia IsAccessKeyScope .
IsTextScaleFactorEnabled	Obtiene o establece si la ampliación automática del texto, para reflejar la configuración del tamaño del texto del sistema, está habilitada.
IsTextScaleFactorEnabledProperty	Identifica la propiedad de dependencia IsTextScaleFactorEnabled .
KeyTipHorizontalOffset	Obtiene o establece un valor que indica la distancia izquierda o derecha que se coloca la información sobre claves en relación con el elemento de texto.
KeyTipHorizontalOffsetProperty	Identifica la propiedad de dependencia KeyTipHorizontalOffset .
KeyTipPlacementMode	Obtiene o establece un valor que indica dónde se coloca keyTip en relación con el elemento de texto.
KeyTipPlacementModeProperty	Identifica la propiedad de dependencia KeyTipPlacementMode .
KeyTipVerticalOffset	Obtiene o establece un valor que indica hasta dónde se coloca la información sobre claves en relación con el elemento de texto.
KeyTipVerticalOffsetProperty	Identifica la propiedad de dependencia KeyTipVerticalOffset .
Language	Obtiene o establece información de idioma de localización o globalización que se aplica a un TextElement.
LanguageProperty	Identifica la propiedad de dependencia Language .
Name	Obtiene o establece una identificación única para el objeto . El nombre solo se puede establecer a partir del análisis inicial de XAML.
TextDecorations	Obtiene o establece un valor que indica qué decoraciones se aplican al texto.
TextDecorationsProperty	Identifica la propiedad de dependencia TextDecorations .
XamlRoot	Obtiene o establece el xamlRoot en el que se está viendo este elemento.

Métodos

ClearValue(DependencyProperty)	Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject)
FindName(String)	Recupera un objeto en el gráfico de objetos en tiempo de ejecución o modelo de objetos haciendo referencia al valor del atributo x:Name o Name del objeto.
GetAnimationBaseValue(DependencyProperty)	Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia de dependencyObject. (Heredado de DependencyObject)
OnDisconnectVisualChildren()	Invalide este método para implementar cómo debe comportarse el diseño y la lógica cuando se quitan elementos de una propiedad secundaria o contenido específico de clase.
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una función de notificación para escuchar los cambios en una dependencyProperty específica en esta instancia de DependencyObject . (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia en dependencyObject. (Heredado de DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Cancela una notificación de cambio registrada anteriormente mediante una llamada a RegisterPropertyChangedCallback. (Heredado de DependencyObject)

Eventos

AccessKeyDisplayDismissed	Se produce cuando se completa la secuencia de claves de acceso para notificar a los controles que deben ocultar los objetos visuales de clave de acceso.
AccessKeyDisplayRequested	Se produce cuando se inicia la secuencia de claves de acceso para notificar a los controles que deben mostrar objetos visuales de clave de acceso.
AccessKeyInvoked	Se produce cuando un usuario completa una secuencia de claves de acceso para notificar al elemento que se debe invocar la acción de clave de acceso.

Consulte también

• DependencyObject
• Block
• Inline
• Typography
• Inicio rápido: Mostrar texto