Run 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.
Rappresenta una sezione discreta di testo formattato o non formattato.
public ref class Run sealed : Inline
/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Text")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [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 Run final : Inline
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Text")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[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 sealed class Run : Inline
Public NotInheritable Class Run
Inherits Inline
<Run .../>
-or-
<Run ...>text</Run>
- Ereditarietà
- Attributi
Esempio
Ogni esempio illustrato di seguito esegue il rendering dello stesso risultato. Tuttavia, l'impostazione della proprietà Text direttamente in TextBlock offre prestazioni ottimali.
<!-- Set the TextBlock.Text property directy for best performance. -->
<TextBlock Text="This is some text."/>
<TextBlock><Run>This is some text.</Run></TextBlock>
<TextBlock><Run Text="This is some text."></Run></TextBlock>
// Set the TextBlock.Text property directy for best performance.
TextBlock textblock = new TextBlock();
textblock.Text = "This is some text.";
TextBlock textblock = new TextBlock();
Run run = new Run();
run.Text = "This is some text.";
textblock.Inlines.Add(run);
Commenti
Un oggetto Run rappresenta una sezione discreta di testo formattato o non formattato e può essere utilizzata in un controllo TextBlock o RichTextBlock. È possibile inserire più elementi Run all'interno di un oggetto Span.
Quando si usa un controllo TextBlock, impostare direttamente la proprietà TextBlock.Text per ottenere prestazioni ottimali. In genere si usa l'elemento Run solo quando si desidera formattare una sezione discreta di testo all'interno di TextBlock.
Per altri esempi, vedere
Costruttori
| Nome | Descrizione |
|---|---|
| Run() |
Inizializza una nuova istanza della classe Run . |
Proprietà
| Nome | Descrizione |
|---|---|
| AccessKey |
Ottiene o imposta la chiave di accesso per questo elemento. (Ereditato da TextElement) |
| AccessKeyScopeOwner |
Ottiene o imposta un elemento di origine che fornisce l'ambito della chiave di accesso per questo elemento, anche se non si trova nella struttura ad albero visuale dell'elemento di origine. (Ereditato da TextElement) |
| AllowFocusOnInteraction |
Ottiene o imposta un valore che indica se l'elemento ottiene automaticamente lo stato attivo quando l'utente interagisce con esso. (Ereditato da TextElement) |
| CharacterSpacing |
Ottiene o imposta la spaziatura uniforme tra i caratteri, in unità di 1/1000 di em. (Ereditato da TextElement) |
| ContentEnd |
Ottiene un textpointer che rappresenta la fine del contenuto nell'elemento . (Ereditato da TextElement) |
| ContentStart |
Ottiene un textpointer che rappresenta l'inizio del contenuto nell'elemento . (Ereditato da TextElement) |
| Dispatcher |
Restituisce |
| DispatcherQueue |
Ottiene l'oggetto |
| ElementEnd |
Ottiene un textpointer che rappresenta la posizione subito dopo la fine dell'elemento. (Ereditato da TextElement) |
| ElementStart |
Ottiene un textpointer che rappresenta la posizione immediatamente prima dell'inizio dell'elemento. (Ereditato da TextElement) |
| ExitDisplayModeOnAccessKeyInvoked |
Ottiene o imposta un valore che specifica se la visualizzazione della chiave di scelta viene chiusa quando viene richiamata una chiave di scelta. (Ereditato da TextElement) |
| FlowDirection |
Ottiene o imposta la direzione di flusso del testo e di altri elementi dell'interfaccia utente all'interno dell'elemento Run che controlla il layout. |
| FlowDirectionProperty |
Identifica la proprietà di dipendenza FlowDirection . |
| FontFamily |
Ottiene o imposta la famiglia di caratteri di primo livello preferita per il contenuto dell'elemento. (Ereditato da TextElement) |
| FontSize |
Ottiene o imposta la dimensione del carattere per il contenuto dell'elemento. (Ereditato da TextElement) |
| FontStretch |
Ottiene o imposta la larghezza del glifo del tipo di carattere in una famiglia da selezionare. (Ereditato da TextElement) |
| FontStyle |
Ottiene o imposta lo stile del tipo di carattere per il contenuto in questo elemento. (Ereditato da TextElement) |
| FontWeight |
Ottiene o imposta lo spessore del carattere di primo livello da selezionare dalla famiglia di caratteri per il contenuto in questo elemento. (Ereditato da TextElement) |
| Foreground |
Ottiene o imposta il pennello da applicare al contenuto in questo elemento. (Ereditato da TextElement) |
| IsAccessKeyScope |
Ottiene o imposta un valore che indica se un elemento definisce il proprio ambito della chiave di accesso. (Ereditato da TextElement) |
| IsTextScaleFactorEnabled |
Ottiene o imposta un valore che indica se l'ingrandimento automatico del testo, in base all'impostazione delle dimensioni del testo di sistema, è abilitato. (Ereditato da TextElement) |
| KeyTipHorizontalOffset |
Ottiene o imposta un valore che indica l'estremità sinistra o destra del suggerimento per il tasto di scelta rapida rispetto all'elemento di testo. (Ereditato da TextElement) |
| KeyTipPlacementMode |
Ottiene o imposta un valore che indica dove viene inserita la descrizione chiave in relazione all'elemento di testo. (Ereditato da TextElement) |
| KeyTipVerticalOffset |
Ottiene o imposta un valore che indica l'altezza o la riduzione del suggerimento per il tasto di scelta rapida rispetto all'elemento di testo. (Ereditato da TextElement) |
| Language |
Ottiene o imposta informazioni sul linguaggio di localizzazione/globalizzazione applicabili a un oggetto TextElement. (Ereditato da TextElement) |
| Name |
Ottiene o imposta un'identificazione univoca per l'oggetto . Il nome può essere impostato solo dall'analisi iniziale di XAML. (Ereditato da TextElement) |
| Text |
Ottiene o imposta il contenuto di testo dell'oggetto Run. |
| TextDecorations |
Ottiene o imposta un valore che indica quali decorazioni vengono applicate al testo. (Ereditato da TextElement) |
| XamlRoot |
Ottiene o imposta xamlRoot in cui viene visualizzato questo elemento. (Ereditato da TextElement) |
Metodi
| Nome | Descrizione |
|---|---|
| ClearValue(DependencyProperty) |
Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject) |
| FindName(String) |
Recupera un oggetto nel grafico a oggetti del modello a oggetti o dell'oggetto runtime facendo riferimento al valore dell'attributo x:Name o Name dell'oggetto. (Ereditato da TextElement) |
| 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 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. (Ereditato da TextElement) |
| ReadLocalValue(DependencyProperty) |
Restituisce il valore locale di una proprietà di dipendenza, se è impostato un valore locale. (Ereditato da DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registra una funzione di notifica per l'ascolto delle modifiche a una dipendenza specifica in questa istanza dependencyObject . (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
| Nome | Descrizione |
|---|---|
| AccessKeyDisplayDismissed |
Si verifica quando la sequenza di tasti di scelta è completa per notificare ai controlli che devono nascondere gli oggetti visivi dei tasti di scelta. (Ereditato da TextElement) |
| AccessKeyDisplayRequested |
Si verifica quando viene avviata la sequenza di tasti di scelta per notificare ai controlli che devono visualizzare gli oggetti visivi della chiave di accesso. (Ereditato da TextElement) |
| AccessKeyInvoked |
Si verifica quando un utente completa una sequenza di tasti di scelta per notificare all'elemento che deve essere richiamata l'azione della chiave di accesso. (Ereditato da TextElement) |