Run Classe

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Documents

Rappresenta una sezione discreta di testo formattato o non formattato.

public ref class Run sealed : Inline

/// [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)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Run final : Inline

[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)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Text")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Run : Inline

Public NotInheritable Class Run
Inherits Inline

<Run .../>
-or-
<Run ...>text</Run>

Ereditarietà

Object Platform::Object IInspectable DependencyObject TextElement Inline Run

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute

Requisiti Windows

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

Esempio

Ogni esempio illustrato di seguito esegue il rendering dello stesso risultato. Tuttavia, l'impostazione della proprietà Text direttamente su 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 usato in textBlock o RichTextBlock. È possibile inserire più elementi Run all'interno di un intervallo.

Quando si usa TextBlock, impostare la proprietà TextBlock.Text direttamente per ottenere prestazioni ottimali. In genere si usa l'elemento Run solo quando si vuole formattare una sezione discreta di testo all'interno di TextBlock.

Per altri esempi, vedi

• TextBlock
• Guida al controllo TextBlock
• RichTextBlock
• Guida al controllo RichTextBlock

Costruttori

Run()

Inizializza una nuova istanza della classe Run .

Proprietà

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 nell'albero visivo 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à pari a 1/1000 di un 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	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. (Ereditato da TextElement)
ElementStart	Ottiene un TextPointer che rappresenta la posizione appena prima dell'inizio dell'elemento. (Ereditato da TextElement)
ExitDisplayModeOnAccessKeyInvoked	Ottiene o imposta un valore che specifica se la visualizzazione della chiave di accesso viene ignorata quando viene richiamata una chiave di accesso. (Ereditato da TextElement)
FlowDirection	Ottiene o imposta la direzione in cui il testo e altri elementi dell'interfaccia utente vengono trasmessi 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 le dimensioni 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 carattere per il contenuto in questo elemento. (Ereditato da TextElement)
FontWeight	Ottiene o imposta il peso 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 di chiave di accesso. (Ereditato da TextElement)
IsTextScaleFactorEnabled	Ottiene o imposta se l'ingrandimento automatico del testo, per riflettere l'impostazione delle dimensioni del testo di sistema, è abilitata. (Ereditato da TextElement)
KeyTipHorizontalOffset	Ottiene o imposta un valore che indica la posizione della descrizione chiave a sinistra o destra 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 il basso della descrizione chiave in relazione all'elemento di testo. (Ereditato da TextElement)
Language	Ottiene o imposta informazioni sul linguaggio di localizzazione/globalizzazione applicabili a 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

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. (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 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. (Ereditato da TextElement)
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. (Ereditato da TextElement)
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. (Ereditato da TextElement)
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. (Ereditato da TextElement)

Vedi anche

• Inline
• TextBlock
• RichTextBlock