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.Represents a service that provides properties and events to control the display and behavior of tooltips.

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.The following example shows how the use the ToolTipService class to specify the behavior of a tooltip. Você define as propriedades da ToolTipService classe anexando-as diretamente ao elemento que expõe a dica de ferramenta.You set the properties of the ToolTipService class by attaching them directly to the element that exposes the tooltip.

<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 FrameworkContentElement.ToolTip a FrameworkElement.ToolTip propriedade ou.You define a tooltip for an element by setting the FrameworkContentElement.ToolTip or FrameworkElement.ToolTip property. A Propriedade ToolTip usa um filho.The ToolTip property takes one child. O conteúdo do filho pode variar de uma cadeia de caracteres de texto simples para um conteúdo mais complexo StackPanel , como um que tenha Image texto e elementos inseridos.The content of the child can vary from a simple text string to more complex content such as a StackPanel that has embedded text and Image elements.

Você pode definir o conteúdo da dica ToolTip de ferramenta como um objeto, mas isso não é necessário.You can define tooltip content as a ToolTip object, but this is not required. Quando você não define o conteúdo da dica de ferramenta ToolTip como um objeto, pode usar ToolTipService as propriedades para posicionar e personalizar o conteúdo da dica de ferramenta.When you do not define the tooltip content as a ToolTip object, you can use the ToolTipService properties to position and customize the tooltip content. As propriedades anexadas ToolTipService da classe são usadas para determinar o posicionamento, o comportamento e a aparência de uma dica de ferramenta.Attached properties of the ToolTipService class are used to determine the placement, behavior, and appearance of a tooltip. Essas propriedades são definidas no elemento que define a dica de ferramenta.These properties are set on the element that defines the tooltip.

A ToolTip classe e a ToolTipService classe compartilham muitas das mesmas propriedades que são usadas para personalizar uma dica de ferramenta.The ToolTip class and the ToolTipService class share many of the same properties that are used to customize a tooltip. Se equivalente ToolTip e ToolTipService propriedades forem definidas, a ToolTipService Propriedade terá precedência.If equivalent ToolTip and ToolTipService properties are both set, the ToolTipService property takes precedence. Por ToolTip.Placement exemplo, se a propriedade e a ToolTipService.Placement Propriedade forem definidas para um System.Windows.Controls.ToolTip objeto, o valor da ToolTipService.Placement propriedade será usado.For example, if both the ToolTip.Placement property and the ToolTipService.Placement property are set for a System.Windows.Controls.ToolTip object, the value of the ToolTipService.Placement property is used.

As seguintes ToolTipService Propriedades de temporização são definidas apenas ToolTipService para a classe e são usadas por todas as dicas de ferramenta:The following ToolTipService timing properties are only defined for the ToolTipService class and are used by all tooltips:

Para obter informações sobre como lidar com os eventos que ocorrem quando a dica de ferramenta é aberta ou ToolTipOpeningEvent fechada ToolTipClosingEvent , consulte os campos e.For information about how to handle the events that occur when the tooltip opens or closes, see the ToolTipOpeningEvent and ToolTipClosingEvent fields.

PlacementPlacementRectangle ,,VerticalOffset , ePopup se comportam de forma semelhante às propriedades de mesmo nome na classe. PlacementTarget HorizontalOffsetPlacement, PlacementRectangle, PlacementTarget, HorizontalOffset, and VerticalOffset behave similarly to the properties of the same name in the Popup class. Para mais informações, consulte Comportamento de posicionamento de pop-up.For more information, see Popup Placement Behavior.

Campos

BetweenShowDelayProperty

Identifica a propriedade BetweenShowDelay anexada.Identifies the BetweenShowDelay attached property.

HasDropShadowProperty

Identifica a propriedade HasDropShadow anexada.Identifies the HasDropShadow attached property.

HorizontalOffsetProperty

Identifica a propriedade HorizontalOffset anexada.Identifies the HorizontalOffset attached property.

InitialShowDelayProperty

Identifica a propriedade InitialShowDelay anexada.Identifies the InitialShowDelay attached property.

IsEnabledProperty

Identifica a propriedade IsEnabled anexada.Identifies the IsEnabled attached property.

IsOpenProperty

Identifica a propriedade IsOpen anexada.Identifies the IsOpen attached property.

PlacementProperty

Identifica a propriedade Placement anexada.Identifies the Placement attached property.

PlacementRectangleProperty

Identifica a propriedade PlacementRectangle anexada.Identifies the PlacementRectangle attached property.

PlacementTargetProperty

Identifica a propriedade PlacementTarget anexada.Identifies the PlacementTarget attached property.

ShowDurationProperty

Identifica a propriedade ShowDuration anexada.Identifies the ShowDuration attached property.

ShowOnDisabledProperty

Identifica a propriedade ShowOnDisabled anexada.Identifies the ShowOnDisabled attached property.

ToolTipClosingEvent

Identifica o evento ToolTipClosing exposto por objetos que usam o serviço ToolTipService para exibir dicas de ferramenta.Identifies the ToolTipClosing event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipOpeningEvent

Identifica o evento ToolTipOpening exposto por objetos que usam o serviço ToolTipService para exibir dicas de ferramenta.Identifies the ToolTipOpening event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipProperty

Identifica a propriedade ToolTip anexada.Identifies the ToolTip attached property.

VerticalOffsetProperty

Identifica a propriedade VerticalOffset anexada.Identifies the VerticalOffset attached property.

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.Gets or sets the maximum time between the display of two tooltips where the second tooltip appears without a delay.

HasDropShadow

Obtém ou define se a dica de ferramenta exibe um efeito de sombra.Gets or sets whether the tooltip displays a drop shadow effect.

HorizontalOffset

Obtém ou define o deslocamento da esquerda da área especificada para a dica de ferramenta pelas propriedades PlacementRectangle e PlacementTarget.Gets or sets the offset from the left of the area that is specified for the tooltip by the PlacementRectangle and PlacementTarget properties.

InitialShowDelay

Obtém ou define o período de tempo antes que uma dica de ferramenta é aberta.Gets or sets the length of time before a tooltip opens.

IsEnabled

Obtém ou define se uma dica de ferramenta é exibida.Gets or sets whether a tooltip appears.

IsOpen

Identifica se uma dica de ferramenta está visível no momento.Gets whether a tooltip is currently visible.

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.Gets or sets the orientation of the tooltip when it opens, and specifies how the tooltip behaves when it overlaps screen boundaries.

PlacementRectangle

Obtém ou define a área retangular em relação à qual a dica de ferramenta é posicionada.Gets or sets the rectangular area relative to which the tooltip is positioned.

PlacementTarget

Obtém ou define o objeto em relação ao qual a dica de ferramenta é posicionada.Gets or sets the object relative to which the tooltip is positioned.

ShowDuration

Obtém ou define a quantidade de tempo que uma dica de ferramenta permanece visível.Gets or sets the amount of time that a tooltip remains visible.

ShowOnDisabled

Obtém ou define se uma dica de ferramenta é exibida para um objeto que não está habilitado.Gets or sets whether a tooltip appears for an object that is not enabled.

ToolTip

Obtém ou define o conteúdo de uma dica de ferramenta.Gets or sets the content of a tooltip.

VerticalOffset

Obtém ou define a distância da parte superior da área especificada para a dica de ferramenta pelas propriedades PlacementRectangle e PlacementTarget.Gets or sets the distance from the top of the area that is specified for the tooltip by the PlacementRectangle and PlacementTarget properties.

Métodos

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Adiciona um manipulador para o evento anexado ToolTipClosing .Adds a handler for the ToolTipClosing attached event.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Adiciona um manipulador ao evento anexado ToolTipOpening.Adds a handler for the ToolTipOpening attached event.

GetBetweenShowDelay(DependencyObject)

Obtém o valor da propriedade anexada BetweenShowDelay de um objeto.Gets the value of the BetweenShowDelay attached property for an object.

GetHasDropShadow(DependencyObject)

Obtém o valor da propriedade anexada HasDropShadow de um objeto.Gets the value of the HasDropShadow attached property for an object.

GetHorizontalOffset(DependencyObject)

Obtém o valor da propriedade anexada HorizontalOffset de um objeto.Gets the value of the HorizontalOffset attached property for an object.

GetInitialShowDelay(DependencyObject)

Obtém o valor da propriedade anexada InitialShowDelay de um objeto.Gets the value of the InitialShowDelay attached property for an object.

GetIsEnabled(DependencyObject)

Obtém o valor da propriedade anexada IsEnabled de um objeto.Gets the value of the IsEnabled attached property for an object.

GetIsOpen(DependencyObject)

Obtém o valor da propriedade anexada IsOpen de um objeto.Gets the value of the IsOpen attached property for an object.

GetPlacement(DependencyObject)

Obtém o valor da propriedade anexada Placement de um objeto.Gets the value of the Placement attached property for an object.

GetPlacementRectangle(DependencyObject)

Obtém o valor da propriedade anexada PlacementRectangle de um objeto.Gets the value of the PlacementRectangle attached property for an object.

GetPlacementTarget(DependencyObject)

Obtém o valor da propriedade anexada PlacementTarget de um objeto.Gets the value of the PlacementTarget attached property for an object.

GetShowDuration(DependencyObject)

Obtém o valor da propriedade anexada ShowDuration de um objeto.Gets the value of the ShowDuration attached property for an object.

GetShowOnDisabled(DependencyObject)

Obtém o valor da propriedade anexada ShowOnDisabled de um objeto.Gets the value of the ShowOnDisabled attached property for an object.

GetToolTip(DependencyObject)

Obtém o valor da propriedade anexada ToolTip de um objeto.Gets the value of the ToolTip attached property for an object.

GetVerticalOffset(DependencyObject)

Obtém o valor da propriedade anexada VerticalOffset de um objeto.Gets the value of the VerticalOffset attached property for an object.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Remove um manipulador para o evento anexado ToolTipClosing.Removes a handler for the ToolTipClosing attached event.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Remove um manipulador para o evento anexado ToolTipOpening.Removes a handler for the ToolTipOpening attached event.

SetBetweenShowDelay(DependencyObject, Int32)

Define o valor da propriedade anexada BetweenShowDelay de um objeto.Sets the value of the BetweenShowDelay attached property for an object.

SetHasDropShadow(DependencyObject, Boolean)

Define o valor da propriedade anexada HasDropShadow de um objeto.Sets the value of the HasDropShadow attached property for an object.

SetHorizontalOffset(DependencyObject, Double)

Define o valor da propriedade anexada HorizontalOffset de um objeto.Sets the value of the HorizontalOffset attached property for an object.

SetInitialShowDelay(DependencyObject, Int32)

Define o valor da propriedade anexada InitialShowDelay de um objeto.Sets the value of the InitialShowDelay attached property for an object.

SetIsEnabled(DependencyObject, Boolean)

Define o valor da propriedade anexada IsEnabled de um objeto.Sets the value of the IsEnabled attached property for an object.

SetPlacement(DependencyObject, PlacementMode)

Define o valor da propriedade anexada Placement de um objeto.Sets the value of the Placement attached property for an object.

SetPlacementRectangle(DependencyObject, Rect)

Define o valor da propriedade anexada PlacementRectangle de um objeto.Sets the value of the PlacementRectangle attached property for an object.

SetPlacementTarget(DependencyObject, UIElement)

Define o valor da propriedade anexada PlacementTarget de um objeto.Sets the value of the PlacementTarget attached property for an object.

SetShowDuration(DependencyObject, Int32)

Define o valor da propriedade anexada ShowDuration de um objeto.Sets the value of the ShowDuration attached property for an object.

SetShowOnDisabled(DependencyObject, Boolean)

Define o valor da propriedade anexada ShowOnDisabled de um objeto.Sets the value of the ShowOnDisabled attached property for an object.

SetToolTip(DependencyObject, Object)

Define o valor da propriedade anexada ToolTip de um objeto.Sets the value of the ToolTip attached property for an object.

SetVerticalOffset(DependencyObject, Double)

Define o valor da propriedade anexada VerticalOffset de um objeto.Sets the value of the VerticalOffset attached property for an object.

Eventos Anexados

ToolTipClosing

Ocorre quando o ToolTip é fechado.Occurs when the ToolTip closes.

ToolTipOpening

Ocorre quando o ToolTip é aberto.Occurs when the ToolTip opens.

Aplica-se a

Veja também