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. Если заданы ToolTipService эквивалентные ToolTip свойства и, ToolTipService свойство имеет приоритет.If equivalent ToolTip and ToolTipService properties are both set, the ToolTipService property takes precedence. Например, если ToolTip.Placement для System.Windows.Controls.ToolTip объекта заданы ToolTipService.Placement и свойство, и свойство, используется значение 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, иVerticalOffset ведут себя аналогично свойствам с тем же именем в классе.Popup HorizontalOffsetPlacement, 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.

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

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