Freigeben über


ToolTipService Klasse

Definition

Stellt einen Dienst dar, der Eigenschaften und Ereignisse zum Steuern der Anzeige und des Verhaltens von QuickInfos bereitstellt.

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

Beispiele

Das folgende Beispiel zeigt, wie die - ToolTipService Klasse verwendet wird, um das Verhalten einer QuickInfo anzugeben. Sie legen die Eigenschaften der ToolTipService -Klasse fest, indem Sie sie direkt an das Element anfügen, das die QuickInfo verfügbar macht.

<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, indem Sie die - oder FrameworkElement.ToolTip -FrameworkContentElement.ToolTipEigenschaft festlegen. Die QuickInfo-Eigenschaft nimmt ein untergeordnetes Element an. Der Inhalt des untergeordneten Elements kann von einer einfachen Textzeichenfolge bis hin zu komplexeren Inhalten variieren, z. B. mit eingebettetem StackPanel Text und Image Elementen.

Sie können QuickInfo-Inhalte als ToolTip Objekt definieren, aber dies ist nicht erforderlich. Wenn Sie den QuickInfo-Inhalt nicht als ToolTip Objekt definieren, können Sie die ToolTipService Eigenschaften verwenden, um den QuickInfo-Inhalt zu positionieren und anzupassen. Angefügte Eigenschaften der ToolTipService -Klasse werden verwendet, um die Platzierung, das Verhalten und die Darstellung einer QuickInfo zu bestimmen. Diese Eigenschaften werden für das Element festgelegt, das die QuickInfo definiert.

Die ToolTip -Klasse und die ToolTipService -Klasse verwenden viele der gleichen Eigenschaften, die zum Anpassen einer QuickInfo verwendet werden. Wenn gleichwertige ToolTip eigenschaften und ToolTipService festgelegt sind, hat die ToolTipService -Eigenschaft Vorrang. Wenn beispielsweise sowohl die ToolTip.Placement -Eigenschaft als auch die ToolTipService.Placement -Eigenschaft für ein System.Windows.Controls.ToolTip -Objekt festgelegt sind, wird der Wert der ToolTipService.Placement -Eigenschaft verwendet.

Die folgenden ToolTipService Timing-Eigenschaften werden nur für die ToolTipService -Klasse definiert und von allen QuickInfos verwendet:

Informationen zum Behandeln der Ereignisse, die auftreten, wenn die QuickInfo geöffnet oder geschlossen wird, finden Sie in den ToolTipOpeningEvent Feldern und ToolTipClosingEvent .

Placement, PlacementRectangle, PlacementTarget, HorizontalOffsetund VerticalOffset verhalten sich ähnlich wie die Eigenschaften desselben Namens in der Popup -Klasse. Weitere Informationen finden Sie unter Verhalten beim Platzieren von Popups.

Felder

BetweenShowDelayProperty

Bezeichnet die angefügte BetweenShowDelay-Eigenschaft.

HasDropShadowProperty

Bezeichnet die angefügte HasDropShadow-Eigenschaft.

HorizontalOffsetProperty

Bezeichnet die angefügte HorizontalOffset-Eigenschaft.

InitialShowDelayProperty

Bezeichnet die angefügte InitialShowDelay-Eigenschaft.

IsEnabledProperty

Bezeichnet die angefügte IsEnabled-Eigenschaft.

IsOpenProperty

Bezeichnet die angefügte IsOpen-Eigenschaft.

PlacementProperty

Bezeichnet die angefügte Placement-Eigenschaft.

PlacementRectangleProperty

Bezeichnet die angefügte PlacementRectangle-Eigenschaft.

PlacementTargetProperty

Bezeichnet die angefügte PlacementTarget-Eigenschaft.

ShowDurationProperty

Bezeichnet die angefügte ShowDuration-Eigenschaft.

ShowOnDisabledProperty

Bezeichnet die angefügte ShowOnDisabled-Eigenschaft.

ShowsToolTipOnKeyboardFocusProperty

Stellt einen Dienst dar, der Eigenschaften und Ereignisse zum Steuern der Anzeige und des Verhaltens von QuickInfos bereitstellt.

ToolTipClosingEvent

Bezeichnet das ToolTipClosing-Ereignis, das von Objekten verfügbar gemacht wird, die den ToolTipService-Dienst verwenden, um QuickInfos anzuzeigen.

ToolTipOpeningEvent

Bezeichnet das ToolTipOpening-Ereignis, das von Objekten verfügbar gemacht wird, die den ToolTipService-Dienst verwenden, um QuickInfos anzuzeigen.

ToolTipProperty

Bezeichnet die angefügte ToolTip-Eigenschaft.

VerticalOffsetProperty

Bezeichnet die angefügte VerticalOffset-Eigenschaft.

Angefügte Eigenschaften

BetweenShowDelay

Dient zum Abrufen oder Festlegen der maximalen Zeit zwischen der Anzeige von zwei QuickInfos, wobei die zweite QuickInfo ohne eine Verzögerung angezeigt wird.

HasDropShadow

Ruft ab oder legt fest, ob die QuickInfo einen Schlagschatteneffekt anzeigt.

HorizontalOffset

Ruft den Offset von der linken Seite des Bereichs ab oder legt diesen fest, der für die QuickInfo von den Eigenschaften PlacementRectangle und PlacementTarget angegeben wird.

InitialShowDelay

Ruft die Zeitspanne ab oder legt diese fest, bevor eine QuickInfo geöffnet wird.

IsEnabled

Ruft ab oder legt fest, ob eine QuickInfo angezeigt wird.

IsOpen

Ruft ab, ob derzeit eine QuickInfo angezeigt wird.

Placement

Ruft die Ausrichtung der QuickInfo beim Öffnen ab oder legt diese fest. Zudem wird das Verhalten der QuickInfo angegeben, wenn es die Bildschirmbegrenzungen überschreitet.

PlacementRectangle

Ruft den rechteckigen Bereich ab, zu dem die QuickInfo relativ positioniert wird, bzw. legt diesen fest.

PlacementTarget

Dient zum Abrufen oder Festlegen des Objekts, relativ zu dem die QuickInfo positioniert wird.

ShowDuration

Ruft die Zeitspanne ab oder legt diese fest, für die eine QuickInfo angezeigt wird.

ShowOnDisabled

Dient zum Abrufen oder Festlegen, ob eine QuickInfo für ein Objekt angezeigt wird, das nicht aktiviert ist.

ShowsToolTipOnKeyboardFocus

Stellt einen Dienst dar, der Eigenschaften und Ereignisse zum Steuern der Anzeige und des Verhaltens von QuickInfos bereitstellt.

ToolTip

Ruft den Inhalt einer QuickInfo ab oder legt ihn fest.

VerticalOffset

Ruft den Abstand vom oberen Rand des Bereichs ab, der für die QuickInfo von den Eigenschaften PlacementRectangle und PlacementTarget angegeben wird, oder legt diesen fest.

Methoden

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Fügt einen Handler für das angefügte ToolTipClosing-Ereignis hinzu.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Fügt einen Handler für das angefügte ToolTipOpening-Ereignis hinzu.

GetBetweenShowDelay(DependencyObject)

Ruft den Wert der angefügten Eigenschaft BetweenShowDelay für ein Objekt ab.

GetHasDropShadow(DependencyObject)

Ruft den Wert der angefügten Eigenschaft HasDropShadow für ein Objekt ab.

GetHorizontalOffset(DependencyObject)

Ruft den Wert der angefügten Eigenschaft HorizontalOffset für ein Objekt ab.

GetInitialShowDelay(DependencyObject)

Ruft den Wert der angefügten Eigenschaft InitialShowDelay für ein Objekt ab.

GetIsEnabled(DependencyObject)

Ruft den Wert der angefügten Eigenschaft IsEnabled für ein Objekt ab.

GetIsOpen(DependencyObject)

Ruft den Wert der angefügten Eigenschaft IsOpen für ein Objekt ab.

GetPlacement(DependencyObject)

Ruft den Wert der angefügten Eigenschaft Placement für ein Objekt ab.

GetPlacementRectangle(DependencyObject)

Ruft den Wert der angefügten Eigenschaft PlacementRectangle für ein Objekt ab.

GetPlacementTarget(DependencyObject)

Ruft den Wert der angefügten Eigenschaft PlacementTarget für ein Objekt ab.

GetShowDuration(DependencyObject)

Ruft den Wert der angefügten Eigenschaft ShowDuration für ein Objekt ab.

GetShowOnDisabled(DependencyObject)

Ruft den Wert der angefügten Eigenschaft ShowOnDisabled für ein Objekt ab.

GetShowsToolTipOnKeyboardFocus(DependencyObject)

Stellt einen Dienst dar, der Eigenschaften und Ereignisse zum Steuern der Anzeige und des Verhaltens von QuickInfos bereitstellt.

GetToolTip(DependencyObject)

Ruft den Wert der angefügten Eigenschaft ToolTip für ein Objekt ab.

GetVerticalOffset(DependencyObject)

Ruft den Wert der angefügten Eigenschaft VerticalOffset für ein Objekt ab.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Entfernt einen Handler für das angefügte ToolTipClosing-Ereignis.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Entfernt einen Handler für das angefügte ToolTipOpening-Ereignis.

SetBetweenShowDelay(DependencyObject, Int32)

Legt den Wert der angefügten Eigenschaft BetweenShowDelay für ein Objekt fest.

SetHasDropShadow(DependencyObject, Boolean)

Legt den Wert der angefügten Eigenschaft HasDropShadow für ein Objekt fest.

SetHorizontalOffset(DependencyObject, Double)

Legt den Wert der angefügten Eigenschaft HorizontalOffset für ein Objekt fest.

SetInitialShowDelay(DependencyObject, Int32)

Legt den Wert der angefügten Eigenschaft InitialShowDelay für ein Objekt fest.

SetIsEnabled(DependencyObject, Boolean)

Legt den Wert der angefügten Eigenschaft IsEnabled für ein Objekt fest.

SetPlacement(DependencyObject, PlacementMode)

Legt den Wert der angefügten Eigenschaft Placement für ein Objekt fest.

SetPlacementRectangle(DependencyObject, Rect)

Legt den Wert der angefügten Eigenschaft PlacementRectangle für ein Objekt fest.

SetPlacementTarget(DependencyObject, UIElement)

Legt den Wert der angefügten Eigenschaft PlacementTarget für ein Objekt fest.

SetShowDuration(DependencyObject, Int32)

Legt den Wert der angefügten Eigenschaft ShowDuration für ein Objekt fest.

SetShowOnDisabled(DependencyObject, Boolean)

Legt den Wert der angefügten Eigenschaft ShowOnDisabled für ein Objekt fest.

SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>)

Stellt einen Dienst dar, der Eigenschaften und Ereignisse zum Steuern der Anzeige und des Verhaltens von QuickInfos bereitstellt.

SetToolTip(DependencyObject, Object)

Legt den Wert der angefügten Eigenschaft ToolTip für ein Objekt fest.

SetVerticalOffset(DependencyObject, Double)

Legt den Wert der angefügten Eigenschaft VerticalOffset für ein Objekt fest.

Angefügte Ereignisse

ToolTipClosing

Tritt ein, wenn ToolTip geschlossen wird.

ToolTipOpening

Tritt ein, wenn ToolTip geöffnet wird.

Gilt für:

Weitere Informationen