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


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
Атрибуты

Требования к 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>

Комментарии

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

Размещение

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

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

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

Примечания для предыдущих версий

ПодсказкаWindows 8.x предназначена только для использования в Windows. Тип подсказки доступен в Windows Phone проектах для совместимости с универсальными шаблонами проектов, но подсказка не отображается в пользовательском интерфейсе Windows Phone.

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

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

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

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

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

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

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