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(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

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 otras formas 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 según lo habilitado por la fuente determinada que eligió para establecer FontFamily en ese elemento de texto.

TextElement no define inherentemente 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 visualización de ese texto dentro de una interfaz de usuario. Para ello, debes usar uno de los controles o elementos que son descendientes de UIElement y 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 líneas solo con su colección Inlines .
  • RichTextBlock: admite un modelo de objetos de texto de 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 diseñadores).

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 recorrer el 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 Bloque de texto.

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, aunque 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 un elemento 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

Siempre devuelve null en una aplicación de SDK de Aplicaciones para Windows. Use DispatcherQueue en su lugar.

(Heredado de DependencyObject)
DispatcherQueue

Obtiene el objeto DispatcherQueue al que está asociado este objeto. DispatcherQueue representa una instalación que puede acceder al DependencyObject en el subproceso de 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 para el 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 en la familia de fuentes del 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 de 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 la información sobre claves en relación con el elemento de texto.

KeyTipPlacementModeProperty

Identifica la propiedad de dependencia KeyTipPlacementMode .

KeyTipVerticalOffset

Obtiene o establece un valor que indica la distancia hacia arriba o hacia abajo de 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 los elementos se quitan 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 llamando a RegisterPropertyChangedCallback.

(Heredado de DependencyObject)

Eventos

AccessKeyDisplayDismissed

Se produce cuando la secuencia de claves de acceso se completa 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