TextElement Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Xaml.Documents

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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: Windows.UI.Xaml.Documents.Block

Windows.UI.Xaml.Documents.Inline

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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