ToolTipService Klasa

Definicja

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 .

Dotyczy

Zobacz też