Span 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

Raggruppa altri elementi di contenuto Inline . Classe padre per Bold, Hyperlink, Italic e Underline.

/// [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="Inlines")]
class Span : 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="Inlines")]
public class Span : Inline

Public Class Span
Inherits Inline

<Span .../>
-or-
<Span ...>
  oneOrMoreInlines
</Span>
-or-
<Span ...>
  mixedContent
</Span>

Ereditarietà: Object IInspectable DependencyObject TextElement Inline Span

Derivato: Windows.UI.Xaml.Documents.Bold

Windows.UI.Xaml.Documents.Hyperlink

Windows.UI.Xaml.Documents.Italic

Windows.UI.Xaml.Documents.Underline

Attributi: 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)

Commenti

Puoi usare Span come elemento oggetto in XAML per racchiudere il testo. Ciò consente un utilizzo simile a come è possibile usare il span tag in HTML. Per questo utilizzo si impostano gli attributi supportati da TextElement , ad esempio FontSize o FontFamily, in modo da poter applicare queste decisioni di formattazione del testo all'intervallo di testo racchiuso. L'esecuzione ha funzionalità simili per l'applicazione di proprietà TextElement a un intervallo di testo, ma Run non supporta il contenuto misto. La proprietà contenuto XAML Run.Text può contenere solo testo, non contenuto misto e altre inline.

Span supporta contenuti misti se imposti il contenuto in XAML. Ciò significa che puoi combinare tag Inline , ad esempio Esegui, Grassetto e così via con il contenuto di testo XAML (testo normale), senza restrizioni sull'ordine in cui devono essere visualizzati i tag e il testo. Tutto il testo, sia testo normale che come racchiuso in un tag Inline , esegue il rendering nell'ordine in cui il testo è definito nel contenuto misto. Ad esempio, questo è xaml legale:

<RichTextBlock>
  <Paragraph>
    <Span>This is <Bold>mixed content</Bold> with multiple text areas <Italic> and inlines</Italic>.</Span>
  </Paragraph>
</RichTextBlock>

Quando il contenuto misto viene analizzato da XAML e il modello a oggetti di testo viene esaminato in fase di esecuzione, qualsiasi area di testo proveniente dal testo normale genera un oggetto Run nella posizione appropriata dell'ordine di lettura nella classe dell'insieme InlineCollection che consente l'accesso in fase di esecuzione. L'elemento Run contiene il testo, ma in caso contrario non dispone di proprietà impostate.

Nota

L'inserimento di contenuto XAML indipendentemente dal fatto che i tag o il testo direttamente all'interno di un elemento Span siano supportati perché Span indica che la relativa proprietà Inlines è la proprietà del contenuto XAML. Per altre info sulle proprietà del contenuto XAML, vedi la sezione "Proprietà contenuto XAML" della guida alla sintassi XAML.

Gli elementi Span vengono in genere utilizzati come elementi all'interno di un oggetto InlineCollection, come elementi figlio di un paragraph (diventa parte di Paragraph.Inlines) o come contenuto di un altro span (diventa parte di Span.Inlines).

Estendere le classi derivate

Span è la classe padre per diverse classi derivate che definiscono un'area di testo inline con una convenzione di formattazione specifica:

Grassetto
Collegamento ipertestuale
Corsivo
Il collegamento ipertestuale sottolineato consente un comportamento di clic che passa all'oggetto NavigateUri. Le altre classi derivate Span possono essere considerate come decorazioni specifiche della classe al testo e non aggiungere in altro modo l'interazione.

Costruttori

Span()

Inizializza una nuova istanza della classe Span .

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 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 misura 1/1000 di un em. (Ereditato da TextElement)
ContentEnd	Ottiene un oggetto 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 a cui è associato questo oggetto. CoreDispatcher rappresenta una funzionalità che può accedere a DependencyObject nel thread dell'interfaccia utente anche se il codice viene avviato da un thread non dell'interfaccia utente. (Ereditato da DependencyObject)
ElementEnd	Ottiene un textPointer che rappresenta la posizione subito dopo la fine dell'elemento. (Ereditato da TextElement)
ElementStart	Ottiene un oggetto 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 del tasto di scelta viene chiusa quando viene richiamata una chiave di scelta. (Ereditato da TextElement)
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 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 di questo elemento. (Ereditato da TextElement)
Inlines	Ottiene un oggetto InlineCollection contenente gli elementi inline di primo livello che includono il contenuto di Span.
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'estrema 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 inserito il suggerimento chiave in relazione all'elemento di testo. (Ereditato da TextElement)
KeyTipVerticalOffset	Ottiene o imposta un valore che indica la distanza verso l'alto o il basso del suggerimento per il tasto di scelta rapida rispetto all'elemento di testo. (Ereditato da TextElement)
Language	Ottiene o imposta le informazioni sulla lingua di localizzazione/globalizzazione applicabili a un 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)
TextDecorations	Ottiene o imposta un valore che indica quali decorazioni vengono applicate al testo. (Ereditato da TextElement)
XamlRoot	Ottiene o imposta l'elemento 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 del modello a oggetti o del 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 apportate a una dipendenza specifica in questa istanza di DependencyObject . (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza su 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 tasti di scelta è completata per notificare ai controlli che devono nascondere gli oggetti visivi della chiave di accesso. (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 chiave di accesso. (Ereditato da TextElement)
AccessKeyInvoked	Si verifica quando un utente completa una sequenza di tasti di scelta per notificare all'elemento che l'azione chiave di accesso deve essere richiamata. (Ereditato da TextElement)

Si applica a