ToolTipService 클래스

참조

정의

네임스페이스:: Windows.UI.Xaml.Controls

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

편집

도구 설명을 표시하는 정적 메서드를 제공하는 서비스를 나타냅니다.

public ref class ToolTipService sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ToolTipService final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ToolTipService

Public NotInheritable Class ToolTipService

상속: Object Platform::Object IInspectable ToolTipService

특성: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

다음 코드 예제에서는 도구 설명의 배치 모드를 보여 줍니다.

<StackPanel Margin="120" >
    <TextBlock Text="ToolTip Control"/>
    <TextBlock Text="Hover over an item to see its ToolTip: " Margin="0,10"/>
    <ListBox Width="100" HorizontalAlignment="Left">
        <ListBoxItem Content="Left" 
            ToolTipService.ToolTip="ToolTip to the left." 
            ToolTipService.Placement="Left" />
        <ListBoxItem Content="Right" 
            ToolTipService.ToolTip="ToolTip to the right." 
            ToolTipService.Placement="Right" />
        <ListBoxItem Content="Top" 
            ToolTipService.ToolTip="ToolTip at the top." 
            ToolTipService.Placement="Top" />
        <ListBoxItem Content="Bottom" 
            ToolTipService.ToolTip="ToolTip at the bottom." 
            ToolTipService.Placement="Bottom"/>
        <ListBoxItem Content="Mouse" 
            ToolTipService.ToolTip="ToolTip based on the cursor position." 
            ToolTipService.Placement="Mouse"/>
    </ListBox>
</StackPanel>

설명

ToolTip은 소유자인 다른 UI 요소에 할당되어야 합니다. XAML(Extensible Application Markup Language)에서 ToolTipService.ToolTip 연결된 속성을 사용하여 도구 설명을 소유자에게 할당합니다. 코드에서 ToolTipService.SetToolTip 메서드를 사용하여 도구 설명을 소유자에게 할당합니다.

배치

기본적으로 도구 설명 은 포인터 위에 가운데에 표시됩니다. 배치는 앱 창에 의해 제한되지 않으므로 도구 설명 이 앱 창 범위의 일부 또는 완전히 외부에 표시될 수 있습니다.

도구 설명이 참조하는 콘텐츠를 가리는 경우 해당 배치를 조정할 수 있습니다. ToolTipService.Placement 연결된 속성을 사용하여 도구 설명을 포인터의 위, 아래, 왼쪽 또는 오른쪽에 배치합니다.

명시적 PlacementTarget이 없는 경우 도구 설명의 배치 대상은 TooltipService.ToolTip 연결된 속성 값에 대한 값을 지정하는 요소입니다. 모든 Placement 값(연결된 속성 또는 명시적 ToolTip 요소의 특성)이 해당 대상에 적용됩니다.

이전 버전에 대한 참고 사항

Windows 8.x도구 설명 은 Windows에서만 사용할 수 있습니다. 도구 설명 형식은 범용 프로젝트 템플릿과의 호환성을 위해 Windows Phone 프로젝트에서 사용할 수 있지만 도구 설명은 Windows Phone UI에 표시되지 않습니다.

도구 설명 은 앱 창의 범위 내에만 표시됩니다. 이러한 범위 내에서 유지하도록 배치를 조정할 수 있습니다.

XAML 연결 속성

ToolTipService는 여러 XAML 연결 속성에 대한 호스트 서비스 클래스입니다.

연결된 속성에 대한 XAML 프로세서 액세스를 지원하고 동등한 get 및 set 작업을 코드에 노출하기 위해 연결된 각 XAML 속성에는 Get 및 Set 접근자 메서드 쌍이 있습니다. 코드에서 값을 얻거나 설정하는 또 다른 방법은 종속성 속성 시스템을 사용하여 GetValue 또는 SetValue 를 호출하고 식별자 필드를 종속성 속성 식별자로 전달하는 것입니다.

연결된 속성	설명
배치	배치 대상과 관련하여 가 `ToolTip` 배치되는 방식을 나타내는 값을 가져오거나 설정합니다.
PlacementTarget	가 배치되는 `ToolTip` 상대 개체를 가져오거나 설정합니다.
ToolTip	요소 `ToolTip`의 개체 또는 문자열 콘텐츠를 가져오거나 설정합니다.

속성

PlacementProperty	ToolTipService.Placement XAML 연결된 속성을 식별합니다.
PlacementTargetProperty	ToolTipService.PlacementTarget XAML 연결 속성을 식별합니다.
ToolTipProperty	ToolTipService.ToolTip XAML 연결된 속성을 식별합니다.

연결된 속성

Placement	배치 대상과 관련하여 도구 설명이 배치되는 방식을 나타내는 값을 가져오거나 설정합니다.
PlacementTarget	도구 설명이 배치되는 상대 개체를 가져오거나 설정합니다.
ToolTip	요소 도구 설명의 개체 또는 문자열 콘텐츠를 가져오거나 설정합니다.

메서드

GetPlacement(DependencyObject)	지정된 대상 요소에 대한 ToolTipService.Placement XAML 연결 속성 값을 가져옵니다.
GetPlacementTarget(DependencyObject)	지정된 대상 요소에 대한 ToolTipService.PlacementTarget XAML 연결된 속성 값을 가져옵니다.
GetToolTip(DependencyObject)	개체에 대한 ToolTipService.ToolTip XAML 연결된 속성의 값을 가져옵니다.
SetPlacement(DependencyObject, PlacementMode)	지정된 대상 요소에 대한 ToolTipService.Placement XAML 연결된 속성 값을 설정합니다.
SetPlacementTarget(DependencyObject, UIElement)	지정된 대상 요소에 대한 ToolTipService.PlacementTarget XAML 연결된 속성 값을 설정합니다.
SetToolTip(DependencyObject, Object)	ToolTipService.ToolTip XAML 연결된 속성의 값을 설정합니다.

적용 대상