ToolTipService 클래스

  • 참조

정의

네임스페이스:
Microsoft.UI.Xaml.Controls
편집

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

public ref class ToolTipService sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

예제

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

<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 요소의 특성)이 해당 대상에 적용됩니다.

XAML 연결 속성

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

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

연결된 속성 Description
배치 도구 설명이 배치 대상과 관련하여 배치되는 방식을 나타내는 값을 가져오거나 설정합니다.
PlacementTarget 도구 설명의 위치를 기준으로 개체를 가져오거나 설정합니다.
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 연결된 속성의 값을 설정합니다.

적용 대상

추가 정보