Partager via


ToolTipService Classe

Définition

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
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 FrameworkContentElement.ToolTip propriété ou FrameworkElement.ToolTip . La propriété ToolTip prend un enfant. Le contenu de l’enfant peut varier d’une chaîne de texte simple à un contenu plus complexe, tel qu’un contenant du texte et Image des StackPanel éléments incorporés.

Vous pouvez définir le contenu de ToolTip l’info-bulle en tant qu’objet, mais cela n’est pas obligatoire. Lorsque vous ne définissez pas le contenu de l’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 un grand nombre des propriétés utilisées pour personnaliser une info-bulle. Si les propriétés équivalentes ToolTip et ToolTipService 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 ToolTipOpeningEvent champs et ToolTipClosingEvent .

Placement, PlacementRectangle, PlacementTarget, HorizontalOffsetet 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 positionnement de Popup.

Champs

BetweenShowDelayProperty

Identifie la propriété jointe BetweenShowDelay.

HasDropShadowProperty

Identifie la propriété jointe HasDropShadow.

HorizontalOffsetProperty

Identifie la propriété jointe HorizontalOffset.

InitialShowDelayProperty

Identifie la propriété jointe InitialShowDelay.

IsEnabledProperty

Identifie la propriété jointe IsEnabled.

IsOpenProperty

Identifie la propriété jointe IsOpen.

PlacementProperty

Identifie la propriété jointe Placement.

PlacementRectangleProperty

Identifie la propriété jointe PlacementRectangle.

PlacementTargetProperty

Identifie la propriété jointe PlacementTarget.

ShowDurationProperty

Identifie la propriété jointe ShowDuration.

ShowOnDisabledProperty

Identifie la propriété jointe ShowOnDisabled.

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 service ToolTipService pour afficher des info-bulles.

ToolTipOpeningEvent

Identifie l'événement ToolTipOpening exposé par les objets qui utilisent le service ToolTipService pour afficher des info-bulles.

ToolTipProperty

Identifie la propriété jointe ToolTip.

VerticalOffsetProperty

Identifie la propriété jointe VerticalOffset.

Propriétés attachées

BetweenShowDelay

Obtient ou définit la durée maximale entre l’affichage de deux info-bulles, quand la deuxième info-bulle s’affiche sans délai.

HasDropShadow

Obtient ou définit le fait que l'info-bulle s'affiche avec un effet d'ombre portée.

HorizontalOffset

Obtient ou définit le décalage à partir de la gauche de la zone spécifiée pour l’info-bulle par les propriétés PlacementRectangle et PlacementTarget.

InitialShowDelay

Obtient ou définit la durée avant l’ouverture d’une info-bulle.

IsEnabled

Obtient ou définit le fait qu'une info-bulle s'affiche.

IsOpen

Détermine si une info-bulle est actuellement visible.

Placement

Obtient ou définit l’orientation de l’info-bulle quand elle s’ouvre, et spécifie le comportement de l’info-bulle quand elle dépasse 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 en partant du haut de la zone qui est spécifiée pour l’info-bulle par les propriétés PlacementRectangle et PlacementTarget.

Méthodes

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Ajoute un gestionnaire pour l'événement attaché ToolTipClosing.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Ajoute un gestionnaire pour l'événement attaché ToolTipOpening.

GetBetweenShowDelay(DependencyObject)

Obtient la valeur de la propriété jointe BetweenShowDelay pour un objet.

GetHasDropShadow(DependencyObject)

Obtient la valeur de la propriété jointe HasDropShadow pour un objet.

GetHorizontalOffset(DependencyObject)

Obtient la valeur de la propriété jointe HorizontalOffset pour un objet.

GetInitialShowDelay(DependencyObject)

Obtient la valeur de la propriété jointe InitialShowDelay pour un objet.

GetIsEnabled(DependencyObject)

Obtient la valeur de la propriété jointe IsEnabled pour un objet.

GetIsOpen(DependencyObject)

Obtient la valeur de la propriété jointe IsOpen pour un objet.

GetPlacement(DependencyObject)

Obtient la valeur de la propriété jointe Placement pour un objet.

GetPlacementRectangle(DependencyObject)

Obtient la valeur de la propriété jointe PlacementRectangle pour un objet.

GetPlacementTarget(DependencyObject)

Obtient la valeur de la propriété jointe PlacementTarget pour un objet.

GetShowDuration(DependencyObject)

Obtient la valeur de la propriété jointe ShowDuration pour un objet.

GetShowOnDisabled(DependencyObject)

Obtient la valeur de la propriété jointe ShowOnDisabled 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 propriété jointe ToolTip pour un objet.

GetVerticalOffset(DependencyObject)

Obtient la valeur de la propriété jointe VerticalOffset pour un objet.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Supprime un gestionnaire pour l'événement attaché ToolTipClosing.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Supprime un gestionnaire pour l'événement attaché ToolTipOpening.

SetBetweenShowDelay(DependencyObject, Int32)

Définit la valeur de la propriété jointe BetweenShowDelay pour un objet.

SetHasDropShadow(DependencyObject, Boolean)

Définit la valeur de la propriété jointe HasDropShadow pour un objet.

SetHorizontalOffset(DependencyObject, Double)

Définit la valeur de la propriété jointe HorizontalOffset pour un objet.

SetInitialShowDelay(DependencyObject, Int32)

Définit la valeur de la propriété jointe InitialShowDelay pour un objet.

SetIsEnabled(DependencyObject, Boolean)

Définit la valeur de la propriété jointe IsEnabled pour un objet.

SetPlacement(DependencyObject, PlacementMode)

Définit la valeur de la propriété jointe Placement pour un objet.

SetPlacementRectangle(DependencyObject, Rect)

Définit la valeur de la propriété jointe PlacementRectangle pour un objet.

SetPlacementTarget(DependencyObject, UIElement)

Définit la valeur de la propriété jointe PlacementTarget pour un objet.

SetShowDuration(DependencyObject, Int32)

Définit la valeur de la propriété jointe ShowDuration pour un objet.

SetShowOnDisabled(DependencyObject, Boolean)

Définit la valeur de la propriété jointe ShowOnDisabled 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 propriété jointe ToolTip pour un objet.

SetVerticalOffset(DependencyObject, Double)

Définit la valeur de la propriété jointe VerticalOffset pour un objet.

Événements attachés

ToolTipClosing

Se produit lorsque ToolTip se ferme.

ToolTipOpening

Se produit lors de l'ouverture de ToolTip.

S’applique à

Voir aussi