ToolTipService Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Representerar en tjänst som tillhandahåller egenskaper och händelser för att styra visning och beteende för knappbeskrivningar.
public ref class ToolTipService abstract sealed
public static class ToolTipService
type ToolTipService = class
Public Class ToolTipService
- Arv
-
ToolTipService
Exempel
I följande exempel visas hur du använder ToolTipService klassen för att ange beteendet för en knappbeskrivning. Du anger egenskaperna ToolTipService för klassen genom att koppla dem direkt till elementet som exponerar knappbeskrivningen.
<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>
Kommentarer
Du definierar en knappbeskrivning för ett element genom att FrameworkContentElement.ToolTip ange egenskapen eller FrameworkElement.ToolTip . Egenskapen ToolTip tar ett underordnat värde. Innehållet i det underordnade kan variera från en enkel textsträng till mer komplext innehåll, till exempel ett StackPanel innehåll som har inbäddad text och Image element.
Du kan definiera knappbeskrivningsinnehåll som ett ToolTip objekt, men det krävs inte. När du inte definierar knappbeskrivningsinnehållet som ett ToolTip objekt kan du använda ToolTipService egenskaperna för att placera och anpassa knappbeskrivningsinnehållet. Kopplade egenskaper för ToolTipService klassen används för att fastställa placering, beteende och utseende för en knappbeskrivning. De här egenskaperna anges för elementet som definierar knappbeskrivningen.
Klassen ToolTip och ToolTipService klassen delar många av samma egenskaper som används för att anpassa en knappbeskrivning. Om både ekvivalenter ToolTip och ToolTipService egenskaper anges har egenskapen ToolTipService företräde. Om till exempel både egenskapen ToolTip.Placement och egenskapen ToolTipService.Placement har angetts för ett System.Windows.Controls.ToolTip-objekt används värdet för egenskapen ToolTipService.Placement.
Följande ToolTipService tidsegenskaper definieras endast för ToolTipService klassen och används av alla knappbeskrivningar:
Information om hur du hanterar de händelser som inträffar när knappbeskrivningen öppnas eller stängs finns i fälten ToolTipOpeningEvent och ToolTipClosingEvent .
Placement, PlacementRectangle, PlacementTarget, HorizontalOffsetoch VerticalOffset fungerar på samma sätt som egenskaperna för samma namn i Popup klassen. Mer information finns i Beteende för placering av popup-fönster.
Fält
| Name | Description |
|---|---|
| BetweenShowDelayProperty |
Identifierar den BetweenShowDelay anslutna egenskapen. |
| HasDropShadowProperty |
Identifierar den HasDropShadow anslutna egenskapen. |
| HorizontalOffsetProperty |
Identifierar den HorizontalOffset anslutna egenskapen. |
| InitialShowDelayProperty |
Identifierar den InitialShowDelay anslutna egenskapen. |
| IsEnabledProperty |
Identifierar den IsEnabled anslutna egenskapen. |
| IsOpenProperty |
Identifierar den IsOpen anslutna egenskapen. |
| PlacementProperty |
Identifierar den Placement anslutna egenskapen. |
| PlacementRectangleProperty |
Identifierar den PlacementRectangle anslutna egenskapen. |
| PlacementTargetProperty |
Identifierar den PlacementTarget anslutna egenskapen. |
| ShowDurationProperty |
Identifierar den ShowDuration anslutna egenskapen. |
| ShowOnDisabledProperty |
Identifierar den ShowOnDisabled anslutna egenskapen. |
| ShowsToolTipOnKeyboardFocusProperty |
Representerar en tjänst som tillhandahåller egenskaper och händelser för att styra visning och beteende för knappbeskrivningar. |
| ToolTipClosingEvent |
Identifierar händelsen ToolTipClosing som exponeras av objekt som använder ToolTipService tjänsten för att visa knappbeskrivningar. |
| ToolTipOpeningEvent |
Identifierar händelsen ToolTipOpening som exponeras av objekt som använder ToolTipService tjänsten för att visa knappbeskrivningar. |
| ToolTipProperty |
Identifierar den ToolTip anslutna egenskapen. |
| VerticalOffsetProperty |
Identifierar den VerticalOffset anslutna egenskapen. |
Kopplade egenskaper
| Name | Description |
|---|---|
| BetweenShowDelay |
Hämtar eller anger den maximala tiden mellan visningen av två knappbeskrivningar där den andra knappbeskrivningen visas utan fördröjning. |
| HasDropShadow |
Hämtar eller anger om knappbeskrivningen visar en skuggeffekt. |
| HorizontalOffset |
Hämtar eller anger förskjutningen till vänster om det område som anges för knappbeskrivningen av PlacementRectangle egenskaperna och PlacementTarget . |
| InitialShowDelay |
Hämtar eller anger hur lång tid en knappbeskrivning ska öppnas. |
| IsEnabled |
Hämtar eller anger om en knappbeskrivning ska visas. |
| IsOpen |
Hämtar om en knappbeskrivning är synlig för närvarande. |
| Placement |
Hämtar eller anger orienteringen för knappbeskrivningen när den öppnas och anger hur knappbeskrivningen fungerar när den överlappar skärmgränserna. |
| PlacementRectangle |
Hämtar eller anger det rektangulära området i förhållande till vilket knappbeskrivningen är placerad. |
| PlacementTarget |
Hämtar eller anger objektet i förhållande till vilket knappbeskrivningen är placerad. |
| ShowDuration |
Hämtar eller anger hur lång tid en knappbeskrivning ska vara synlig. |
| ShowOnDisabled |
Hämtar eller anger om en knappbeskrivning ska visas för ett objekt som inte är aktiverat. |
| ShowsToolTipOnKeyboardFocus |
Representerar en tjänst som tillhandahåller egenskaper och händelser för att styra visning och beteende för knappbeskrivningar. |
| ToolTip |
Hämtar eller anger innehållet i en knappbeskrivning. |
| VerticalOffset |
Hämtar eller anger avståndet från det övre området som anges för knappbeskrivningen av PlacementRectangle egenskaperna och PlacementTarget . |
Metoder
| Name | Description |
|---|---|
| AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) |
Lägger till en hanterare för den anslutna ToolTipClosing händelsen. |
| AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) |
Lägger till en hanterare för den anslutna ToolTipOpening händelsen. |
| GetBetweenShowDelay(DependencyObject) |
Hämtar värdet för den BetweenShowDelay bifogade egenskapen för ett objekt. |
| GetHasDropShadow(DependencyObject) |
Hämtar värdet för den HasDropShadow bifogade egenskapen för ett objekt. |
| GetHorizontalOffset(DependencyObject) |
Hämtar värdet för den HorizontalOffset bifogade egenskapen för ett objekt. |
| GetInitialShowDelay(DependencyObject) |
Hämtar värdet för den InitialShowDelay bifogade egenskapen för ett objekt. |
| GetIsEnabled(DependencyObject) |
Hämtar värdet för den IsEnabled bifogade egenskapen för ett objekt. |
| GetIsOpen(DependencyObject) |
Hämtar värdet för den IsOpen bifogade egenskapen för ett objekt. |
| GetPlacement(DependencyObject) |
Hämtar värdet för den Placement bifogade egenskapen för ett objekt. |
| GetPlacementRectangle(DependencyObject) |
Hämtar värdet för den PlacementRectangle bifogade egenskapen för ett objekt. |
| GetPlacementTarget(DependencyObject) |
Hämtar värdet för den PlacementTarget bifogade egenskapen för ett objekt. |
| GetShowDuration(DependencyObject) |
Hämtar värdet för den ShowDuration bifogade egenskapen för ett objekt. |
| GetShowOnDisabled(DependencyObject) |
Hämtar värdet för den ShowOnDisabled bifogade egenskapen för ett objekt. |
| GetShowsToolTipOnKeyboardFocus(DependencyObject) |
Representerar en tjänst som tillhandahåller egenskaper och händelser för att styra visning och beteende för knappbeskrivningar. |
| GetToolTip(DependencyObject) |
Hämtar värdet för den ToolTip bifogade egenskapen för ett objekt. |
| GetVerticalOffset(DependencyObject) |
Hämtar värdet för den VerticalOffset bifogade egenskapen för ett objekt. |
| RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) |
Tar bort en hanterare för den anslutna ToolTipClosing händelsen. |
| RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) |
Tar bort en hanterare för den anslutna ToolTipOpening händelsen. |
| SetBetweenShowDelay(DependencyObject, Int32) |
Anger värdet för den BetweenShowDelay anslutna egenskapen för ett objekt. |
| SetHasDropShadow(DependencyObject, Boolean) |
Anger värdet för den HasDropShadow anslutna egenskapen för ett objekt. |
| SetHorizontalOffset(DependencyObject, Double) |
Anger värdet för den HorizontalOffset anslutna egenskapen för ett objekt. |
| SetInitialShowDelay(DependencyObject, Int32) |
Anger värdet för den InitialShowDelay anslutna egenskapen för ett objekt. |
| SetIsEnabled(DependencyObject, Boolean) |
Anger värdet för den IsEnabled anslutna egenskapen för ett objekt. |
| SetPlacement(DependencyObject, PlacementMode) |
Anger värdet för den Placement anslutna egenskapen för ett objekt. |
| SetPlacementRectangle(DependencyObject, Rect) |
Anger värdet för den PlacementRectangle anslutna egenskapen för ett objekt. |
| SetPlacementTarget(DependencyObject, UIElement) |
Anger värdet för den PlacementTarget anslutna egenskapen för ett objekt. |
| SetShowDuration(DependencyObject, Int32) |
Anger värdet för den ShowDuration anslutna egenskapen för ett objekt. |
| SetShowOnDisabled(DependencyObject, Boolean) |
Anger värdet för den ShowOnDisabled anslutna egenskapen för ett objekt. |
| SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>) |
Representerar en tjänst som tillhandahåller egenskaper och händelser för att styra visning och beteende för knappbeskrivningar. |
| SetToolTip(DependencyObject, Object) |
Anger värdet för den ToolTip anslutna egenskapen för ett objekt. |
| SetVerticalOffset(DependencyObject, Double) |
Anger värdet för den VerticalOffset anslutna egenskapen för ett objekt. |
Anslutna händelser
| Name | Description |
|---|---|
| ToolTipClosing |
Inträffar när stängs ToolTip . |
| ToolTipOpening |
Inträffar när öppnas ToolTip . |