ToolTipService Classe

  • Referência

Definição

Namespace:
Windows.UI.Xaml.Controls
Editar

Representa um serviço que fornece métodos estáticos para exibir uma Dica de Ferramenta.

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
Herança
Object Platform::Object IInspectable ToolTipService
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo de código a seguir demonstra os modos de posicionamento de uma Dica de Ferramenta.

<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>

Comentários

Uma ToolTip deve ser atribuída a outro elemento de interface do usuário que é seu proprietário. Em XAML (Extensible Application Markup Language), use a propriedade anexada ToolTipService.ToolTip para atribuir a Dica de Ferramenta a um proprietário. No código, use o método ToolTipService.SetToolTip para atribuir a Dica de Ferramenta a um proprietário.

Posicionamento

Por padrão, uma Dica de Ferramenta é exibida centralizada acima do ponteiro. O posicionamento não é restrito pela janela do aplicativo, portanto, a Dica de Ferramenta pode ser exibida parcial ou completamente fora dos limites da janela do aplicativo.

Se uma Dica de Ferramenta obscurecer o conteúdo ao qual está se referindo, você poderá ajustar seu posicionamento. Use a propriedade anexada ToolTipService.Placement para colocar a Dica de Ferramenta acima, abaixo, à esquerda ou à direita do ponteiro.

Se não houver PlacementTarget explícito, o destino de posicionamento de uma dica de ferramenta será o elemento que especifica um valor para o valor da propriedade anexada TooltipService.ToolTip. Qualquer valor placement (como uma propriedade anexada ou como um atributo em um elemento ToolTip explícito) aplica-se a esse destino.

Observações para versões anteriores

A Dica de Ferramenta do Windows 8.x destina-se apenas ao uso no Windows. O tipo ToolTip está disponível em projetos Windows Phone para compatibilidade com modelos de projeto universais, mas a Dica de Ferramenta não é mostrada na interface do usuário do Windows Phone.

ToolTip é exibida somente dentro dos limites da janela do aplicativo. Seu posicionamento pode ser ajustado para permanecer dentro desses limites.

Propriedades anexadas de XAML

ToolTipService é a classe de serviço de host para várias propriedades anexadas XAML.

Para dar suporte ao acesso do processador XAML às propriedades anexadas e também para expor operações de get e set equivalentes ao código, cada propriedade anexada XAML tem um par de métodos de acessador Get e Set. Outra maneira de obter ou definir o valor no código é usar o sistema de propriedades de dependência, chamando GetValue ou SetValue e passando o campo identificador como o identificador da propriedade de dependência.

Propriedade anexada Descrição
Posicionamento Obtém ou define um valor que indica como um ToolTip é posicionado em relação ao destino de posicionamento.
Placementtarget Obtém ou define o objeto relativo ao qual um ToolTip está posicionado.
ToolTip Obtém ou define o conteúdo do objeto ou da cadeia de caracteres de ToolTipum elemento .

Propriedades

PlacementProperty

Identifica a propriedade anexada XAML ToolTipService.Placement .
PlacementTargetProperty

Identifica a propriedade anexada XAML ToolTipService.PlacementTarget .
ToolTipProperty

Identifica a propriedade XAML ToolTipService.ToolTip anexada.

Propriedades Anexadas

Placement

Obtém ou define um valor que indica como uma Dica de Ferramenta é posicionada em relação ao destino de posicionamento.
PlacementTarget

Obtém ou define o objeto relativo ao qual uma dica de ferramenta está posicionada.
ToolTip

Obtém ou define o conteúdo de objeto ou cadeia de caracteres da Dica de Ferramenta de um elemento.

Métodos

GetPlacement(DependencyObject)

Obtém o valor da propriedade anexada XAML ToolTipService.Placement para o elemento de destino especificado.
GetPlacementTarget(DependencyObject)

Obtém o valor da propriedade anexada XAML ToolTipService.PlacementTarget para o elemento de destino especificado.
GetToolTip(DependencyObject)

Obtém o valor da propriedade XAML ToolTipService.ToolTip anexada para um objeto .
SetPlacement(DependencyObject, PlacementMode)

Define o valor da propriedade anexada XAML ToolTipService.Placement para o elemento de destino especificado.
SetPlacementTarget(DependencyObject, UIElement)

Define o valor da propriedade anexada XAML ToolTipService.PlacementTarget para o elemento de destino especificado.
SetToolTip(DependencyObject, Object)

Define o valor da propriedade XAML ToolTipService.ToolTip anexada.

Aplica-se a

Confira também