이 설명서는 보관되지만 유지 되지 않습니다.

ToolTipService 클래스

업데이트: 2007년 11월

도구 설명의 표시 및 동작을 제어하는 속성과 이벤트를 제공하는 서비스를 나타냅니다.

네임스페이스:  System.Windows.Controls
어셈블리:  PresentationFramework(PresentationFramework.dll)

public static class ToolTipService
public final class ToolTipService
public final class ToolTipService
이 클래스의 인스턴스는 XAML에서 직접 만들 수 없습니다.

FrameworkContentElement.ToolTip 또는 FrameworkElement.ToolTip 속성을 설정하여 요소에 대한 도구 설명을 정의합니다. 도구 설명 속성에는 자식 요소가 하나 있습니다. 자식의 콘텐츠는 단순 텍스트 문자열일 수도 있고, 텍스트 및 Image 요소가 포함된 StackPanel과 같은 복잡한 콘텐츠일 수도 있습니다.

도구 설명 콘텐츠는 ToolTip 개체로 정의할 수 있지만 이렇게 하지 않을 수도 있습니다. 도구 설명 콘텐츠를 ToolTip 개체로 정의하지 않는 경우 ToolTipService 속성을 사용하여 도구 설명 콘텐츠를 배치하고 사용자 지정할 수 있습니다. ToolTipService 클래스에 연결된 속성을 사용하여 도구 설명의 위치, 동작 및 모양을 결정할 수 있습니다. 이러한 속성은 도구 설명을 정의하는 요소에 설정합니다.

ToolTip 클래스와 ToolTipService 클래스는 도구 설명을 사용자 지정하는 데 사용되는 여러 가지 동일한 속성을 공유합니다. ToolTipToolTipService에서 같은 속성을 동시에 설정하면 ToolTipService 속성이 우선합니다. 예를 들어 System.Windows.Controls.ToolTip 개체에 대해 ToolTip.Placement 속성과 ToolTipService.Placement 속성을 동시에 설정하면 ToolTipService.Placement 속성 값이 사용됩니다.

다음과 같은 ToolTipService 타이밍 속성은 ToolTipService 클래스에만 정의되며 모든 도구 설명에 사용됩니다.

도구 설명이 열리거나 닫힐 때 발생하는 이벤트를 처리하는 방법에 대한 자세한 내용은 ToolTipOpeningEventToolTipClosingEvent 필드를 참조하십시오.

Placement, PlacementRectangle, PlacementTarget, HorizontalOffsetVerticalOffset의 동작은 Popup 클래스에 있는 같은 이름의 속성과 비슷합니다. 자세한 내용은 Popup 배치 동작을 참조하십시오.

다음 예제에서는 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>



추가 코드

방법: 도구 설명 배치이 예제에서는 화면에서 도구 설명 위치를 지정하는 방법을 보여 줍니다.
방법: BetweenShowDelay 속성 사용이 예제에서는 BetweenShowDelay 시간 속성을 사용하여 사용자가 한 도구 설명에서 다른 도구 설명으로 마우스 포인터를 이동할 때 지연 없이 도구 설명이 빠르게 나타나도록 설정하는 방법을 보여 줍니다.

System.Object
  System.Windows.Controls.ToolTipService

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

Windows Vista

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

.NET Framework

3.5, 3.0에서 지원
표시: