ToolTipService Classe

  • Referência

Definição

Namespace:
System.Windows.Controls
Assembly:
PresentationFramework.dll

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