ToolTipService Classe

Référence

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

Partager via