ToolTipService Classe

Referência

Definição

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Compartilhar via