Поделиться через


ToolTipService Класс

Определение

Представляет службу, которая предоставляет свойства и события для управления отображением и поведением подсказок.

public ref class ToolTipService abstract sealed
public static class ToolTipService
type ToolTipService = class
Public Class ToolTipService
Наследование
ToolTipService

Примеры

В следующем примере показано, как класс используется ToolTipService для указания поведения подсказки. Свойства класса задаются ToolTipService путем их присоединения непосредственно к элементу, который предоставляет подсказку.

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

Комментарии

Подсказку для элемента можно определить, задав FrameworkContentElement.ToolTip свойство или FrameworkElement.ToolTip . Свойство ToolTip принимает один дочерний элемент. Содержимое дочернего элемента может варьироваться от простой текстовой строки до более сложного содержимого, например , с внедренным текстом StackPanel и Image элементами.

Содержимое подсказки можно определить как ToolTip объект , но это необязательно. Если содержимое подсказки не определено как ToolTip объект, можно использовать ToolTipService свойства для размещения и настройки содержимого подсказки. Присоединенные ToolTipService свойства класса используются для определения размещения, поведения и внешнего вида подсказки. Эти свойства задаются для элемента, определяющего подсказку.

Класс ToolTip и класс имеют ToolTipService много одинаковых свойств, которые используются для настройки подсказки. Если заданы эквивалентные ToolTip свойства и ToolTipService , ToolTipService свойство имеет приоритет. Например, если ToolTip.Placement свойство и ToolTipService.Placement свойство заданы для System.Windows.Controls.ToolTip объекта , используется значение ToolTipService.Placement свойства .

Следующие ToolTipService свойства времени определяются только для ToolTipService класса и используются всеми подсказками:

Сведения об обработке событий, возникающих при открытии или закрытии подсказки, см. в ToolTipOpeningEvent полях и ToolTipClosingEvent .

Placement, PlacementRectangle, PlacementTarget, HorizontalOffsetи VerticalOffset ведут себя аналогично свойствам с тем же именем в Popup классе . Дополнительные сведения см. в разделе Поведение при размещении контекстного меню.

Поля

BetweenShowDelayProperty

Идентифицирует присоединенное свойство BetweenShowDelay.

HasDropShadowProperty

Идентифицирует присоединенное свойство HasDropShadow.

HorizontalOffsetProperty

Идентифицирует присоединенное свойство HorizontalOffset.

InitialShowDelayProperty

Идентифицирует присоединенное свойство InitialShowDelay.

IsEnabledProperty

Идентифицирует присоединенное свойство IsEnabled.

IsOpenProperty

Идентифицирует присоединенное свойство IsOpen.

PlacementProperty

Идентифицирует присоединенное свойство Placement.

PlacementRectangleProperty

Идентифицирует присоединенное свойство PlacementRectangle.

PlacementTargetProperty

Идентифицирует присоединенное свойство PlacementTarget.

ShowDurationProperty

Идентифицирует присоединенное свойство ShowDuration.

ShowOnDisabledProperty

Идентифицирует присоединенное свойство ShowOnDisabled.

ShowsToolTipOnKeyboardFocusProperty

Представляет службу, которая предоставляет свойства и события для управления отображением и поведением подсказок.

ToolTipClosingEvent

Определяет событие ToolTipClosing, которое предоставляется объектами, использующими службу ToolTipService для отображения подсказок.

ToolTipOpeningEvent

Определяет событие ToolTipOpening, которое предоставляется объектами, использующими службу ToolTipService для отображения подсказок.

ToolTipProperty

Идентифицирует присоединенное свойство ToolTip.

VerticalOffsetProperty

Идентифицирует присоединенное свойство VerticalOffset.

Присоединенные свойства

BetweenShowDelay

Возвращает или задает максимальное время между отображением двух подсказок, где вторая подсказка отображается без задержки.

HasDropShadow

Возвращает или задает для отображения подсказки эффект падающей тени.

HorizontalOffset

Возвращает или задает смещение от левого края области, определенной для подсказки в свойствах PlacementRectangle и PlacementTarget.

InitialShowDelay

Получает или задает интервал времени до открытия подсказки.

IsEnabled

Возвращает или задает, появляется ли подсказка.

IsOpen

Получает значение, указывающее, отображается ли подсказка в текущий момент.

Placement

Возвращает или задает ориентацию подсказки при ее открытии и указывает поведение подсказки при перекрытии границ экрана.

PlacementRectangle

Получает или задает прямоугольную область, в которой размещается подсказка.

PlacementTarget

Получает или задает объект, относительно которого размещается подсказка.

ShowDuration

Получает или задает количество времени отображения подсказки.

ShowOnDisabled

Получает или задает значение, указывающее, отображается ли всплывающая подсказка для объекта, который не активен.

ShowsToolTipOnKeyboardFocus

Представляет службу, которая предоставляет свойства и события для управления отображением и поведением подсказок.

ToolTip

Возвращает или задает содержимое подсказки.

VerticalOffset

Получает или задает расстояние от верхнего края области, указанной для подсказки свойствами PlacementRectangle и PlacementTarget.

Методы

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Добавляет обработчик для вложенного события ToolTipClosing.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Добавляет обработчик для вложенного события ToolTipOpening.

GetBetweenShowDelay(DependencyObject)

Получает значение присоединенного свойства BetweenShowDelay для объекта.

GetHasDropShadow(DependencyObject)

Получает значение присоединенного свойства HasDropShadow для объекта.

GetHorizontalOffset(DependencyObject)

Получает значение присоединенного свойства HorizontalOffset для объекта.

GetInitialShowDelay(DependencyObject)

Получает значение присоединенного свойства InitialShowDelay для объекта.

GetIsEnabled(DependencyObject)

Получает значение присоединенного свойства IsEnabled для объекта.

GetIsOpen(DependencyObject)

Получает значение присоединенного свойства IsOpen для объекта.

GetPlacement(DependencyObject)

Получает значение присоединенного свойства Placement для объекта.

GetPlacementRectangle(DependencyObject)

Получает значение присоединенного свойства PlacementRectangle для объекта.

GetPlacementTarget(DependencyObject)

Получает значение присоединенного свойства PlacementTarget для объекта.

GetShowDuration(DependencyObject)

Получает значение присоединенного свойства ShowDuration для объекта.

GetShowOnDisabled(DependencyObject)

Получает значение присоединенного свойства ShowOnDisabled для объекта.

GetShowsToolTipOnKeyboardFocus(DependencyObject)

Представляет службу, которая предоставляет свойства и события для управления отображением и поведением подсказок.

GetToolTip(DependencyObject)

Получает значение присоединенного свойства ToolTip для объекта.

GetVerticalOffset(DependencyObject)

Получает значение присоединенного свойства VerticalOffset для объекта.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Удаляет обработчик для вложенного события ToolTipClosing.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Удаляет обработчик для вложенного события ToolTipOpening.

SetBetweenShowDelay(DependencyObject, Int32)

Задает значение присоединенного свойства BetweenShowDelay для объекта.

SetHasDropShadow(DependencyObject, Boolean)

Задает значение присоединенного свойства HasDropShadow для объекта.

SetHorizontalOffset(DependencyObject, Double)

Задает значение присоединенного свойства HorizontalOffset для объекта.

SetInitialShowDelay(DependencyObject, Int32)

Задает значение присоединенного свойства InitialShowDelay для объекта.

SetIsEnabled(DependencyObject, Boolean)

Задает значение присоединенного свойства IsEnabled для объекта.

SetPlacement(DependencyObject, PlacementMode)

Задает значение присоединенного свойства Placement для объекта.

SetPlacementRectangle(DependencyObject, Rect)

Задает значение присоединенного свойства PlacementRectangle для объекта.

SetPlacementTarget(DependencyObject, UIElement)

Задает значение присоединенного свойства PlacementTarget для объекта.

SetShowDuration(DependencyObject, Int32)

Задает значение присоединенного свойства ShowDuration для объекта.

SetShowOnDisabled(DependencyObject, Boolean)

Задает значение присоединенного свойства ShowOnDisabled для объекта.

SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>)

Представляет службу, которая предоставляет свойства и события для управления отображением и поведением подсказок.

SetToolTip(DependencyObject, Object)

Задает значение присоединенного свойства ToolTip для объекта.

SetVerticalOffset(DependencyObject, Double)

Задает значение присоединенного свойства VerticalOffset для объекта.

Присоединенные события

ToolTipClosing

Происходит при закрытии элемента ToolTip.

ToolTipOpening

Возникает при открытии ToolTip.

Применяется к

См. также раздел