ToolTipService ToolTipService ToolTipService ToolTipService Class

Definition

Stellt einen Dienst dar, der Eigenschaften und Ereignisse für das Steuern der Anzeige und des Verhaltens von QuickInfos bereitstellt.Represents a service that provides properties and events to control the display and behavior of tooltips.

public ref class ToolTipService abstract sealed
public static class ToolTipService
type ToolTipService = class
Public Class ToolTipService
Vererbung
ToolTipServiceToolTipServiceToolTipServiceToolTipService

Beispiele

Im folgenden Beispiel wird gezeigt, wie die ToolTipService -Klasse verwendet, um das Verhalten einer QuickInfo anzugeben.The following example shows how the use the ToolTipService class to specify the behavior of a tooltip. Sie legen die Eigenschaften der ToolTipService Klasse fest, indem Sie Sie direkt an das Element anfügen, das die QuickInfo verfügbar macht.You set the properties of the ToolTipService class by attaching them directly to the element that exposes the tooltip.

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

Hinweise

Sie definieren eine QuickInfo für ein Element durch Festlegen FrameworkContentElement.ToolTip der FrameworkElement.ToolTip -Eigenschaft oder der-Eigenschaft.You define a tooltip for an element by setting the FrameworkContentElement.ToolTip or FrameworkElement.ToolTip property. Die ToolTip-Eigenschaft nimmt ein untergeordnetes Element an.The ToolTip property takes one child. Der Inhalt des untergeordneten Elements kann von einer einfachen Text Zeichenfolge bis hin zu komplexeren Inhalten StackPanel variieren, z. b Image . mit eingebetteten Text und Elementen.The content of the child can vary from a simple text string to more complex content such as a StackPanel that has embedded text and Image elements.

Sie können QuickInfo-Inhalte als ToolTip -Objekt definieren, dies ist jedoch nicht erforderlich.You can define tooltip content as a ToolTip object, but this is not required. Wenn Sie den QuickInfo-Inhalt nicht als ToolTip -Objekt definieren, können Sie die ToolTipService Eigenschaften zum Positionieren und Anpassen des QuickInfo-Inhalts verwenden.When you do not define the tooltip content as a ToolTip object, you can use the ToolTipService properties to position and customize the tooltip content. Angefügte Eigenschaften der ToolTipService -Klasse werden verwendet, um die Platzierung, das Verhalten und die Darstellung einer QuickInfo zu bestimmen.Attached properties of the ToolTipService class are used to determine the placement, behavior, and appearance of a tooltip. Diese Eigenschaften werden auf dem Element festgelegt, das die QuickInfo definiert.These properties are set on the element that defines the tooltip.

Die ToolTip -Klasse und ToolTipService die-Klasse verfügen über viele der Eigenschaften, die zum Anpassen einer QuickInfo verwendet werden.The ToolTip class and the ToolTipService class share many of the same properties that are used to customize a tooltip. Wenn äquivalente ToolTip -und-Eigenschaften festgelegt ToolTipService sind, hat die- ToolTipService Eigenschaft Vorrang.If equivalent ToolTip and ToolTipService properties are both set, the ToolTipService property takes precedence. Wenn z. b. sowohl ToolTip.Placement die-Eigenschaft ToolTipService.Placement als auch die-Eigenschaft System.Windows.Controls.ToolTip für ein-Objekt festgelegt ToolTipService.Placement sind, wird der Wert der-Eigenschaft verwendet.For example, if both the ToolTip.Placement property and the ToolTipService.Placement property are set for a System.Windows.Controls.ToolTip object, the value of the ToolTipService.Placement property is used.

Die folgenden ToolTipService Zeit Steuerungseigenschaften sind nur für die ToolTipService -Klasse definiert und werden von allen Quick Infos verwendet:The following ToolTipService timing properties are only defined for the ToolTipService class and are used by all tooltips:

Informationen zum Behandeln von Ereignissen, die auftreten, wenn die QuickInfo geöffnet oder geschlossen wird, finden ToolTipOpeningEvent Sie ToolTipClosingEvent in den Feldern und.For information about how to handle the events that occur when the tooltip opens or closes, see the ToolTipOpeningEvent and ToolTipClosingEvent fields.

Placement, PlacementRectangle, PlacementTarget, VerticalOffset Popup und Verhalten sich ähnlich wie die Eigenschaften desselben Namens in der-Klasse. HorizontalOffsetPlacement, PlacementRectangle, PlacementTarget, HorizontalOffset, and VerticalOffset behave similarly to the properties of the same name in the Popup class. Weitere Informationen finden Sie unter Verhalten beim Platzieren von Popups.For more information, see Popup Placement Behavior.

Felder

BetweenShowDelayProperty BetweenShowDelayProperty BetweenShowDelayProperty BetweenShowDelayProperty

Bezeichnet die angefügte BetweenShowDelay-Eigenschaft.Identifies the BetweenShowDelay attached property.

HasDropShadowProperty HasDropShadowProperty HasDropShadowProperty HasDropShadowProperty

Bezeichnet die angefügte HasDropShadow-Eigenschaft.Identifies the HasDropShadow attached property.

HorizontalOffsetProperty HorizontalOffsetProperty HorizontalOffsetProperty HorizontalOffsetProperty

Bezeichnet die angefügte HorizontalOffset-Eigenschaft.Identifies the HorizontalOffset attached property.

InitialShowDelayProperty InitialShowDelayProperty InitialShowDelayProperty InitialShowDelayProperty

Bezeichnet die angefügte InitialShowDelay-Eigenschaft.Identifies the InitialShowDelay attached property.

IsEnabledProperty IsEnabledProperty IsEnabledProperty IsEnabledProperty

Bezeichnet die angefügte IsEnabled-Eigenschaft.Identifies the IsEnabled attached property.

IsOpenProperty IsOpenProperty IsOpenProperty IsOpenProperty

Bezeichnet die angefügte IsOpen-Eigenschaft.Identifies the IsOpen attached property.

PlacementProperty PlacementProperty PlacementProperty PlacementProperty

Bezeichnet die angefügte Placement-Eigenschaft.Identifies the Placement attached property.

PlacementRectangleProperty PlacementRectangleProperty PlacementRectangleProperty PlacementRectangleProperty

Bezeichnet die angefügte PlacementRectangle-Eigenschaft.Identifies the PlacementRectangle attached property.

PlacementTargetProperty PlacementTargetProperty PlacementTargetProperty PlacementTargetProperty

Bezeichnet die angefügte PlacementTarget-Eigenschaft.Identifies the PlacementTarget attached property.

ShowDurationProperty ShowDurationProperty ShowDurationProperty ShowDurationProperty

Bezeichnet die angefügte ShowDuration-Eigenschaft.Identifies the ShowDuration attached property.

ShowOnDisabledProperty ShowOnDisabledProperty ShowOnDisabledProperty ShowOnDisabledProperty

Bezeichnet die angefügte ShowOnDisabled-Eigenschaft.Identifies the ShowOnDisabled attached property.

ToolTipClosingEvent ToolTipClosingEvent ToolTipClosingEvent ToolTipClosingEvent

Bezeichnet das ToolTipClosing-Ereignis, das von Objekten verfügbar gemacht wird, die den ToolTipService-Dienst verwenden, um QuickInfos anzuzeigen.Identifies the ToolTipClosing event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipOpeningEvent ToolTipOpeningEvent ToolTipOpeningEvent ToolTipOpeningEvent

Bezeichnet das ToolTipOpening-Ereignis, das von Objekten verfügbar gemacht wird, die den ToolTipService-Dienst verwenden, um QuickInfos anzuzeigen.Identifies the ToolTipOpening event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipProperty ToolTipProperty ToolTipProperty ToolTipProperty

Bezeichnet die angefügte ToolTip-Eigenschaft.Identifies the ToolTip attached property.

VerticalOffsetProperty VerticalOffsetProperty VerticalOffsetProperty VerticalOffsetProperty

Bezeichnet die angefügte VerticalOffset-Eigenschaft.Identifies the VerticalOffset attached property.

Angefügte Eigenschaften

BetweenShowDelay BetweenShowDelay BetweenShowDelay BetweenShowDelay

Ruft die Höchstdauer zwischen dem Anzeigen von zwei QuickInfos ab oder legt diese fest. Dabei wird die zweite QuickInfo ohne Verzögerung angezeigt.Gets or sets the maximum time between the display of two tooltips where the second tooltip appears without a delay.

HasDropShadow HasDropShadow HasDropShadow HasDropShadow

Ruft ab oder legt fest, ob die QuickInfo einen Schlagschatteneffekt anzeigt.Gets or sets whether the tooltip displays a drop shadow effect.

HorizontalOffset HorizontalOffset HorizontalOffset HorizontalOffset

Ruft den Offset vom linken Rand des Bereichs ab, der durch die PlacementRectangle-Eigenschaft und die PlacementTarget-Eigenschaft für die QuickInfo definiert wird, oder legt diesen Offset fest.Gets or sets the offset from the left of the area that is specified for the tooltip by the PlacementRectangle and PlacementTarget properties.

InitialShowDelay InitialShowDelay InitialShowDelay InitialShowDelay

Ruft die Zeit ab, bevor eine QuickInfo geöffnet wird, oder legt diese fest.Gets or sets the length of time before a tooltip opens.

IsEnabled IsEnabled IsEnabled IsEnabled

Ruft ab oder legt fest, ob eine QuickInfo angezeigt wird.Gets or sets whether a tooltip appears.

IsOpen IsOpen IsOpen IsOpen

Ruft ab, ob derzeit eine QuickInfo angezeigt wird.Gets whether a tooltip is currently visible.

Placement Placement Placement Placement

Ruft die Ausrichtung einer QuickInfo beim Öffnen ab oder legt diese fest und gibt das Verhalten der QuickInfo an, wenn diese die Grenzen des Bildschirms überschreitet.Gets or sets the orientation of the tooltip when it opens, and specifies how the tooltip behaves when it overlaps screen boundaries.

PlacementRectangle PlacementRectangle PlacementRectangle PlacementRectangle

Ruft den rechteckigen Bereich ab, relativ zu dem die QuickInfo platziert wird, oder legt diesen fest.Gets or sets the rectangular area relative to which the tooltip is positioned.

PlacementTarget PlacementTarget PlacementTarget PlacementTarget

Ruft das Objekt ab, relativ zu dem die QuickInfo platziert wird, oder legt dieses fest.Gets or sets the object relative to which the tooltip is positioned.

ShowDuration ShowDuration ShowDuration ShowDuration

Ruft die Zeitspanne ab, die eine QuickInfo angezeigt wird, oder legt diese fest.Gets or sets the amount of time that a tooltip remains visible.

ShowOnDisabled ShowOnDisabled ShowOnDisabled ShowOnDisabled

Ruft ab oder legt fest, ob eine QuickInfo für ein Objekt angezeigt wird, das nicht aktiviert ist.Gets or sets whether a tooltip appears for an object that is not enabled.

ToolTip ToolTip ToolTip ToolTip

Ruft den Inhalt einer QuickInfo ab oder legt diesen fest.Gets or sets the content of a tooltip.

VerticalOffset VerticalOffset VerticalOffset VerticalOffset

Ruft den Abstand vom oberen Rand des Bereichs ab, der durch die PlacementRectangle-Eigenschaft und die PlacementTarget-Eigenschaft für die QuickInfo definiert wird, oder legt diesen Offset fest.Gets or sets the distance from the top of the area that is specified for the tooltip by the PlacementRectangle and PlacementTarget properties.

Methoden

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Fügt einen Handler für das angefügte ToolTipClosing -Ereignis hinzu.Adds a handler for the ToolTipClosing attached event.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Fügt einen Handler für das angefügte ToolTipOpening-Ereignis hinzu.Adds a handler for the ToolTipOpening attached event.

GetBetweenShowDelay(DependencyObject) GetBetweenShowDelay(DependencyObject) GetBetweenShowDelay(DependencyObject) GetBetweenShowDelay(DependencyObject)

Ruft den Wert der angefügten Eigenschaft BetweenShowDelay für ein Objekt ab.Gets the value of the BetweenShowDelay attached property for an object.

GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject)

Ruft den Wert der angefügten Eigenschaft HasDropShadow für ein Objekt ab.Gets the value of the HasDropShadow attached property for an object.

GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject)

Ruft den Wert der angefügten Eigenschaft HorizontalOffset für ein Objekt ab.Gets the value of the HorizontalOffset attached property for an object.

GetInitialShowDelay(DependencyObject) GetInitialShowDelay(DependencyObject) GetInitialShowDelay(DependencyObject) GetInitialShowDelay(DependencyObject)

Ruft den Wert der angefügten Eigenschaft InitialShowDelay für ein Objekt ab.Gets the value of the InitialShowDelay attached property for an object.

GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject)

Ruft den Wert der angefügten Eigenschaft IsEnabled für ein Objekt ab.Gets the value of the IsEnabled attached property for an object.

GetIsOpen(DependencyObject) GetIsOpen(DependencyObject) GetIsOpen(DependencyObject) GetIsOpen(DependencyObject)

Ruft den Wert der angefügten Eigenschaft IsOpen für ein Objekt ab.Gets the value of the IsOpen attached property for an object.

GetPlacement(DependencyObject) GetPlacement(DependencyObject) GetPlacement(DependencyObject) GetPlacement(DependencyObject)

Ruft den Wert der angefügten Eigenschaft Placement für ein Objekt ab.Gets the value of the Placement attached property for an object.

GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject)

Ruft den Wert der angefügten Eigenschaft PlacementRectangle für ein Objekt ab.Gets the value of the PlacementRectangle attached property for an object.

GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject)

Ruft den Wert der angefügten Eigenschaft PlacementTarget für ein Objekt ab.Gets the value of the PlacementTarget attached property for an object.

GetShowDuration(DependencyObject) GetShowDuration(DependencyObject) GetShowDuration(DependencyObject) GetShowDuration(DependencyObject)

Ruft den Wert der angefügten Eigenschaft ShowDuration für ein Objekt ab.Gets the value of the ShowDuration attached property for an object.

GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject)

Ruft den Wert der angefügten Eigenschaft ShowOnDisabled für ein Objekt ab.Gets the value of the ShowOnDisabled attached property for an object.

GetToolTip(DependencyObject) GetToolTip(DependencyObject) GetToolTip(DependencyObject) GetToolTip(DependencyObject)

Ruft den Wert der angefügten Eigenschaft ToolTip für ein Objekt ab.Gets the value of the ToolTip attached property for an object.

GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject)

Ruft den Wert der angefügten Eigenschaft VerticalOffset für ein Objekt ab.Gets the value of the VerticalOffset attached property for an object.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Entfernt einen Handler für das angefügte ToolTipClosing-Ereignis.Removes a handler for the ToolTipClosing attached event.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Entfernt einen Handler für das angefügte ToolTipOpening-Ereignis.Removes a handler for the ToolTipOpening attached event.

SetBetweenShowDelay(DependencyObject, Int32) SetBetweenShowDelay(DependencyObject, Int32) SetBetweenShowDelay(DependencyObject, Int32) SetBetweenShowDelay(DependencyObject, Int32)

Legt den Wert der angefügten Eigenschaft BetweenShowDelay für ein Objekt fest.Sets the value of the BetweenShowDelay attached property for an object.

SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean)

Legt den Wert der angefügten Eigenschaft HasDropShadow für ein Objekt fest.Sets the value of the HasDropShadow attached property for an object.

SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double)

Legt den Wert der angefügten Eigenschaft HorizontalOffset für ein Objekt fest.Sets the value of the HorizontalOffset attached property for an object.

SetInitialShowDelay(DependencyObject, Int32) SetInitialShowDelay(DependencyObject, Int32) SetInitialShowDelay(DependencyObject, Int32) SetInitialShowDelay(DependencyObject, Int32)

Legt den Wert der angefügten Eigenschaft InitialShowDelay für ein Objekt fest.Sets the value of the InitialShowDelay attached property for an object.

SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean)

Legt den Wert der angefügten Eigenschaft IsEnabled für ein Objekt fest.Sets the value of the IsEnabled attached property for an object.

SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode)

Legt den Wert der angefügten Eigenschaft Placement für ein Objekt fest.Sets the value of the Placement attached property for an object.

SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect)

Legt den Wert der angefügten Eigenschaft PlacementRectangle für ein Objekt fest.Sets the value of the PlacementRectangle attached property for an object.

SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement)

Legt den Wert der angefügten Eigenschaft PlacementTarget für ein Objekt fest.Sets the value of the PlacementTarget attached property for an object.

SetShowDuration(DependencyObject, Int32) SetShowDuration(DependencyObject, Int32) SetShowDuration(DependencyObject, Int32) SetShowDuration(DependencyObject, Int32)

Legt den Wert der angefügten Eigenschaft ShowDuration für ein Objekt fest.Sets the value of the ShowDuration attached property for an object.

SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean)

Legt den Wert der angefügten Eigenschaft ShowOnDisabled für ein Objekt fest.Sets the value of the ShowOnDisabled attached property for an object.

SetToolTip(DependencyObject, Object) SetToolTip(DependencyObject, Object) SetToolTip(DependencyObject, Object) SetToolTip(DependencyObject, Object)

Legt den Wert der angefügten Eigenschaft ToolTip für ein Objekt fest.Sets the value of the ToolTip attached property for an object.

SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double)

Legt den Wert der angefügten Eigenschaft VerticalOffset für ein Objekt fest.Sets the value of the VerticalOffset attached property for an object.

Angefügte Ereignisse

ToolTipClosing ToolTipClosing ToolTipClosing ToolTipClosing

Tritt ein, wenn ToolTip geschlossen wird.Occurs when the ToolTip closes.

ToolTipOpening ToolTipOpening ToolTipOpening ToolTipOpening

Tritt ein, wenn ToolTip geöffnet wird.Occurs when the ToolTip opens.

Gilt für:

Siehe auch