ToolTipService Classe

Définition

Espace de noms:: System.Windows.Controls

Assembly:: PresentationFramework.dll

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.

Représente un service qui fournit des propriétés et des événements pour contrôler l’affichage et le comportement des info-bulles.

public ref class ToolTipService abstract sealed

public static class ToolTipService

type ToolTipService = class

Public Class ToolTipService

Héritage: Object
ToolTipService

Exemples

L’exemple suivant montre comment utiliser la ToolTipService classe pour spécifier le comportement d’une info-bulle. Vous définissez les propriétés de la ToolTipService classe en les attachant directement à l’élément qui expose l’info-bulle.

<Ellipse Height="25" Width="50" 
      Fill="Gray" 
      HorizontalAlignment="Left"
      ToolTipService.InitialShowDelay="1000"
      ToolTipService.ShowDuration="7000"
      ToolTipService.BetweenShowDelay="2000"
      ToolTipService.Placement="Right" 
      ToolTipService.PlacementRectangle="50,0,0,0"
      ToolTipService.HorizontalOffset="10" 
      ToolTipService.VerticalOffset="20"
      ToolTipService.HasDropShadow="false"
      ToolTipService.ShowOnDisabled="true" 
      ToolTipService.IsEnabled="true"
      ToolTipOpening="whenToolTipOpens"
      ToolTipClosing="whenToolTipCloses"
      >
  <Ellipse.ToolTip>
    <BulletDecorator>
      <BulletDecorator.Bullet>
        <Ellipse Height="10" Width="20" Fill="Blue"/>
      </BulletDecorator.Bullet>
      <TextBlock>Uses the ToolTipService class</TextBlock>
    </BulletDecorator>
  </Ellipse.ToolTip>
</Ellipse>

Remarques

Vous définissez une info-bulle pour un élément en définissant la ou FrameworkElement.ToolTip la FrameworkContentElement.ToolTip propriété. La propriété Info-bulle prend un enfant. Le contenu de l’enfant peut varier d’une chaîne de texte simple à un contenu plus complexe tel qu’un StackPanel texte incorporé et Image des éléments.

Vous pouvez définir le contenu d’info-bulle en tant qu’objet ToolTip , mais cela n’est pas obligatoire. Lorsque vous ne définissez pas le contenu d’info-bulle en tant qu’objet ToolTip , vous pouvez utiliser les ToolTipService propriétés pour positionner et personnaliser le contenu de l’info-bulle. Les propriétés jointes de la ToolTipService classe sont utilisées pour déterminer l’emplacement, le comportement et l’apparence d’une info-bulle. Ces propriétés sont définies sur l’élément qui définit l’info-bulle.

La ToolTip classe et la ToolTipService classe partagent de nombreuses propriétés utilisées pour personnaliser une info-bulle. Si les propriétés équivalentes ToolTip et ToolTipService les propriétés sont définies, la ToolTipService propriété est prioritaire. Par exemple, si la ToolTip.Placement propriété et la ToolTipService.Placement propriété sont définies pour un System.Windows.Controls.ToolTip objet, la valeur de la ToolTipService.Placement propriété est utilisée.

Les propriétés de minutage suivantes ToolTipService sont définies uniquement pour la ToolTipService classe et sont utilisées par toutes les info-bulles :

Pour plus d’informations sur la gestion des événements qui se produisent lorsque l’info-bulle s’ouvre ou se ferme, consultez les champs et ToolTipClosingEvent les ToolTipOpeningEvent champs.

Placement, , PlacementRectangle PlacementTarget, HorizontalOffset, et VerticalOffset se comportent de la même façon que les propriétés du même nom dans la Popup classe. Pour plus d’informations, consultez Comportement de placement de fenêtre contextuelle.

Champs

Nom	Description
BetweenShowDelayProperty	Identifie la BetweenShowDelay propriété jointe.
HasDropShadowProperty	Identifie la HasDropShadow propriété jointe.
HorizontalOffsetProperty	Identifie la HorizontalOffset propriété jointe.
InitialShowDelayProperty	Identifie la InitialShowDelay propriété jointe.
IsEnabledProperty	Identifie la IsEnabled propriété jointe.
IsOpenProperty	Identifie la IsOpen propriété jointe.
PlacementProperty	Identifie la Placement propriété jointe.
PlacementRectangleProperty	Identifie la PlacementRectangle propriété jointe.
PlacementTargetProperty	Identifie la PlacementTarget propriété jointe.
ShowDurationProperty	Identifie la ShowDuration propriété jointe.
ShowOnDisabledProperty	Identifie la ShowOnDisabled propriété jointe.
ShowsToolTipOnKeyboardFocusProperty	Représente un service qui fournit des propriétés et des événements pour contrôler l’affichage et le comportement des info-bulles.
ToolTipClosingEvent	Identifie l’événement ToolTipClosing exposé par les objets qui utilisent le ToolTipService service pour afficher les info-bulles.
ToolTipOpeningEvent	Identifie l’événement ToolTipOpening exposé par les objets qui utilisent le ToolTipService service pour afficher les info-bulles.
ToolTipProperty	Identifie la ToolTip propriété jointe.
VerticalOffsetProperty	Identifie la VerticalOffset propriété jointe.

Propriétés attachées

Nom	Description
BetweenShowDelay	Obtient ou définit la durée maximale entre l’affichage de deux info-bulles où la deuxième info-bulle s’affiche sans délai.
HasDropShadow	Obtient ou définit si l’info-bulle affiche un effet d’ombre déroulante.
HorizontalOffset	Obtient ou définit le décalage de la gauche de la zone spécifiée pour l’info-bulle par les propriétés et PlacementTarget les PlacementRectangle propriétés.
InitialShowDelay	Obtient ou définit la durée avant l’ouverture d’une info-bulle.
IsEnabled	Obtient ou définit si une info-bulle apparaît.
IsOpen	Obtient si une info-bulle est actuellement visible.
Placement	Obtient ou définit l’orientation de l’info-bulle lorsqu’elle s’ouvre et spécifie le comportement de l’info-bulle lorsqu’elle chevauche les limites de l’écran.
PlacementRectangle	Obtient ou définit la zone rectangulaire par rapport à laquelle l’info-bulle est positionnée.
PlacementTarget	Obtient ou définit l’objet par rapport auquel l’info-bulle est positionnée.
ShowDuration	Obtient ou définit la durée pendant laquelle une info-bulle reste visible.
ShowOnDisabled	Obtient ou définit si une info-bulle s’affiche pour un objet qui n’est pas activé.
ShowsToolTipOnKeyboardFocus	Représente un service qui fournit des propriétés et des événements pour contrôler l’affichage et le comportement des info-bulles.
ToolTip	Obtient ou définit le contenu d’une info-bulle.
VerticalOffset	Obtient ou définit la distance entre le haut de la zone spécifiée pour l’info-bulle par les propriétés et PlacementTarget les PlacementRectangle propriétés.

Méthodes

Nom	Description
AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)	Ajoute un gestionnaire pour l’événement ToolTipClosing attaché.
AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)	Ajoute un gestionnaire pour l’événement ToolTipOpening attaché.
GetBetweenShowDelay(DependencyObject)	Obtient la valeur de la BetweenShowDelay propriété jointe pour un objet.
GetHasDropShadow(DependencyObject)	Obtient la valeur de la HasDropShadow propriété jointe pour un objet.
GetHorizontalOffset(DependencyObject)	Obtient la valeur de la HorizontalOffset propriété jointe pour un objet.
GetInitialShowDelay(DependencyObject)	Obtient la valeur de la InitialShowDelay propriété jointe pour un objet.
GetIsEnabled(DependencyObject)	Obtient la valeur de la IsEnabled propriété jointe pour un objet.
GetIsOpen(DependencyObject)	Obtient la valeur de la IsOpen propriété jointe pour un objet.
GetPlacement(DependencyObject)	Obtient la valeur de la Placement propriété jointe pour un objet.
GetPlacementRectangle(DependencyObject)	Obtient la valeur de la PlacementRectangle propriété jointe pour un objet.
GetPlacementTarget(DependencyObject)	Obtient la valeur de la PlacementTarget propriété jointe pour un objet.
GetShowDuration(DependencyObject)	Obtient la valeur de la ShowDuration propriété jointe pour un objet.
GetShowOnDisabled(DependencyObject)	Obtient la valeur de la ShowOnDisabled propriété jointe pour un objet.
GetShowsToolTipOnKeyboardFocus(DependencyObject)	Représente un service qui fournit des propriétés et des événements pour contrôler l’affichage et le comportement des info-bulles.
GetToolTip(DependencyObject)	Obtient la valeur de la ToolTip propriété jointe pour un objet.
GetVerticalOffset(DependencyObject)	Obtient la valeur de la VerticalOffset propriété jointe pour un objet.
RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)	Supprime un gestionnaire pour l’événement ToolTipClosing attaché.
RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)	Supprime un gestionnaire pour l’événement ToolTipOpening attaché.
SetBetweenShowDelay(DependencyObject, Int32)	Définit la valeur de la BetweenShowDelay propriété jointe pour un objet.
SetHasDropShadow(DependencyObject, Boolean)	Définit la valeur de la HasDropShadow propriété jointe pour un objet.
SetHorizontalOffset(DependencyObject, Double)	Définit la valeur de la HorizontalOffset propriété jointe pour un objet.
SetInitialShowDelay(DependencyObject, Int32)	Définit la valeur de la InitialShowDelay propriété jointe pour un objet.
SetIsEnabled(DependencyObject, Boolean)	Définit la valeur de la IsEnabled propriété jointe pour un objet.
SetPlacement(DependencyObject, PlacementMode)	Définit la valeur de la Placement propriété jointe pour un objet.
SetPlacementRectangle(DependencyObject, Rect)	Définit la valeur de la PlacementRectangle propriété jointe pour un objet.
SetPlacementTarget(DependencyObject, UIElement)	Définit la valeur de la PlacementTarget propriété jointe pour un objet.
SetShowDuration(DependencyObject, Int32)	Définit la valeur de la ShowDuration propriété jointe pour un objet.
SetShowOnDisabled(DependencyObject, Boolean)	Définit la valeur de la ShowOnDisabled propriété jointe pour un objet.
SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>)	Représente un service qui fournit des propriétés et des événements pour contrôler l’affichage et le comportement des info-bulles.
SetToolTip(DependencyObject, Object)	Définit la valeur de la ToolTip propriété jointe pour un objet.
SetVerticalOffset(DependencyObject, Double)	Définit la valeur de la VerticalOffset propriété jointe pour un objet.

Événements attachés

Nom	Description
ToolTipClosing	Se produit lorsque la ToolTip fermeture est terminée.
ToolTipOpening	Se produit lors de l’ouverture ToolTip .

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?