Share via

ToolTipService Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Xaml.Controls
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

Vedi anche