ToolTipService Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje usługę, która udostępnia właściwości i zdarzenia do kontrolowania wyświetlania i zachowania etykietek narzędzi.
public ref class ToolTipService abstract sealed
public static class ToolTipService
type ToolTipService = class
Public Class ToolTipService
- Dziedziczenie
-
ToolTipService
Przykłady
W poniższym przykładzie pokazano, jak używać ToolTipService klasy do określania zachowania etykietki narzędzia. Właściwości klasy można ustawić ToolTipService , dołączając je bezpośrednio do elementu, który uwidacznia etykietkę narzędzia.
<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>
Uwagi
Etykietkę narzędzia dla elementu należy zdefiniować, ustawiając FrameworkContentElement.ToolTip właściwość or FrameworkElement.ToolTip . Właściwość ToolTip przyjmuje jedno dziecko. Zawartość elementu podrzędnego może się różnić od prostego ciągu tekstowego do bardziej złożonej zawartości, takiej jak StackPanel osadzony tekst i Image elementy.
Zawartość etykietki narzędzia można zdefiniować jako ToolTip obiekt, ale nie jest to wymagane. Jeśli nie zdefiniujesz zawartości etykietki narzędzia jako ToolTip obiektu, możesz użyć ToolTipService właściwości do pozycjonowania i dostosowywania zawartości etykietki narzędzia. Dołączone właściwości ToolTipService klasy służą do określania umieszczania, zachowania i wyglądu etykietki narzędzia. Te właściwości są ustawiane na elemecie definiującym etykietkę narzędzia.
Klasa ToolTip i ToolTipService klasa współdzielą wiele z tych samych właściwości, które są używane do dostosowywania etykietki narzędzia. Jeśli obie właściwości są ustawioneToolTipService, ToolTipToolTipService właściwość ma pierwszeństwo. Jeśli na przykład zarówno ToolTip.Placement właściwość, jak i ToolTipService.Placement właściwość są ustawione dla System.Windows.Controls.ToolTip obiektu, zostanie użyta wartość ToolTipService.Placement właściwości.
Następujące ToolTipService właściwości chronometrażu ToolTipService są definiowane tylko dla klasy i są używane przez wszystkie etykietki narzędzi:
Aby uzyskać informacje na temat obsługi zdarzeń występujących po otwarciu lub zamknięciu etykietki narzędzia, zobacz ToolTipOpeningEvent pola i ToolTipClosingEvent .
Placement, PlacementRectangle, , HorizontalOffsetPlacementTargeti VerticalOffset zachowuje się podobnie do właściwości tej samej nazwy w Popup klasie. Aby uzyskać więcej informacji, zobacz Zachowanie umieszczania wyskakujących okienek.
Pola
BetweenShowDelayProperty |
Identyfikuje dołączoną BetweenShowDelay właściwość. |
HasDropShadowProperty |
Identyfikuje dołączoną HasDropShadow właściwość. |
HorizontalOffsetProperty |
Identyfikuje dołączoną HorizontalOffset właściwość. |
InitialShowDelayProperty |
Identyfikuje dołączoną InitialShowDelay właściwość. |
IsEnabledProperty |
Identyfikuje dołączoną IsEnabled właściwość. |
IsOpenProperty |
Identyfikuje dołączoną IsOpen właściwość. |
PlacementProperty |
Identyfikuje dołączoną Placement właściwość. |
PlacementRectangleProperty |
Identyfikuje dołączoną PlacementRectangle właściwość. |
PlacementTargetProperty |
Identyfikuje dołączoną PlacementTarget właściwość. |
ShowDurationProperty |
Identyfikuje dołączoną ShowDuration właściwość. |
ShowOnDisabledProperty |
Identyfikuje dołączoną ShowOnDisabled właściwość. |
ShowsToolTipOnKeyboardFocusProperty |
Reprezentuje usługę, która udostępnia właściwości i zdarzenia do kontrolowania wyświetlania i zachowania etykietek narzędzi. |
ToolTipClosingEvent |
Identyfikuje ToolTipClosing zdarzenie, które jest uwidocznione przez obiekty, które używają usługi do wyświetlania ToolTipService etykietek narzędzi. |
ToolTipOpeningEvent |
Identyfikuje ToolTipOpening zdarzenie, które jest uwidocznione przez obiekty, które używają usługi do wyświetlania ToolTipService etykietek narzędzi. |
ToolTipProperty |
Identyfikuje dołączoną ToolTip właściwość. |
VerticalOffsetProperty |
Identyfikuje dołączoną VerticalOffset właściwość. |
Właściwości dołączone
BetweenShowDelay |
Pobiera lub ustawia maksymalny czas między wyświetlaniem dwóch etykietek narzędzi, w których druga etykietka narzędzia pojawia się bez opóźnień. |
HasDropShadow |
Pobiera lub ustawia, czy etykietka narzędzia wyświetla efekt cienia upuszczania. |
HorizontalOffset |
Pobiera lub ustawia przesunięcie z lewej strony obszaru określonego dla etykietki narzędzia przez PlacementRectangle właściwości i PlacementTarget . |
InitialShowDelay |
Pobiera lub ustawia czas przed otwarciem etykietki narzędzia. |
IsEnabled |
Pobiera lub ustawia, czy jest wyświetlana etykietka narzędzia. |
IsOpen |
Pobiera, czy etykietka narzędzia jest obecnie widoczna. |
Placement |
Pobiera lub ustawia orientację etykietki narzędzia po otwarciu i określa, jak etykietka narzędzia zachowuje się, gdy nakłada się granice ekranu. |
PlacementRectangle |
Pobiera lub ustawia prostokątny obszar, względem którego znajduje się etykietka narzędzia. |
PlacementTarget |
Pobiera lub ustawia obiekt względem pozycji etykietki narzędzia. |
ShowDuration |
Pobiera lub ustawia czas, przez jaki etykietka narzędzia pozostaje widoczna. |
ShowOnDisabled |
Pobiera lub ustawia, czy etykietka narzędzia jest wyświetlana dla obiektu, który nie jest włączony. |
ShowsToolTipOnKeyboardFocus |
Reprezentuje usługę, która udostępnia właściwości i zdarzenia do kontrolowania wyświetlania i zachowania etykietek narzędzi. |
ToolTip |
Pobiera lub ustawia zawartość etykietki narzędzia. |
VerticalOffset |
Pobiera lub ustawia odległość od góry obszaru określonego dla etykietki narzędzia przez PlacementRectangle właściwości i PlacementTarget . |
Metody
AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) |
Dodaje procedurę obsługi dołączonego ToolTipClosing zdarzenia. |
AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) |
Dodaje procedurę obsługi dołączonego ToolTipOpening zdarzenia. |
GetBetweenShowDelay(DependencyObject) |
Pobiera wartość dołączonej BetweenShowDelay właściwości dla obiektu. |
GetHasDropShadow(DependencyObject) |
Pobiera wartość dołączonej HasDropShadow właściwości dla obiektu. |
GetHorizontalOffset(DependencyObject) |
Pobiera wartość dołączonej HorizontalOffset właściwości dla obiektu. |
GetInitialShowDelay(DependencyObject) |
Pobiera wartość dołączonej InitialShowDelay właściwości dla obiektu. |
GetIsEnabled(DependencyObject) |
Pobiera wartość dołączonej IsEnabled właściwości dla obiektu. |
GetIsOpen(DependencyObject) |
Pobiera wartość dołączonej IsOpen właściwości dla obiektu. |
GetPlacement(DependencyObject) |
Pobiera wartość dołączonej Placement właściwości dla obiektu. |
GetPlacementRectangle(DependencyObject) |
Pobiera wartość dołączonej PlacementRectangle właściwości dla obiektu. |
GetPlacementTarget(DependencyObject) |
Pobiera wartość dołączonej PlacementTarget właściwości dla obiektu. |
GetShowDuration(DependencyObject) |
Pobiera wartość dołączonej ShowDuration właściwości dla obiektu. |
GetShowOnDisabled(DependencyObject) |
Pobiera wartość dołączonej ShowOnDisabled właściwości dla obiektu. |
GetShowsToolTipOnKeyboardFocus(DependencyObject) |
Reprezentuje usługę, która udostępnia właściwości i zdarzenia do kontrolowania wyświetlania i zachowania etykietek narzędzi. |
GetToolTip(DependencyObject) |
Pobiera wartość dołączonej ToolTip właściwości dla obiektu. |
GetVerticalOffset(DependencyObject) |
Pobiera wartość dołączonej VerticalOffset właściwości dla obiektu. |
RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) |
Usuwa procedurę obsługi dołączonego ToolTipClosing zdarzenia. |
RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) |
Usuwa procedurę obsługi dołączonego ToolTipOpening zdarzenia. |
SetBetweenShowDelay(DependencyObject, Int32) |
Ustawia wartość dołączonej BetweenShowDelay właściwości dla obiektu. |
SetHasDropShadow(DependencyObject, Boolean) |
Ustawia wartość dołączonej HasDropShadow właściwości dla obiektu. |
SetHorizontalOffset(DependencyObject, Double) |
Ustawia wartość dołączonej HorizontalOffset właściwości dla obiektu. |
SetInitialShowDelay(DependencyObject, Int32) |
Ustawia wartość dołączonej InitialShowDelay właściwości dla obiektu. |
SetIsEnabled(DependencyObject, Boolean) |
Ustawia wartość dołączonej IsEnabled właściwości dla obiektu. |
SetPlacement(DependencyObject, PlacementMode) |
Ustawia wartość dołączonej Placement właściwości dla obiektu. |
SetPlacementRectangle(DependencyObject, Rect) |
Ustawia wartość dołączonej PlacementRectangle właściwości dla obiektu. |
SetPlacementTarget(DependencyObject, UIElement) |
Ustawia wartość dołączonej PlacementTarget właściwości dla obiektu. |
SetShowDuration(DependencyObject, Int32) |
Ustawia wartość dołączonej ShowDuration właściwości dla obiektu. |
SetShowOnDisabled(DependencyObject, Boolean) |
Ustawia wartość dołączonej ShowOnDisabled właściwości dla obiektu. |
SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>) |
Reprezentuje usługę, która udostępnia właściwości i zdarzenia do kontrolowania wyświetlania i zachowania etykietek narzędzi. |
SetToolTip(DependencyObject, Object) |
Ustawia wartość dołączonej ToolTip właściwości dla obiektu. |
SetVerticalOffset(DependencyObject, Double) |
Ustawia wartość dołączonej VerticalOffset właściwości dla obiektu. |
Zdarzenia dołączone
ToolTipClosing |
Występuje po ToolTip zamknięciu. |
ToolTipOpening |
Występuje po otwarciu ToolTip . |