ToolTipService Klasse

Referenz

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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