ToolTipService Classe

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.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(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

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 XAML (Extensible Application Markup Language) usa 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 centro sopra il 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 nasconde il contenuto a cui fa riferimento, è possibile modificarlo. Usare la proprietà associata ToolTipService.Placement per posizionare la descrizione comando sopra, sotto, sinistra o destra del puntatore.

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

Proprietà associate XAML

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

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

Proprietà associata Descrizione
Selezione host Ottiene o imposta un valore che indica la posizione di una descrizione comando rispetto alla destinazione di posizionamento.
Placementtarget Ottiene o imposta l'oggetto relativo al quale è posizionata una descrizione comando.
ToolTip Ottiene o imposta il contenuto dell'oggetto o della stringa della descrizione comando di un elemento.

Proprietà

PlacementProperty

Identifica la proprietà associata XAML ToolTipService.Placement .
PlacementTargetProperty

Identifica la proprietà associata XAML ToolTipService.PlacementTarget .
ToolTipProperty

Identifica la proprietà associata XAML ToolTipService.Tooltip .

Proprietà associate

Placement

Ottiene o imposta un valore che indica la posizione di una descrizione comando rispetto alla destinazione di posizionamento.
PlacementTarget

Ottiene o imposta l'oggetto relativo al quale è 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 XAML ToolTipService.Placement 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 XAML ToolTipService.ToolTip per un oggetto.
SetPlacement(DependencyObject, PlacementMode)

Imposta il valore della proprietà associata XAML ToolTipService.Placement per l'elemento di destinazione specificato.
SetPlacementTarget(DependencyObject, UIElement)

Imposta il valore della proprietà associata XAML ToolTipService.PlacementTarget per l'elemento di destinazione specificato.
SetToolTip(DependencyObject, Object)

Imposta il valore della proprietà associata XAML ToolTipService.ToolTip .

Si applica a

Vedi anche