ToolTipService クラス

定義

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 の要件

例

次のコード例は、 ツールヒントの配置モードを示しています。

<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 要素に割り当てる必要があります。 Extensible Application Markup Language (XAML) で、ToolTipService.ToolTip 添付プロパティを使用して 、ツールヒント を所有者に割り当てます。 コードでは、 ToolTipService.SetToolTip メソッドを使用して、 ツールヒント を所有者に割り当てます。

配置

既定では、 ツールヒント はポインターの上の中央に表示されます。 配置はアプリ ウィンドウによって制限されないため、 ツールヒント がアプリ ウィンドウの境界の一部または完全に外側に表示される可能性があります。

ツールヒントで参照しているコンテンツが隠れている場合は、その配置を調整できます。 ToolTipService.Placement 添付プロパティを使用して、ポインターの上、下、左、または右に ツールヒント を配置します。

PlacementTarget が明示的に存在しない場合、ツールヒントの配置ターゲットは、TooltipService.ToolTip 添付プロパティ値の値を指定する要素です。 配置値 (添付プロパティとして、または明示的な ToolTip 要素の属性として) は、そのターゲットに適用されます。

以前のバージョンのメモ

Windows 8.xツールヒント は、Windows でのみ使用することを目的としています。 ツールヒントの種類は、ユニバーサル プロジェクト テンプレートとの互換性のためにWindows Phone プロジェクトで使用できますが、ツールヒントはWindows Phone UI に表示されません。

ツールヒント は、アプリ ウィンドウの境界内にのみ表示されます。 配置は、これらの境界内に留まるように調整される場合があります。

XAML 添付プロパティ

ToolTipService は、 いくつかの XAML 添付プロパティのホスト サービス クラスです。

アタッチされたプロパティへの XAML プロセッサ アクセスをサポートし、同等の get 操作と set 操作をコードに公開するために、各 XAML 添付プロパティには Get メソッドと Set アクセサー メソッドのペアがあります。 コードで値を取得または設定するもう 1 つの方法は、依存関係プロパティ システムを使用して GetValue または SetValue を呼び出し、識別子フィールドを依存関係プロパティ識別子として渡すことです。

プロパティ

添付プロパティ

メソッド

適用対象

こちらもご覧ください

• ToolTip
• ヒントを追加する方法
• XAML の重要なコントロールのサンプル