Поделиться через

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 и передавая поле идентификатора в качестве идентификатора свойства зависимостей.

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

Свойства

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 .

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

См. также раздел