ToolTipService Classe

Definição

Espaço de Nomes:: System.Windows.Controls

Assemblagem:: PresentationFramework.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Comentários

Esta página foi útil?