TextElement Classe
Definizione
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.
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
- Ereditarietà
- Derivato
- Attributi
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 di blocco, vedere Blocco di testo.
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 |
Restituisce |
DispatcherQueue |
Ottiene l'oggetto |
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. |