Partager via

ToolTipService Classe

  • Référence

Définition

Espace de noms:
Microsoft.UI.Xaml.Controls
Modifier

Représente un service qui fournit des méthodes statiques pour afficher une info-bulle.

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
Héritage
Object Platform::Object IInspectable ToolTipService
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

L’exemple de code suivant illustre les modes de placement d’une info-bulle.

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

Remarques

Une info-bulle doit être affectée à un autre élément d’interface utilisateur qui est son propriétaire. Dans XAML (Extensible Application Markup Language), utilisez la propriété jointe ToolTipService.ToolTip pour affecter l’info-bulle à un propriétaire. Dans le code, utilisez la méthode ToolTipService.SetToolTip pour affecter l’info-bulle à un propriétaire.

Placement

Par défaut, une info-bulle s’affiche centrée au-dessus du pointeur. L’emplacement n’étant pas limité par la fenêtre de l’application, l’info-bulle peut être affichée partiellement ou complètement en dehors des limites de fenêtre de l’application.

Si une info-bulle masque le contenu auquel elle fait référence, vous pouvez ajuster son emplacement. Utilisez la propriété jointe ToolTipService.Placement pour placer l’info-bulle au-dessus, en dessous, à gauche ou à droite du pointeur.

S’il n’existe pas de PlacementTarget explicite, la cible de placement d’une info-bulle est l’élément qui spécifie une valeur pour sa valeur de propriété jointe TooltipService.ToolTip. Toute valeur de placement (en tant que propriété jointe ou en tant qu’attribut sur un élément ToolTip explicite) s’applique à cette cible.

Propriétés jointes XAML

ToolTipService est la classe de service hôte pour plusieurs propriétés jointes XAML.

Pour prendre en charge l’accès du processeur XAML aux propriétés jointes, ainsi que pour exposer des opérations get et set équivalentes au code, chaque propriété jointe XAML a une paire de méthodes d’accesseur Get et Set. Une autre façon d’obtenir ou de définir la valeur dans le code consiste à utiliser le système de propriétés de dépendance, en appelant GetValue ou SetValue et en passant le champ d’identificateur comme identificateur de propriété de dépendance.

Propriété jointe Description
Placement Obtient ou définit une valeur qui indique comment une info-bulle est positionnée par rapport à la cible de placement.
Placementtarget Obtient ou définit l’objet par rapport auquel une info-bulle est positionnée.
Info-bulle Obtient ou définit le contenu de l’objet ou de la chaîne de l’info-bulle d’un élément.

Propriétés

PlacementProperty

Identifie la propriété jointe XAML ToolTipService.Placement .
PlacementTargetProperty

Identifie la propriété jointe XAML ToolTipService.PlacementTarget .
ToolTipProperty

Identifie la propriété jointe XAML ToolTipService.Tooltip .

Propriétés attachées

Placement

Obtient ou définit une valeur qui indique comment une info-bulle est positionnée par rapport à la cible de placement.
PlacementTarget

Obtient ou définit l’objet par rapport auquel une info-bulle est positionnée.
ToolTip

Obtient ou définit le contenu de l’objet ou de la chaîne de l’info-bulle d’un élément.

Méthodes

GetPlacement(DependencyObject)

Obtient la valeur de la propriété jointe XAML ToolTipService.Placement pour l’élément cible spécifié.
GetPlacementTarget(DependencyObject)

Obtient la valeur de propriété jointe XAML ToolTipService.PlacementTarget pour l’élément cible spécifié.
GetToolTip(DependencyObject)

Obtient la valeur de la propriété jointe XAML ToolTipService.ToolTip pour un objet .
SetPlacement(DependencyObject, PlacementMode)

Définit la valeur de la propriété jointe XAML ToolTipService.Placement pour l’élément cible spécifié.
SetPlacementTarget(DependencyObject, UIElement)

Définit la valeur de la propriété jointe XAML ToolTipService.PlacementTarget pour l’élément cible spécifié.
SetToolTip(DependencyObject, Object)

Définit la valeur de la propriété jointe XAML ToolTipService.ToolTip .

S’applique à

Voir aussi