ToolTipService Klasse
Definition
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 sealedpublic static class ToolTipServicetype ToolTipService = classPublic 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. |
