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>

Подсказку необходимо назначить другому элементу пользовательского интерфейса, являющемуся ее владельцем. В XAML используйте присоединенное свойство ToolTipService.ToolTip, чтобы назначить подсказку владельцу. В коде используйте метод ToolTipService.SetToolTip , чтобы назначить подсказку владельцу.

Размещение

По умолчанию подсказка отображается по центру над указателем. Размещение не ограничивается окном приложения, поэтому подсказка может отображаться частично или полностью за пределами окна приложения.

Если подсказка скрывает содержимое, на который она ссылается, можно настроить ее размещение. Используйте присоединенное свойство ToolTipService.Placement, чтобы разместить подсказку над, под, слева или справа от указателя.

Если явно отсутствует PlacementTarget, целевым объектом размещения для подсказки является элемент, указывающий значение для его присоединенного свойства TooltipService.ToolTip. Любое значение Размещения (как присоединенное свойство или атрибут явного элемента ToolTip) применяется к такому целевому объекту.

Присоединенные свойства XAML

ToolTipService — это класс службы узла для нескольких присоединенных свойств XAML.

Для поддержки доступа обработчика XAML к присоединенным свойствам, а также для предоставления коду эквивалентных операций получения и задания , каждое присоединенное свойство XAML имеет пару методов доступа Get и Set. Другой способ получить или задать значение в коде — использовать систему свойств зависимостей, вызывая GetValue или SetValue и передавая поле идентификатора в качестве идентификатора свойства зависимостей.

Присоединенное свойство	Описание
Размещение	Возвращает или задает значение, указывающее, как подсказка располагается относительно целевого объекта размещения. Тип: PlacementMode Поле идентификатора: PlacementProperty Методы доступа: GetPlacement, SetPlacement
PlacementTarget	Возвращает или задает объект, относительно которого располагается подсказка. Тип: UIElement Поле идентификатора: PlacementTargetProperty Методы accessor: GetPlacementTarget, SetPlacementTarget
ToolTip	Возвращает или задает содержимое объекта или строки подсказки элемента. Тип: object Поле идентификатора: ToolTipProperty Методы метода доступа: GetToolTip, SetToolTip

Свойства

PlacementProperty	Определяет присоединенное свойство XAML ToolTipService.Placement .
PlacementTargetProperty	Определяет присоединенное свойство XAML ToolTipService.PlacementTarget .
ToolTipProperty	Определяет присоединенное свойство XAML ToolTipService.Tooltip .

Присоединенные свойства

Placement	Возвращает или задает значение, указывающее, как подсказка располагается относительно целевого объекта размещения.
PlacementTarget	Возвращает или задает объект, относительно которого располагается подсказка.
ToolTip	Возвращает или задает содержимое объекта или строки подсказки элемента.

Методы

GetPlacement(DependencyObject)	Возвращает значение присоединенного свойства XAML ToolTipService.Placement для указанного целевого элемента.
GetPlacementTarget(DependencyObject)	Возвращает значение присоединенного свойства XAML ToolTipService.PlacementTarget для указанного целевого элемента.
GetToolTip(DependencyObject)	Возвращает значение присоединенного свойства XAML ToolTipService.ToolTip для объекта .
SetPlacement(DependencyObject, PlacementMode)	Задает значение присоединенного свойства XAML ToolTipService.Placement для указанного целевого элемента.
SetPlacementTarget(DependencyObject, UIElement)	Задает значение присоединенного свойства XAML ToolTipService.PlacementTarget для указанного целевого элемента.
SetToolTip(DependencyObject, Object)	Задает значение присоединенного свойства XAML ToolTipService.ToolTip .

Применяется к