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

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

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

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

Обратная связь

Были ли сведения на этой странице полезными?

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