ToolTipService Класс

Определение

Пространство имен:

System.Windows.Controls

Сборка:

PresentationFramework.dll

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

public ref class ToolTipService abstract sealed

public static class ToolTipService

type ToolTipService = class

Public Class ToolTipService

Наследование

Object

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 класса и используются всеми подсказками:

• InitialShowDelay

• ShowDuration

• BetweenShowDelay

Сведения об обработке событий, возникающих при открытии или закрытии подсказки, см. в 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.

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

• ToolTip
• ToolTipEventHandler
• ToolTipEventArgs