ToolTipService Classe

  • Référence

Définition

Espace de noms:
Windows.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(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
Héritage
Object Platform::Object IInspectable ToolTipService
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

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 d’application, l’info-bulle peut être affichée partiellement ou entièrement en dehors des limites de la fenêtre d’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 Placement (en tant que propriété jointe ou en tant qu’attribut sur un élément ToolTip explicite) s’applique à cette cible.

Remarques pour les versions précédentes

L’info-bulleWindows 8.x est destinée uniquement à être utilisée dans Windows. Le type d’info-bulle est disponible dans Windows Phone projets à des fins de compatibilité avec les modèles de projet universels, mais l’info-bulle n’est pas affichée dans l’interface utilisateur Windows Phone.

L’info-bulle s’affiche uniquement dans les limites de la fenêtre de l’application. Son emplacement peut être ajusté pour rester dans ces limites.

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 possède 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 identificateur comme identificateur de propriété de dépendance.

Propriété jointe Description
Placement Obtient ou définit une valeur qui indique la position d’un ToolTip par rapport à la cible de placement.
Placementtarget Obtient ou définit l’objet par rapport auquel un ToolTip est positionné.
ToolTip Obtient ou définit le contenu de l’objet ou de la chaîne d’un ToolTipé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 à lequel 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 la 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