TextElement Classe

Definizione

Classe astratta usata come classe di base per le classi Block e Inline astratte. TextElement supporta l'API comune per le classi coinvolte nel modello a oggetti di testo XAML, ad esempio proprietà che controllano le dimensioni del testo, le famiglie di caratteri e così via.

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
Ereditarietà
Object Platform::Object IInspectable DependencyObject TextElement
Derivato
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Le varie proprietà definite da TextElement supportano un'API comune per le classi coinvolte nel modello a oggetti di testo XAML. Ecco un elenco delle proprietà più comunemente usate:

Impostando le proprietà TextElement, è possibile applicare proprietà comuni di formattazione del testo al testo, sia in blocchi che inline. Esistono anche modi aggiuntivi per formattare il testo, ma questi non sono supportati direttamente da TextElement. È invece possibile usare le proprietà associate della classe Typography . Le proprietà associate alla tipografia supportano in genere funzionalità o convenzioni tipografiche avanzate, ad esempio l'accesso alle funzionalità tipografiche definite a livello di carattere che non sono necessariamente supportate da tutti i tipi di carattere. Ad esempio, è possibile impostare Typography.Variants come proprietà associata su qualsiasi blocco di testo o inline e ciò influisce sul comportamento delle varianti di carattere come abilitato dal tipo di carattere scelto per impostare FontFamily su tale elemento di testo.

TextElement non definisce intrinsecamente un punto di connessione a un albero visivo XAML. In altre parole, un TextElement definisce il testo e il modello a oggetti di testo all'interno di tale testo, ma non abilita ancora la visualizzazione del testo all'interno di un'interfaccia utente. A tale scopo, è necessario usare uno dei controlli o degli elementi discendenti di UIElement e può essere connesso all'albero XAML e all'oggetto visivo radice della finestra dell'app. Esistono due elementi di questo tipo nel Windows Runtime:

  • TextBlock: supporta un modello a oggetti di testo di inline solo con la relativa raccolta Inlines .
  • RichTextBlock: supporta un modello a oggetti a testo a blocchi con la relativa raccolta Block . I blocchi possono contenere blocchi e inline.

Nota

PasswordBox, RichEditBox e TextBox non supportano un modello a oggetti di testo basato su TextElement. RichEditBox abilita l'accesso a livello di codice a un modello a oggetti di testo diverso tramite l'interfaccia ITextDocument .

TextElement definisce l'API che supporta l'analisi del modello a oggetti di testo come oggetti di programmazione dopo l'analisi di XAML. In particolare TextElement implementa Name and Language, che le proprietà parallele dello stesso nome in FrameworkElement. TextElement implementa anche FindName (un metodo di utilità per la ricerca di oggetti in fase di esecuzione in base al modo in cui Name è stato impostato in XAML iniziale) e OnDisconnectVisualChildren (per scenari avanzati e supporto della finestra di progettazione).

TextElement ha quattro proprietà che forniscono l'accesso agli oggetti TextPointer dall'interno del testo. Queste proprietà sono: ContentStart, ContentEnd, ElementStart, ElementEnd. Un oggetto TextPointer Windows Runtime fornisce un punto di ingresso per l'attraversamento del contenuto. Per altre informazioni, vedere TextPointer.

TextElement è una classe derivata da DependencyObject. Ciò significa che può definire le proprietà di dipendenza e ognuna delle proprietà di lettura-scrittura di TextElement è una proprietà di dipendenza, con il relativo identificatore di proprietà definito anche da TextElement. Per altre informazioni sulle proprietà di dipendenza abilitate, vedere Panoramica delle proprietà di dipendenza.

Classi derivate di TextElement

TextElement è la classe padre per due classi derivate che suddivideno il modello a oggetti di testo in due convenzioni di utilizzo del testo: Block e Inline. Block e Inline sono entrambe considerate classi di base (in genere non viene visualizzato un <Block> tag in XAML) ed esistono nella gerarchia principalmente per essere la classe padre di altri elementi di testo pratici. Ad esempio, Block è la classe padre di Paragraph. Per altre informazioni su come usare elementi inline e blocchi, vedere Avvio rapido: Visualizzazione del testo.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
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

Proprietà

AccessKey

Ottiene o imposta la chiave di accesso per questo elemento.

AccessKeyProperty

Identifica la proprietà di dipendenza AccessKey .

AccessKeyScopeOwner

Ottiene o imposta un elemento di origine che fornisce l'ambito della chiave di accesso per questo elemento, anche se non si trova nell'albero visivo dell'elemento di origine.

AccessKeyScopeOwnerProperty

Identifica la proprietà di dipendenza AccessKeyScopeOwner .

AllowFocusOnInteraction

Ottiene o imposta un valore che indica se l'elemento ottiene automaticamente lo stato attivo quando l'utente interagisce con esso.

AllowFocusOnInteractionProperty

Identifica la proprietà di dipendenza AllowFocusOnInteraction .

CharacterSpacing

Ottiene o imposta la spaziatura uniforme tra i caratteri, in unità pari a 1/1000 di un em.

CharacterSpacingProperty

Identifica la proprietà di dipendenza CharacterSpacing .

ContentEnd

Ottiene un TextPointer che rappresenta la fine del contenuto nell'elemento.

ContentStart

Ottiene un TextPointer che rappresenta l'inizio del contenuto nell'elemento.

Dispatcher

Ottiene CoreDispatcher associato a questo oggetto. CoreDispatcher rappresenta una struttura che può accedere a DependencyObject nel thread dell'interfaccia utente anche se il codice viene avviato da un thread non interfaccia utente.

(Ereditato da DependencyObject)
ElementEnd

Ottiene un TextPointer che rappresenta la posizione appena dopo la fine dell'elemento.

ElementStart

Ottiene un TextPointer che rappresenta la posizione appena prima dell'inizio dell'elemento.

ExitDisplayModeOnAccessKeyInvoked

Ottiene o imposta un valore che specifica se la visualizzazione della chiave di accesso viene ignorata quando viene richiamata una chiave di accesso.

ExitDisplayModeOnAccessKeyInvokedProperty

Identifica la proprietà di dipendenza ExitDisplayModeOnAccessKeyIn richiamata .

FontFamily

Ottiene o imposta la famiglia di caratteri di primo livello preferita per il contenuto dell'elemento.

FontFamilyProperty

Identifica la proprietà di dipendenza FontFamily .

FontSize

Ottiene o imposta le dimensioni del carattere per il contenuto dell'elemento.

FontSizeProperty

Identifica la proprietà di dipendenza FontSize .

FontStretch

Ottiene o imposta la larghezza del glifo del tipo di carattere in una famiglia da selezionare.

FontStretchProperty

Identifica la proprietà di dipendenza FontStretch .

FontStyle

Ottiene o imposta lo stile del carattere per il contenuto in questo elemento.

FontStyleProperty

Identifica la proprietà di dipendenza FontStyle .

FontWeight

Ottiene o imposta il peso del carattere di primo livello da selezionare dalla famiglia di caratteri per il contenuto in questo elemento.

FontWeightProperty

Identifica la proprietà di dipendenza FontWeight .

Foreground

Ottiene o imposta Il pennello da applicare al contenuto in questo elemento.

ForegroundProperty

Identifica la proprietà di dipendenza in primo piano .

IsAccessKeyScope

Ottiene o imposta un valore che indica se un elemento definisce il proprio ambito di chiave di accesso.

IsAccessKeyScopeProperty

Identifica la proprietà di dipendenza IsAccessKeyScope .

IsTextScaleFactorEnabled

Ottiene o imposta se l'ingrandimento automatico del testo, per riflettere l'impostazione delle dimensioni del testo di sistema, è abilitata.

IsTextScaleFactorEnabledProperty

Identifica la proprietà di dipendenza IsTextScaleFactorEnabled .

KeyTipHorizontalOffset

Ottiene o imposta un valore che indica la posizione della descrizione chiave a sinistra o destra rispetto all'elemento di testo.

KeyTipHorizontalOffsetProperty

Identifica la proprietà di dipendenza KeyTipHorizontalOffset .

KeyTipPlacementMode

Ottiene o imposta un valore che indica dove viene inserita la descrizione chiave in relazione all'elemento di testo.

KeyTipPlacementModeProperty

Identifica la proprietà di dipendenza KeyTipPlacementMode .

KeyTipVerticalOffset

Ottiene o imposta un valore che indica l'altezza o il basso della descrizione chiave in relazione all'elemento di testo.

KeyTipVerticalOffsetProperty

Identifica la proprietà di dipendenza KeyTipVerticalOffset .

Language

Ottiene o imposta informazioni sul linguaggio di localizzazione/globalizzazione applicabili a textElement.

LanguageProperty

Identifica la proprietà di dipendenza Language .

Name

Ottiene o imposta un'identificazione univoca per l'oggetto. Il nome può essere impostato solo dall'analisi iniziale di XAML.

TextDecorations

Ottiene o imposta un valore che indica quali decorazioni vengono applicate al testo.

TextDecorationsProperty

Identifica la proprietà di dipendenza TextDecorations .

XamlRoot

Ottiene o imposta XamlRoot in cui viene visualizzato questo elemento.

Metodi

ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà di dipendenza.

(Ereditato da DependencyObject)
FindName(String)

Recupera un oggetto nel grafico a oggetti modello/oggetto runtime facendo riferimento al valore dell'attributo x:Name o Name dell'oggetto.

GetAnimationBaseValue(DependencyProperty)

Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva.

(Ereditato da DependencyObject)
GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza da un oggetto DependencyObject.

(Ereditato da DependencyObject)
OnDisconnectVisualChildren()

Eseguire l'override di questo metodo per implementare il comportamento del layout e della logica quando gli elementi vengono rimossi da un contenuto specifico della classe o da una proprietà figlio.

ReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se viene impostato un valore locale.

(Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registra una funzione di notifica per l'ascolto delle modifiche a un'istanza di DependencyObject specifica.

(Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza in un oggetto DependencyObject.

(Ereditato da DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback.

(Ereditato da DependencyObject)

Eventi

AccessKeyDisplayDismissed

Si verifica quando la sequenza di chiavi di accesso viene completata per notificare ai controlli che devono nascondere gli oggetti visivi delle chiavi di accesso.

AccessKeyDisplayRequested

Si verifica quando viene avviata la sequenza di chiavi di accesso per notificare ai controlli che devono visualizzare gli oggetti visivi delle chiavi di accesso.

AccessKeyInvoked

Si verifica quando un utente completa una sequenza di chiavi di accesso per notificare all'elemento che deve essere richiamata l'azione chiave di accesso.

Si applica a

Vedi anche