ToolTipService ToolTipService ToolTipService ToolTipService Class

Определение

Представляет службу, которая предоставляет свойства и события для управления отображением и поведением подсказок.Represents a service that provides properties and events to control the display and behavior of tooltips.

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

Примеры

В следующем примере показан способ использования ToolTipService класса для указания поведения всплывающей подсказки.The following example shows how the use the ToolTipService class to specify the behavior of a tooltip. Задание свойств ToolTipService класса путем присоединения их непосредственно в элемент, предоставляющий всплывающей подсказки.You set the properties of the ToolTipService class by attaching them directly to the element that exposes the tooltip.

<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 свойство.You define a tooltip for an element by setting the FrameworkContentElement.ToolTip or FrameworkElement.ToolTip property. Свойство ToolTip принимает один дочерний элемент.The ToolTip property takes one child. Содержимое дочернего элемента может варьироваться от простую текстовую строку для более сложного содержимого например StackPanel с внедренными текста и Image элементов.The content of the child can vary from a simple text string to more complex content such as a StackPanel that has embedded text and Image elements.

Можно определить содержимое подсказки как ToolTip объект, но это не является обязательным.You can define tooltip content as a ToolTip object, but this is not required. Если не определить содержимое подсказки как ToolTip объекта, можно использовать ToolTipService свойства размещении и настройке содержимое подсказки.When you do not define the tooltip content as a ToolTip object, you can use the ToolTipService properties to position and customize the tooltip content. Вложенные свойства ToolTipService класса используются для определения размещения, поведение и внешний вид всплывающей подсказки.Attached properties of the ToolTipService class are used to determine the placement, behavior, and appearance of a tooltip. Эти свойства задаются в элементе, который определяет всплывающей подсказки.These properties are set on the element that defines the tooltip.

ToolTip Класс и ToolTipService класс во многом те же свойства, которые используются для настройки подсказок.The ToolTip class and the ToolTipService class share many of the same properties that are used to customize a tooltip. Если эквивалентные ToolTip и ToolTipService заданы оба свойства, ToolTipService свойство имеет более высокий приоритет.If equivalent ToolTip and ToolTipService properties are both set, the ToolTipService property takes precedence. Например, если оба ToolTip.Placement свойство и ToolTipService.Placement свойства задаются для System.Windows.Controls.ToolTip объект, значение ToolTipService.Placement используется свойство.For example, if both the ToolTip.Placement property and the ToolTipService.Placement property are set for a System.Windows.Controls.ToolTip object, the value of the ToolTipService.Placement property is used.

Следующие ToolTipService только определенные свойства времени для ToolTipService класса, а также использует все подсказки:The following ToolTipService timing properties are only defined for the ToolTipService class and are used by all tooltips:

Сведения о том, как обрабатывать события, происходящие при открытии или закрытии подсказки, см. в разделе ToolTipOpeningEvent и ToolTipClosingEvent поля.For information about how to handle the events that occur when the tooltip opens or closes, see the ToolTipOpeningEvent and ToolTipClosingEvent fields.

Placement, PlacementRectangle, PlacementTarget, HorizontalOffset, и VerticalOffset вести себя аналогичным образом к свойствам с тем же именем в Popup класса.Placement, PlacementRectangle, PlacementTarget, HorizontalOffset, and VerticalOffset behave similarly to the properties of the same name in the Popup class. Дополнительные сведения см. в разделе Поведение при размещении контекстного меню.For more information, see Popup Placement Behavior.

Поля

BetweenShowDelayProperty BetweenShowDelayProperty BetweenShowDelayProperty BetweenShowDelayProperty

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

HasDropShadowProperty HasDropShadowProperty HasDropShadowProperty HasDropShadowProperty

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

HorizontalOffsetProperty HorizontalOffsetProperty HorizontalOffsetProperty HorizontalOffsetProperty

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

InitialShowDelayProperty InitialShowDelayProperty InitialShowDelayProperty InitialShowDelayProperty

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

IsEnabledProperty IsEnabledProperty IsEnabledProperty IsEnabledProperty

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

IsOpenProperty IsOpenProperty IsOpenProperty IsOpenProperty

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

PlacementProperty PlacementProperty PlacementProperty PlacementProperty

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

PlacementRectangleProperty PlacementRectangleProperty PlacementRectangleProperty PlacementRectangleProperty

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

PlacementTargetProperty PlacementTargetProperty PlacementTargetProperty PlacementTargetProperty

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

ShowDurationProperty ShowDurationProperty ShowDurationProperty ShowDurationProperty

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

ShowOnDisabledProperty ShowOnDisabledProperty ShowOnDisabledProperty ShowOnDisabledProperty

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

ToolTipClosingEvent ToolTipClosingEvent ToolTipClosingEvent ToolTipClosingEvent

Определяет событие ToolTipClosing, которое предоставляется объектами, использующими службу ToolTipService для отображения подсказок.Identifies the ToolTipClosing event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipOpeningEvent ToolTipOpeningEvent ToolTipOpeningEvent ToolTipOpeningEvent

Определяет событие ToolTipOpening, которое предоставляется объектами, использующими службу ToolTipService для отображения подсказок.Identifies the ToolTipOpening event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipProperty ToolTipProperty ToolTipProperty ToolTipProperty

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

VerticalOffsetProperty VerticalOffsetProperty VerticalOffsetProperty VerticalOffsetProperty

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

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

BetweenShowDelay BetweenShowDelay BetweenShowDelay BetweenShowDelay

Возвращает или задает максимальное время между отображением двух подсказок, где вторая подсказка отображается без задержки.Gets or sets the maximum time between the display of two tooltips where the second tooltip appears without a delay.

HasDropShadow HasDropShadow HasDropShadow HasDropShadow

Возвращает или задает для отображения подсказки эффект падающей тени.Gets or sets whether the tooltip displays a drop shadow effect.

HorizontalOffset HorizontalOffset HorizontalOffset HorizontalOffset

Возвращает или задает смещение от левого края области, определенной для подсказки в свойствах PlacementRectangle и PlacementTarget.Gets or sets the offset from the left of the area that is specified for the tooltip by the PlacementRectangle and PlacementTarget properties.

InitialShowDelay InitialShowDelay InitialShowDelay InitialShowDelay

Получает или задает интервал времени до открытия подсказки.Gets or sets the length of time before a tooltip opens.

IsEnabled IsEnabled IsEnabled IsEnabled

Возвращает или задает, появляется ли подсказка.Gets or sets whether a tooltip appears.

IsOpen IsOpen IsOpen IsOpen

Получает значение, указывающее, отображается ли подсказка в текущий момент.Gets whether a tooltip is currently visible.

Placement Placement Placement Placement

Возвращает или задает ориентацию подсказки при ее открытии и указывает поведение подсказки при перекрытии границ экрана.Gets or sets the orientation of the tooltip when it opens, and specifies how the tooltip behaves when it overlaps screen boundaries.

PlacementRectangle PlacementRectangle PlacementRectangle PlacementRectangle

Получает или задает прямоугольную область, в которой размещается подсказка.Gets or sets the rectangular area relative to which the tooltip is positioned.

PlacementTarget PlacementTarget PlacementTarget PlacementTarget

Получает или задает объект, относительно которого размещается подсказка.Gets or sets the object relative to which the tooltip is positioned.

ShowDuration ShowDuration ShowDuration ShowDuration

Получает или задает количество времени отображения подсказки.Gets or sets the amount of time that a tooltip remains visible.

ShowOnDisabled ShowOnDisabled ShowOnDisabled ShowOnDisabled

Получает или задает значение, указывающее, отображается ли всплывающая подсказка для объекта, который не активен.Gets or sets whether a tooltip appears for an object that is not enabled.

ToolTip ToolTip ToolTip ToolTip

Возвращает или задает содержимое подсказки.Gets or sets the content of a tooltip.

VerticalOffset VerticalOffset VerticalOffset VerticalOffset

Получает или задает расстояние от верхнего края области, указанной для подсказки свойствами PlacementRectangle и PlacementTarget.Gets or sets the distance from the top of the area that is specified for the tooltip by the PlacementRectangle and PlacementTarget properties.

Методы

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Добавляет обработчик для вложенного события ToolTipClosing.Adds a handler for the ToolTipClosing attached event.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Добавляет обработчик для вложенного события ToolTipOpening.Adds a handler for the ToolTipOpening attached event.

GetBetweenShowDelay(DependencyObject) GetBetweenShowDelay(DependencyObject) GetBetweenShowDelay(DependencyObject) GetBetweenShowDelay(DependencyObject)

Получает значение присоединенного свойства BetweenShowDelay для объекта.Gets the value of the BetweenShowDelay attached property for an object.

GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject)

Получает значение присоединенного свойства HasDropShadow для объекта.Gets the value of the HasDropShadow attached property for an object.

GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject)

Получает значение присоединенного свойства HorizontalOffset для объекта.Gets the value of the HorizontalOffset attached property for an object.

GetInitialShowDelay(DependencyObject) GetInitialShowDelay(DependencyObject) GetInitialShowDelay(DependencyObject) GetInitialShowDelay(DependencyObject)

Получает значение присоединенного свойства InitialShowDelay для объекта.Gets the value of the InitialShowDelay attached property for an object.

GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject)

Получает значение присоединенного свойства IsEnabled для объекта.Gets the value of the IsEnabled attached property for an object.

GetIsOpen(DependencyObject) GetIsOpen(DependencyObject) GetIsOpen(DependencyObject) GetIsOpen(DependencyObject)

Получает значение присоединенного свойства IsOpen для объекта.Gets the value of the IsOpen attached property for an object.

GetPlacement(DependencyObject) GetPlacement(DependencyObject) GetPlacement(DependencyObject) GetPlacement(DependencyObject)

Получает значение присоединенного свойства Placement для объекта.Gets the value of the Placement attached property for an object.

GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject)

Получает значение присоединенного свойства PlacementRectangle для объекта.Gets the value of the PlacementRectangle attached property for an object.

GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject)

Получает значение присоединенного свойства PlacementTarget для объекта.Gets the value of the PlacementTarget attached property for an object.

GetShowDuration(DependencyObject) GetShowDuration(DependencyObject) GetShowDuration(DependencyObject) GetShowDuration(DependencyObject)

Получает значение присоединенного свойства ShowDuration для объекта.Gets the value of the ShowDuration attached property for an object.

GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject)

Получает значение присоединенного свойства ShowOnDisabled для объекта.Gets the value of the ShowOnDisabled attached property for an object.

GetToolTip(DependencyObject) GetToolTip(DependencyObject) GetToolTip(DependencyObject) GetToolTip(DependencyObject)

Получает значение присоединенного свойства ToolTip для объекта.Gets the value of the ToolTip attached property for an object.

GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject)

Получает значение присоединенного свойства VerticalOffset для объекта.Gets the value of the VerticalOffset attached property for an object.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Удаляет обработчик для вложенного события ToolTipClosing.Removes a handler for the ToolTipClosing attached event.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Удаляет обработчик для вложенного события ToolTipOpening.Removes a handler for the ToolTipOpening attached event.

SetBetweenShowDelay(DependencyObject, Int32) SetBetweenShowDelay(DependencyObject, Int32) SetBetweenShowDelay(DependencyObject, Int32) SetBetweenShowDelay(DependencyObject, Int32)

Задает значение присоединенного свойства BetweenShowDelay для объекта.Sets the value of the BetweenShowDelay attached property for an object.

SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean)

Задает значение присоединенного свойства HasDropShadow для объекта.Sets the value of the HasDropShadow attached property for an object.

SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double)

Задает значение присоединенного свойства HorizontalOffset для объекта.Sets the value of the HorizontalOffset attached property for an object.

SetInitialShowDelay(DependencyObject, Int32) SetInitialShowDelay(DependencyObject, Int32) SetInitialShowDelay(DependencyObject, Int32) SetInitialShowDelay(DependencyObject, Int32)

Задает значение присоединенного свойства InitialShowDelay для объекта.Sets the value of the InitialShowDelay attached property for an object.

SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean)

Задает значение присоединенного свойства IsEnabled для объекта.Sets the value of the IsEnabled attached property for an object.

SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode)

Задает значение присоединенного свойства Placement для объекта.Sets the value of the Placement attached property for an object.

SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect)

Задает значение присоединенного свойства PlacementRectangle для объекта.Sets the value of the PlacementRectangle attached property for an object.

SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement)

Задает значение присоединенного свойства PlacementTarget для объекта.Sets the value of the PlacementTarget attached property for an object.

SetShowDuration(DependencyObject, Int32) SetShowDuration(DependencyObject, Int32) SetShowDuration(DependencyObject, Int32) SetShowDuration(DependencyObject, Int32)

Задает значение присоединенного свойства ShowDuration для объекта.Sets the value of the ShowDuration attached property for an object.

SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean)

Задает значение присоединенного свойства ShowOnDisabled для объекта.Sets the value of the ShowOnDisabled attached property for an object.

SetToolTip(DependencyObject, Object) SetToolTip(DependencyObject, Object) SetToolTip(DependencyObject, Object) SetToolTip(DependencyObject, Object)

Задает значение присоединенного свойства ToolTip для объекта.Sets the value of the ToolTip attached property for an object.

SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double)

Задает значение присоединенного свойства VerticalOffset для объекта.Sets the value of the VerticalOffset attached property for an object.

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

ToolTipClosing ToolTipClosing ToolTipClosing ToolTipClosing

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

ToolTipOpening ToolTipOpening ToolTipOpening ToolTipOpening

Возникает при открытии ToolTip.Occurs when the ToolTip opens.

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

Дополнительно