ToolTipService Classe

Référence

Définition

Espace de noms:: Windows.UI.Xaml.Controls

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 à

Partager via