ToolTipService Classe

Definição

Espaço de Nomes:
System.Windows.Controls
Assemblagem:
PresentationFramework.dll

Representa um serviço que fornece propriedades e eventos para controlar a visualização e o comportamento das dicas de ferramenta.

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

Exemplos

O exemplo seguinte mostra como usam a ToolTipService classe para especificar o comportamento de uma dica de ferramenta. Defines 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>

Observações

Defines uma dica de ferramenta para um elemento definindo a FrameworkContentElement.ToolTip propriedade ou.FrameworkElement.ToolTip A propriedade ToolTip aceita uma criança. O conteúdo do filho pode variar desde uma simples cadeia de texto até conteúdos mais complexos, como um StackPanel que tenha texto e Image elementos incorporados.

Podes definir conteúdo de tooltip como um ToolTip objeto, mas isso não é obrigatório. Quando não defines o conteúdo da tooltip como um ToolTip objeto, podes usar as ToolTipService propriedades para posicionar e personalizar o conteúdo da tooltip. As propriedades associadas da ToolTipService classe são usadas para determinar a colocação, comportamento e aparência de uma dica de ferramenta. Estas propriedades são definidas no elemento que define a dica de ferramenta.

A ToolTip classe e a ToolTipService classe partilham muitas das mesmas propriedades que são usadas para personalizar uma dica de ferramenta. Se equivalente ToolTip e ToolTipService propriedades forem ambas conjuntas, a ToolTipService propriedade tem precedência. Por exemplo, se tanto a propriedade ToolTip.Placement como a propriedade ToolTipService.Placement forem definidas para um objeto System.Windows.Controls.ToolTip, o valor da propriedade ToolTipService.Placement é utilizado.

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

Para informações sobre como lidar com os eventos que ocorrem quando a tooltip abre ou fecha, consulte os ToolTipOpeningEvent campos e.ToolTipClosingEvent

Placement, PlacementRectangle, PlacementTarget, HorizontalOffset, e VerticalOffset comportam-se de forma semelhante às propriedades do mesmo nome na Popup classe. Para mais informações, consulte Comportamento de Colocação de Popups.

Campos

Name Description
BetweenShowDelayProperty

Identifica a BetweenShowDelay propriedade anexada.
HasDropShadowProperty

Identifica a HasDropShadow propriedade anexada.
HorizontalOffsetProperty

Identifica a HorizontalOffset propriedade anexada.
InitialShowDelayProperty

Identifica a InitialShowDelay propriedade anexada.
IsEnabledProperty

Identifica a IsEnabled propriedade anexada.
IsOpenProperty

Identifica a IsOpen propriedade anexada.
PlacementProperty

Identifica a Placement propriedade anexada.
PlacementRectangleProperty

Identifica a PlacementRectangle propriedade anexada.
PlacementTargetProperty

Identifica a PlacementTarget propriedade anexada.
ShowDurationProperty

Identifica a ShowDuration propriedade anexada.
ShowOnDisabledProperty

Identifica a ShowOnDisabled propriedade anexada.
ShowsToolTipOnKeyboardFocusProperty

Representa um serviço que fornece propriedades e eventos para controlar a visualização e o comportamento das dicas de ferramenta.
ToolTipClosingEvent

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

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

Identifica a ToolTip propriedade anexada.
VerticalOffsetProperty

Identifica a VerticalOffset propriedade anexada.

Propriedades Anexadas

Name Description
BetweenShowDelay

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

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

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

Obtém ou define o tempo antes de abrir uma tooltip.
IsEnabled

Obtém ou define se aparece uma dica de ferramenta.
IsOpen

Percebe se uma dica de ferramenta está atualmente visível.
Placement

Obtém ou define a orientação da tooltip quando esta abre, e especifica como a tooltip se comporta quando sobrepõe limites de ecrã.
PlacementRectangle

Obtém ou define a área retangular relativa à qual a dica da ferramenta está posicionada.
PlacementTarget

Obtém ou define o objeto relativamente ao qual a tooltip está posicionada.
ShowDuration

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

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

Representa um serviço que fornece propriedades e eventos para controlar a visualização e o comportamento das dicas de ferramenta.
ToolTip

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

Obtém ou define a distância a partir do topo da área que é especificada para a dica de ferramenta pelas PlacementRectangle propriedades e.PlacementTarget

Métodos

Name Description
AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Adiciona um handler para o ToolTipClosing evento anexado.
AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Adiciona um handler para o ToolTipOpening evento anexado.
GetBetweenShowDelay(DependencyObject)

Obtém o valor da BetweenShowDelay propriedade associada para um objeto.
GetHasDropShadow(DependencyObject)

Obtém o valor da HasDropShadow propriedade associada para um objeto.
GetHorizontalOffset(DependencyObject)

Obtém o valor da HorizontalOffset propriedade associada para um objeto.
GetInitialShowDelay(DependencyObject)

Obtém o valor da InitialShowDelay propriedade associada para um objeto.
GetIsEnabled(DependencyObject)

Obtém o valor da IsEnabled propriedade associada para um objeto.
GetIsOpen(DependencyObject)

Obtém o valor da IsOpen propriedade associada para um objeto.
GetPlacement(DependencyObject)

Obtém o valor da Placement propriedade associada para um objeto.
GetPlacementRectangle(DependencyObject)

Obtém o valor da PlacementRectangle propriedade associada para um objeto.
GetPlacementTarget(DependencyObject)

Obtém o valor da PlacementTarget propriedade associada para um objeto.
GetShowDuration(DependencyObject)

Obtém o valor da ShowDuration propriedade associada para um objeto.
GetShowOnDisabled(DependencyObject)

Obtém o valor da ShowOnDisabled propriedade associada para um objeto.
GetShowsToolTipOnKeyboardFocus(DependencyObject)

Representa um serviço que fornece propriedades e eventos para controlar a visualização e o comportamento das dicas de ferramenta.
GetToolTip(DependencyObject)

Obtém o valor da ToolTip propriedade associada para um objeto.
GetVerticalOffset(DependencyObject)

Obtém o valor da VerticalOffset propriedade associada para um objeto.
RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Remove um handler para o ToolTipClosing evento anexo.
RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Remove um handler para o ToolTipOpening evento anexo.
SetBetweenShowDelay(DependencyObject, Int32)

Define o valor da BetweenShowDelay propriedade associada para um objeto.
SetHasDropShadow(DependencyObject, Boolean)

Define o valor da HasDropShadow propriedade associada para um objeto.
SetHorizontalOffset(DependencyObject, Double)

Define o valor da HorizontalOffset propriedade associada para um objeto.
SetInitialShowDelay(DependencyObject, Int32)

Define o valor da InitialShowDelay propriedade associada para um objeto.
SetIsEnabled(DependencyObject, Boolean)

Define o valor da IsEnabled propriedade associada para um objeto.
SetPlacement(DependencyObject, PlacementMode)

Define o valor da Placement propriedade associada para um objeto.
SetPlacementRectangle(DependencyObject, Rect)

Define o valor da PlacementRectangle propriedade associada para um objeto.
SetPlacementTarget(DependencyObject, UIElement)

Define o valor da PlacementTarget propriedade associada para um objeto.
SetShowDuration(DependencyObject, Int32)

Define o valor da ShowDuration propriedade associada para um objeto.
SetShowOnDisabled(DependencyObject, Boolean)

Define o valor da ShowOnDisabled propriedade associada para um objeto.
SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>)

Representa um serviço que fornece propriedades e eventos para controlar a visualização e o comportamento das dicas de ferramenta.
SetToolTip(DependencyObject, Object)

Define o valor da ToolTip propriedade associada para um objeto.
SetVerticalOffset(DependencyObject, Double)

Define o valor da VerticalOffset propriedade associada para um objeto.

Eventos Anexados

Name Description
ToolTipClosing

Acontece quando o ToolTip fecho fecha.
ToolTipOpening

Ocorre quando o ToolTip abre.

Aplica-se a

Ver também