ToolTipService 클래스

정의

도구 설명의 표시 및 동작을 제어할 속성과 이벤트를 제공하는 서비스를 나타냅니다.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
상속
ToolTipService

예제

다음 예제에서는 클래스를 사용 하 여 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. 자세한 내용은 Popup 배치 동작을 참조하세요.For more information, see Popup Placement Behavior.

필드

BetweenShowDelayProperty

BetweenShowDelay 연결된 속성을 식별합니다.Identifies the BetweenShowDelay attached property.

HasDropShadowProperty

HasDropShadow 연결된 속성을 식별합니다.Identifies the HasDropShadow attached property.

HorizontalOffsetProperty

HorizontalOffset 연결된 속성을 식별합니다.Identifies the HorizontalOffset attached property.

InitialShowDelayProperty

InitialShowDelay 연결된 속성을 식별합니다.Identifies the InitialShowDelay attached property.

IsEnabledProperty

IsEnabled 연결된 속성을 식별합니다.Identifies the IsEnabled attached property.

IsOpenProperty

IsOpen 연결된 속성을 식별합니다.Identifies the IsOpen attached property.

PlacementProperty

Placement 연결된 속성을 식별합니다.Identifies the Placement attached property.

PlacementRectangleProperty

PlacementRectangle 연결된 속성을 식별합니다.Identifies the PlacementRectangle attached property.

PlacementTargetProperty

PlacementTarget 연결된 속성을 식별합니다.Identifies the PlacementTarget attached property.

ShowDurationProperty

ShowDuration 연결된 속성을 식별합니다.Identifies the ShowDuration attached property.

ShowOnDisabledProperty

ShowOnDisabled 연결된 속성을 식별합니다.Identifies the ShowOnDisabled attached property.

ToolTipClosingEvent

ToolTipClosing 서비스를 사용하여 도구 설명을 표시하는 개체가 노출하는 ToolTipService 이벤트를 식별합니다.Identifies the ToolTipClosing event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipOpeningEvent

ToolTipOpening 서비스를 사용하여 도구 설명을 표시하는 개체가 노출하는 ToolTipService 이벤트를 식별합니다.Identifies the ToolTipOpening event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipProperty

ToolTip 연결된 속성을 식별합니다.Identifies the ToolTip attached property.

VerticalOffsetProperty

VerticalOffset 연결된 속성을 식별합니다.Identifies the VerticalOffset attached property.

연결된 속성

BetweenShowDelay

두 번째 도구 설명이 지연 없이 나타나는 두 개의 도구 설명 표시 사이의 최대 시간을 가져오거나 설정합니다.Gets or sets the maximum time between the display of two tooltips where the second tooltip appears without a delay.

HasDropShadow

도구 설명에 그림자 효과를 표시할지 여부를 가져오거나 설정합니다.Gets or sets whether the tooltip displays a drop shadow effect.

HorizontalOffset

PlacementRectanglePlacementTarget 속성에서 도구 설명에 대해 지정한 영역의 왼쪽에서 오프셋을 가져오거나 설정합니다.Gets or sets the offset from the left of the area that is specified for the tooltip by the PlacementRectangle and PlacementTarget properties.

InitialShowDelay

도구 설명이 열리기 전의 시간 길이를 가져오거나 설정합니다.Gets or sets the length of time before a tooltip opens.

IsEnabled

도구 설명이 나타나는지 여부를 가져오거나 설정합니다.Gets or sets whether a tooltip appears.

IsOpen

도구 설명이 현재 표시되는지 여부를 가져옵니다.Gets whether a tooltip is currently visible.

Placement

도구 설명이 열리는 방향을 가져오거나 설정하고 도구 설명이 화면 경계와 겹칠 때의 동작을 지정합니다.Gets or sets the orientation of the tooltip when it opens, and specifies how the tooltip behaves when it overlaps screen boundaries.

PlacementRectangle

도구 설명 위치의 기준이 되는 사각형 영역을 가져오거나 설정합니다.Gets or sets the rectangular area relative to which the tooltip is positioned.

PlacementTarget

도구 설명 위치의 기준이 되는 개체를 가져오거나 설정합니다.Gets or sets the object relative to which the tooltip is positioned.

ShowDuration

도구 설명이 표시된 상태로 유지되는 시간을 가져오거나 설정합니다.Gets or sets the amount of time that a tooltip remains visible.

ShowOnDisabled

사용할 수 없는 개체에 대한 도구 설명을 표시할지 여부를 가져오거나 설정합니다.Gets or sets whether a tooltip appears for an object that is not enabled.

ToolTip

도구 설명의 내용을 가져오거나 설정합니다.Gets or sets the content of a tooltip.

VerticalOffset

도구 설명에서 PlacementRectanglePlacementTarget 속성으로 지정된 영역의 위쪽에서 떨어진 거리를 가져오거나 설정합니다.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)

ToolTipClosing 연결된 이벤트에 대한 처리기를 추가합니다.Adds a handler for the ToolTipClosing attached event.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

ToolTipOpening 연결된 이벤트에 대한 처리기를 추가합니다.Adds a handler for the ToolTipOpening attached event.

GetBetweenShowDelay(DependencyObject)

개체의 BetweenShowDelay 연결된 속성 값을 가져옵니다.Gets the value of the BetweenShowDelay attached property for an object.

GetHasDropShadow(DependencyObject)

개체의 HasDropShadow 연결된 속성 값을 가져옵니다.Gets the value of the HasDropShadow attached property for an object.

GetHorizontalOffset(DependencyObject)

개체의 HorizontalOffset 연결된 속성 값을 가져옵니다.Gets the value of the HorizontalOffset attached property for an object.

GetInitialShowDelay(DependencyObject)

개체의 InitialShowDelay 연결된 속성 값을 가져옵니다.Gets the value of the InitialShowDelay attached property for an object.

GetIsEnabled(DependencyObject)

개체의 IsEnabled 연결된 속성 값을 가져옵니다.Gets the value of the IsEnabled attached property for an object.

GetIsOpen(DependencyObject)

개체의 IsOpen 연결된 속성 값을 가져옵니다.Gets the value of the IsOpen attached property for an object.

GetPlacement(DependencyObject)

개체의 Placement 연결된 속성 값을 가져옵니다.Gets the value of the Placement attached property for an object.

GetPlacementRectangle(DependencyObject)

개체의 PlacementRectangle 연결된 속성 값을 가져옵니다.Gets the value of the PlacementRectangle attached property for an object.

GetPlacementTarget(DependencyObject)

개체의 PlacementTarget 연결된 속성 값을 가져옵니다.Gets the value of the PlacementTarget attached property for an object.

GetShowDuration(DependencyObject)

개체의 ShowDuration 연결된 속성 값을 가져옵니다.Gets the value of the ShowDuration attached property for an object.

GetShowOnDisabled(DependencyObject)

개체의 ShowOnDisabled 연결된 속성 값을 가져옵니다.Gets the value of the ShowOnDisabled attached property for an object.

GetToolTip(DependencyObject)

개체의 ToolTip 연결된 속성 값을 가져옵니다.Gets the value of the ToolTip attached property for an object.

GetVerticalOffset(DependencyObject)

개체의 VerticalOffset 연결된 속성 값을 가져옵니다.Gets the value of the VerticalOffset attached property for an object.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

ToolTipClosing 연결된 이벤트에 대한 처리기를 제거합니다.Removes a handler for the ToolTipClosing attached event.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

ToolTipOpening 연결된 이벤트에 대한 처리기를 제거합니다.Removes a handler for the ToolTipOpening attached event.

SetBetweenShowDelay(DependencyObject, Int32)

개체의 BetweenShowDelay 연결된 속성 값을 설정합니다.Sets the value of the BetweenShowDelay attached property for an object.

SetHasDropShadow(DependencyObject, Boolean)

개체의 HasDropShadow 연결된 속성 값을 설정합니다.Sets the value of the HasDropShadow attached property for an object.

SetHorizontalOffset(DependencyObject, Double)

개체의 HorizontalOffset 연결된 속성 값을 설정합니다.Sets the value of the HorizontalOffset attached property for an object.

SetInitialShowDelay(DependencyObject, Int32)

개체의 InitialShowDelay 연결된 속성 값을 설정합니다.Sets the value of the InitialShowDelay attached property for an object.

SetIsEnabled(DependencyObject, Boolean)

개체의 IsEnabled 연결된 속성 값을 설정합니다.Sets the value of the IsEnabled attached property for an object.

SetPlacement(DependencyObject, PlacementMode)

개체의 Placement 연결된 속성 값을 설정합니다.Sets the value of the Placement attached property for an object.

SetPlacementRectangle(DependencyObject, Rect)

개체의 PlacementRectangle 연결된 속성 값을 설정합니다.Sets the value of the PlacementRectangle attached property for an object.

SetPlacementTarget(DependencyObject, UIElement)

개체의 PlacementTarget 연결된 속성 값을 설정합니다.Sets the value of the PlacementTarget attached property for an object.

SetShowDuration(DependencyObject, Int32)

개체의 ShowDuration 연결된 속성 값을 설정합니다.Sets the value of the ShowDuration attached property for an object.

SetShowOnDisabled(DependencyObject, Boolean)

개체의 ShowOnDisabled 연결된 속성 값을 설정합니다.Sets the value of the ShowOnDisabled attached property for an object.

SetToolTip(DependencyObject, Object)

개체의 ToolTip 연결된 속성 값을 설정합니다.Sets the value of the ToolTip attached property for an object.

SetVerticalOffset(DependencyObject, Double)

개체의 VerticalOffset 연결된 속성 값을 설정합니다.Sets the value of the VerticalOffset attached property for an object.

연결된 이벤트

ToolTipClosing

ToolTip이 닫히면 발생합니다.Occurs when the ToolTip closes.

ToolTipOpening

ToolTip가 열리면 발생합니다.Occurs when the ToolTip opens.

적용 대상

추가 정보