InlineUIContainer 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.
Fornisce un elemento contenuto inline che consente l'incorporamento dei tipi UIElement nel contenuto di RichTextBlock.
public ref class InlineUIContainer sealed : Inline
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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="Child")]
class InlineUIContainer final : 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="Child")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class InlineUIContainer final : Inline
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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="Child")]
public sealed class InlineUIContainer : 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="Child")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class InlineUIContainer : Inline
Public NotInheritable Class InlineUIContainer
Inherits Inline
<InlineUIContainer .../>
-or-
<InlineUIContainer ...>
singleChild
</InlineUIContainer>
- Ereditarietà
- Attributi
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
Nell'esempio di codice seguente viene illustrato come inserire un'immagine in RichTextBlock usando InlineUIContainer.
<RichTextBlock>
<Paragraph>
<Italic>This is an inline image.</Italic>
<InlineUIContainer>
<Image Source="Assets/SmallLogo.png" Height="30" Width="30"/>
</InlineUIContainer>
Mauris auctor tincidunt auctor.
</Paragraph>
</RichTextBlock>
Commenti
Lo scenario più comune per l'uso di un oggetto InlineUIContainer consiste nell'introdurre un'immagine nel contenuto di testo. Usare un nuovo oggetto Image per l'immagine, come contenuto figlio per un oggetto InlineUIContainer. Impostare Altezza e Larghezza sull'immagine se non si vuole ridimensionare le dimensioni dell'immagine naturale.
Se si vogliono inserire più elementi nella stessa posizione, è consigliabile usare un pannello come singolo elemento Figlio InlineUIContainer e quindi inserire più elementi all'interno di tale pannello.
Se posizionato all'interno di un oggetto InlineUIContainer, un controllo che può essere ancora attivo viene visualizzato nella sequenza di schede di primo livello.
Se si desidera un testo interattivo, è consigliabile usare un elemento Hyperlink (un tipo di Inline) anziché usare InlineUIContainer con un pulsante o un elemento simile all'interno di esso. Vedere Linee guida per i collegamenti.
InlineUIContainer eredita le proprietà dalla classe TextElement . Tuttavia, la maggior parte di queste proprietà non ha alcun effetto visibile. È più comune dichiarare un elemento oggetto InlineUIContainer in XAML senza che sia presente alcun set di attributi (tranne eventualmente attributo x:Name) con l'elemento figlio singolo che si sta inlining come contenuto dell'elemento oggetto InlineUIContainer.
L'impostazione delle proprietà in InlineUIContainer che in caso contrario influisce sull'altezza della riga di carattere di un elemento di testo (ad esempio FontSize, FontFamily) non ha alcun effetto sul rendering e sull'aspetto. Il contenuto determina le dimensioni e le dimensioni inlineUIContainer per adattarla.
Se all'interno del contenuto figlio è presente un ulteriore testo ,ad esempio TextBlock.Text o altri elementi di testo all'interno di un richTextBlock annidato, le proprietà dell'elemento di testo dell'elemento InlineUIContainer non ereditano nel contenuto, vengono ignorate.
Costruttori
InlineUIContainer() |
Inizializza una nuova istanza della classe InlineUIContainer . |
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) |
Child |
Ottiene o imposta l'uiElement ospitato da InlineUIContainer. |
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) |
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) |
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) |