TextElement Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 : DependencyObjectPublic Class TextElement
Inherits DependencyObject- Herencia
- 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. |