ToolTipService Classe

Definição

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

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.

Propriedades

Propriedades Anexadas

Métodos

Aplica-se a

Confira também

• ToolTip
• Como adicionar uma dica de ferramenta
• Exemplo de controles essenciais XAML