ToolTipService Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Xaml.Controls

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

Rappresenta un servizio che fornisce metodi statici per visualizzare una descrizione comando.

public ref class ToolTipService sealed

/// [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)]
class ToolTipService final

[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)]
public sealed class ToolTipService

Public NotInheritable Class ToolTipService

Ereditarietà: Object Platform::Object IInspectable ToolTipService

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 vengono illustrate le modalità di posizionamento per una descrizione comando.

<StackPanel Margin="120" >
    <TextBlock Text="ToolTip Control"/>
    <TextBlock Text="Hover over an item to see its ToolTip: " Margin="0,10"/>
    <ListBox Width="100" HorizontalAlignment="Left">
        <ListBoxItem Content="Left" 
            ToolTipService.ToolTip="ToolTip to the left." 
            ToolTipService.Placement="Left" />
        <ListBoxItem Content="Right" 
            ToolTipService.ToolTip="ToolTip to the right." 
            ToolTipService.Placement="Right" />
        <ListBoxItem Content="Top" 
            ToolTipService.ToolTip="ToolTip at the top." 
            ToolTipService.Placement="Top" />
        <ListBoxItem Content="Bottom" 
            ToolTipService.ToolTip="ToolTip at the bottom." 
            ToolTipService.Placement="Bottom"/>
        <ListBoxItem Content="Mouse" 
            ToolTipService.ToolTip="ToolTip based on the cursor position." 
            ToolTipService.Placement="Mouse"/>
    </ListBox>
</StackPanel>

Commenti

Una descrizione comando deve essere assegnata a un altro elemento dell'interfaccia utente che ne è il proprietario. In Extensible Application Markup Language (XAML) usare la proprietà associata ToolTipService.ToolTip per assegnare la descrizione comando a un proprietario. Nel codice usare il metodo ToolTipService.SetToolTip per assegnare la descrizione comando a un proprietario.

Selezione host

Per impostazione predefinita, viene visualizzata una descrizione comando al di sopra del puntatore. Il posizionamento non è vincolato dalla finestra dell'app, quindi la descrizione comando potrebbe essere visualizzata parzialmente o completamente al di fuori dei limiti della finestra dell'app.

Se una descrizione comando oscura il contenuto a cui fa riferimento, è possibile regolarne il posizionamento. Utilizzare la proprietà associata ToolTipService.Placement per posizionare la descrizione comando sopra, sotto, sinistra o destra del puntatore.

Se non esiste posizionamento esplicitoTarget, la destinazione di posizionamento per una descrizione comando è l'elemento che specifica un valore per il valore della proprietà associata TooltipService.ToolTip. Qualsiasi valore Di posizionamento (come proprietà associata o come attributo in un elemento ToolTip esplicito) si applica a tale destinazione.

Note per le versioni precedenti

La descrizione comandodi Windows 8.x è destinata solo all'uso in Windows. Il tipo di descrizione comando è disponibile nei progetti Windows Phone per la compatibilità con i modelli di progetto universali, ma la descrizione comando non viene visualizzata nell'interfaccia utente Windows Phone.

La descrizione comando viene visualizzata solo all'interno dei limiti della finestra dell'app. Il posizionamento potrebbe essere modificato per rimanere all'interno di tali limiti.

Proprietà associate XAML

ToolTipService è la classe di servizio host per diverse proprietà associate XAML.

Per supportare l'accesso al processore XAML alle proprietà associate e anche per esporre operazioni di get e set equivalenti al codice, ogni proprietà associata XAML ha una coppia di metodi di accesso Get e Set. Un altro modo per ottenere o impostare il valore nel codice consiste nell'usare il sistema delle proprietà di dipendenza, chiamando GetValue o SetValue e passando il campo identificatore come identificatore della proprietà di dipendenza.

Proprietà associata	Descrizione
Selezione host	Ottiene o imposta un valore che indica come un oggetto `ToolTip` viene posizionato in relazione alla destinazione di posizionamento.
Placementtarget	Ottiene o imposta l'oggetto relativo al quale è posizionato un `ToolTip` oggetto.
ToolTip	Ottiene o imposta il contenuto dell'oggetto o della stringa di un elemento .`ToolTip`

Proprietà

PlacementProperty	Identifica la proprietà associata ToolTipService.Placement XAML.
PlacementTargetProperty	Identifica la proprietà associata ToolTipService.PlacementTarget XAML.
ToolTipProperty	Identifica la proprietà associata TOOLTipService.ToolTip XAML.

Proprietà associate

Placement	Ottiene o imposta un valore che indica la posizione di una descrizione comando in relazione alla destinazione di posizionamento.
PlacementTarget	Ottiene o imposta l'oggetto relativo al quale viene posizionata una descrizione comando.
ToolTip	Ottiene o imposta il contenuto dell'oggetto o della stringa della descrizione comando di un elemento.

Metodi

GetPlacement(DependencyObject)	Ottiene il valore della proprietà associata ToolTipService.Placement XAML per l'elemento di destinazione specificato.
GetPlacementTarget(DependencyObject)	Ottiene il valore della proprietà associata ToolTipService.PlacementTarget XAML per l'elemento di destinazione specificato.
GetToolTip(DependencyObject)	Ottiene il valore della proprietà associata ToolTipService.ToolTip XAML per un oggetto.
SetPlacement(DependencyObject, PlacementMode)	Imposta il valore della proprietà associata ToolTipService.Placement XAML per l'elemento di destinazione specificato.
SetPlacementTarget(DependencyObject, UIElement)	Imposta il valore della proprietà associata ToolTipService.PlacementTarget XAML per l'elemento di destinazione specificato.
SetToolTip(DependencyObject, Object)	Imposta il valore della proprietà associata ToolTipService.ToolTip XAML.

Si applica a

Condividi tramite