Span Classe

Definizione

Raggruppa altri elementi contenuto Inline . Classe padre per Grassetto, Collegamento ipertestuale, Corsivo e Sottolineatura.

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
/// [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 Span : Inline
[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Inlines")]
[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 Span : Inline
Public Class Span
Inherits Inline
<Span .../>
-or-
<Span ...>
  oneOrMoreInlines
</Span>
-or-
<Span ...>
  mixedContent
</Span>
Ereditarietà
Derivato
Attributi

Commenti

È possibile usare Span come elemento oggetto in XAML per racchiudere il testo. In questo modo è possibile usare span un utilizzo simile al 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 include funzionalità simili per l'applicazione delle proprietà TextElement a un intervallo di testo, ma Run non supporta il contenuto misto(la relativa proprietà contenuto XAML Run.Text può contenere solo il testo, non il contenuto misto e altre inline).

Span supporta contenuto misto se si imposta il contenuto in XAML. Ciò significa che è possibile combinare tag Inline , ad esempio Run, Bold e così via con il contenuto di testo XAML (testo normale), senza restrizioni sull'ordine in cui devono essere visualizzati i tag rispetto al testo. Tutto il testo, indipendentemente dal testo normale o racchiuso in un tag Inline , esegue il rendering nell'ordine di definizione del testo 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 di raccolta 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 del contenuto XAML, indipendentemente dai tag o dal testo direttamente all'interno di un elemento Span, indica che la proprietà Inlines è la proprietà contenuto XAML. Per altre informazioni sulle proprietà del contenuto XAML, vedere la sezione "Proprietà contenuto XAML" della guida alla sintassi XAML.

Gli elementi span vengono in genere usati come elementi in un oggetto InlineCollection, come elementi figlio di un paragrafo (diventa parte di Paragraph.Inlines) o come contenuto di un altro span (diventa parte di Span.Inlines).

Intervalli di classi derivate

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

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 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

Restituisce null sempre in un'app SDK per app di Windows. Usare invece DispatcherQueue .

(Ereditato da DependencyObject)
DispatcherQueue

Ottiene l'oggetto DispatcherQueue associato. Rappresenta DispatcherQueue una struttura che può accedere al thread dell'interfaccia utente anche se il codice viene avviato da un thread non dell'interfaccia DependencyObject 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)
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)
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 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)
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)

Si applica a

Vedi anche