Partilhar via


ToolTipService Classe

Definição

Representa um serviço que fornece propriedades e eventos para controlar a exibição e o comportamento de dicas de ferramentas.

public ref class ToolTipService abstract sealed
public static class ToolTipService
type ToolTipService = class
Public Class ToolTipService
Herança
ToolTipService

Exemplos

O exemplo a seguir mostra como usar a ToolTipService classe para especificar o comportamento de uma dica de ferramenta. Defina as propriedades da ToolTipService classe anexando-as diretamente ao elemento que expõe a dica de ferramenta.

<Ellipse Height="25" Width="50" 
      Fill="Gray" 
      HorizontalAlignment="Left"
      ToolTipService.InitialShowDelay="1000"
      ToolTipService.ShowDuration="7000"
      ToolTipService.BetweenShowDelay="2000"
      ToolTipService.Placement="Right" 
      ToolTipService.PlacementRectangle="50,0,0,0"
      ToolTipService.HorizontalOffset="10" 
      ToolTipService.VerticalOffset="20"
      ToolTipService.HasDropShadow="false"
      ToolTipService.ShowOnDisabled="true" 
      ToolTipService.IsEnabled="true"
      ToolTipOpening="whenToolTipOpens"
      ToolTipClosing="whenToolTipCloses"
      >
  <Ellipse.ToolTip>
    <BulletDecorator>
      <BulletDecorator.Bullet>
        <Ellipse Height="10" Width="20" Fill="Blue"/>
      </BulletDecorator.Bullet>
      <TextBlock>Uses the ToolTipService class</TextBlock>
    </BulletDecorator>
  </Ellipse.ToolTip>
</Ellipse>

Comentários

Você define uma dica de ferramenta para um elemento definindo a FrameworkContentElement.ToolTip propriedade ou FrameworkElement.ToolTip . A propriedade ToolTip leva um filho. O conteúdo do filho pode variar de uma cadeia de caracteres de texto simples para um conteúdo mais complexo, como um StackPanel que tem texto e Image elementos inseridos.

Você pode definir o conteúdo da dica de ferramenta como um ToolTip objeto, mas isso não é necessário. Quando você não define o conteúdo da dica de ferramenta como um ToolTip objeto, pode usar as ToolTipService propriedades para posicionar e personalizar o conteúdo da dica de ferramenta. As propriedades anexadas da ToolTipService classe são usadas para determinar o posicionamento, o comportamento e a aparência de uma dica de ferramenta. Essas propriedades são definidas no elemento que define a dica de ferramenta.

A ToolTip classe e a ToolTipService classe compartilham muitas das mesmas propriedades usadas para personalizar uma dica de ferramenta. Se propriedades e ToolTipService equivalentes ToolTip forem definidas, a ToolTipService propriedade terá precedência. Por exemplo, se a ToolTip.Placement propriedade e a ToolTipService.Placement propriedade forem definidas para um System.Windows.Controls.ToolTip objeto, o valor da ToolTipService.Placement propriedade será usado.

As seguintes ToolTipService propriedades de tempo são definidas apenas para a ToolTipService classe e são usadas por todas as dicas de ferramenta:

Para obter informações sobre como lidar com os eventos que ocorrem quando a dica de ferramenta é aberta ou fechada, consulte os ToolTipOpeningEvent campos e ToolTipClosingEvent .

Placement, PlacementRectangle, PlacementTarget, HorizontalOffsete VerticalOffset se comportam de forma semelhante às propriedades do mesmo nome na Popup classe . Para mais informações, consulte Comportamento de posicionamento de pop-up.

Campos

BetweenShowDelayProperty

Identifica a propriedade BetweenShowDelay anexada.

HasDropShadowProperty

Identifica a propriedade HasDropShadow anexada.

HorizontalOffsetProperty

Identifica a propriedade HorizontalOffset anexada.

InitialShowDelayProperty

Identifica a propriedade InitialShowDelay anexada.

IsEnabledProperty

Identifica a propriedade IsEnabled anexada.

IsOpenProperty

Identifica a propriedade IsOpen anexada.

PlacementProperty

Identifica a propriedade Placement anexada.

PlacementRectangleProperty

Identifica a propriedade PlacementRectangle anexada.

PlacementTargetProperty

Identifica a propriedade PlacementTarget anexada.

ShowDurationProperty

Identifica a propriedade ShowDuration anexada.

ShowOnDisabledProperty

Identifica a propriedade ShowOnDisabled anexada.

ShowsToolTipOnKeyboardFocusProperty

Representa um serviço que fornece propriedades e eventos para controlar a exibição e o comportamento de dicas de ferramentas.

ToolTipClosingEvent

Identifica o evento ToolTipClosing exposto por objetos que usam o serviço ToolTipService para exibir dicas de ferramenta.

ToolTipOpeningEvent

Identifica o evento ToolTipOpening exposto por objetos que usam o serviço ToolTipService para exibir dicas de ferramenta.

ToolTipProperty

Identifica a propriedade ToolTip anexada.

VerticalOffsetProperty

Identifica a propriedade VerticalOffset anexada.

Propriedades Anexadas

BetweenShowDelay

Obtém ou define o tempo máximo entre a exibição de duas dicas de ferramenta, em que a segunda dica de ferramenta aparece sem atraso.

HasDropShadow

Obtém ou define se a dica de ferramenta exibe um efeito de sombra.

HorizontalOffset

Obtém ou define o deslocamento da esquerda da área especificada para a dica de ferramenta pelas propriedades PlacementRectangle e PlacementTarget.

InitialShowDelay

Obtém ou define o período de tempo antes que uma dica de ferramenta é aberta.

IsEnabled

Obtém ou define se uma dica de ferramenta é exibida.

IsOpen

Identifica se uma dica de ferramenta está visível no momento.

Placement

Obtém ou define a orientação da dica de ferramenta quando ela é aberta e especifica como a dica de ferramenta se comporta quando sobrepõe os limites da tela.

PlacementRectangle

Obtém ou define a área retangular em relação à qual a dica de ferramenta é posicionada.

PlacementTarget

Obtém ou define o objeto em relação ao qual a dica de ferramenta é posicionada.

ShowDuration

Obtém ou define a quantidade de tempo que uma dica de ferramenta permanece visível.

ShowOnDisabled

Obtém ou define se uma dica de ferramenta é exibida para um objeto que não está habilitado.

ShowsToolTipOnKeyboardFocus

Representa um serviço que fornece propriedades e eventos para controlar a exibição e o comportamento de dicas de ferramentas.

ToolTip

Obtém ou define o conteúdo de uma dica de ferramenta.

VerticalOffset

Obtém ou define a distância da parte superior da área especificada para a dica de ferramenta pelas propriedades PlacementRectangle e PlacementTarget.

Métodos

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Adiciona um manipulador ao evento anexado ToolTipClosing.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Adiciona um manipulador ao evento anexado ToolTipOpening.

GetBetweenShowDelay(DependencyObject)

Obtém o valor da propriedade anexada BetweenShowDelay de um objeto.

GetHasDropShadow(DependencyObject)

Obtém o valor da propriedade anexada HasDropShadow de um objeto.

GetHorizontalOffset(DependencyObject)

Obtém o valor da propriedade anexada HorizontalOffset de um objeto.

GetInitialShowDelay(DependencyObject)

Obtém o valor da propriedade anexada InitialShowDelay de um objeto.

GetIsEnabled(DependencyObject)

Obtém o valor da propriedade anexada IsEnabled de um objeto.

GetIsOpen(DependencyObject)

Obtém o valor da propriedade anexada IsOpen de um objeto.

GetPlacement(DependencyObject)

Obtém o valor da propriedade anexada Placement de um objeto.

GetPlacementRectangle(DependencyObject)

Obtém o valor da propriedade anexada PlacementRectangle de um objeto.

GetPlacementTarget(DependencyObject)

Obtém o valor da propriedade anexada PlacementTarget de um objeto.

GetShowDuration(DependencyObject)

Obtém o valor da propriedade anexada ShowDuration de um objeto.

GetShowOnDisabled(DependencyObject)

Obtém o valor da propriedade anexada ShowOnDisabled de um objeto.

GetShowsToolTipOnKeyboardFocus(DependencyObject)

Representa um serviço que fornece propriedades e eventos para controlar a exibição e o comportamento de dicas de ferramentas.

GetToolTip(DependencyObject)

Obtém o valor da propriedade anexada ToolTip de um objeto.

GetVerticalOffset(DependencyObject)

Obtém o valor da propriedade anexada VerticalOffset de um objeto.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Remove um manipulador para o evento anexado ToolTipClosing.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Remove um manipulador para o evento anexado ToolTipOpening.

SetBetweenShowDelay(DependencyObject, Int32)

Define o valor da propriedade anexada BetweenShowDelay de um objeto.

SetHasDropShadow(DependencyObject, Boolean)

Define o valor da propriedade anexada HasDropShadow de um objeto.

SetHorizontalOffset(DependencyObject, Double)

Define o valor da propriedade anexada HorizontalOffset de um objeto.

SetInitialShowDelay(DependencyObject, Int32)

Define o valor da propriedade anexada InitialShowDelay de um objeto.

SetIsEnabled(DependencyObject, Boolean)

Define o valor da propriedade anexada IsEnabled de um objeto.

SetPlacement(DependencyObject, PlacementMode)

Define o valor da propriedade anexada Placement de um objeto.

SetPlacementRectangle(DependencyObject, Rect)

Define o valor da propriedade anexada PlacementRectangle de um objeto.

SetPlacementTarget(DependencyObject, UIElement)

Define o valor da propriedade anexada PlacementTarget de um objeto.

SetShowDuration(DependencyObject, Int32)

Define o valor da propriedade anexada ShowDuration de um objeto.

SetShowOnDisabled(DependencyObject, Boolean)

Define o valor da propriedade anexada ShowOnDisabled de um objeto.

SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>)

Representa um serviço que fornece propriedades e eventos para controlar a exibição e o comportamento de dicas de ferramentas.

SetToolTip(DependencyObject, Object)

Define o valor da propriedade anexada ToolTip de um objeto.

SetVerticalOffset(DependencyObject, Double)

Define o valor da propriedade anexada VerticalOffset de um objeto.

Eventos Anexados

ToolTipClosing

Ocorre quando o ToolTip é fechado.

ToolTipOpening

Ocorre quando o ToolTip é aberto.

Aplica-se a

Confira também