Compartir a través de


TextElement Clase

Definición

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
Atributos

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:

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.

Se aplica a

Consulte también