ToolTipService Classe
Definição
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 das dicas de ferramentas.
public ref class ToolTipService abstract sealedpublic static class ToolTipServicetype ToolTipService = classPublic 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. 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 propriedade ou FrameworkElement.ToolTip a FrameworkContentElement.ToolTip propriedade. 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 texto inserido e Image elementos.
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 as 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 ferramentas:
Para obter informações sobre como lidar com os eventos que ocorrem quando a dica de ferramenta é aberta ou fechada, consulte o e ToolTipClosingEvent os ToolTipOpeningEvent campos.
Placement, PlacementRectangle, PlacementTargete HorizontalOffsetVerticalOffset se comportam de forma semelhante às propriedades do mesmo nome na Popup classe. Para obter mais informações, consulte Comportamento de Posicionamento de Pop-up.
Campos
| Nome | 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 exibição e o comportamento das dicas de ferramentas. |
| ToolTipClosingEvent |
Identifica o ToolTipClosing evento exposto por objetos que usam o ToolTipService serviço para exibir dicas de ferramentas. |
| ToolTipOpeningEvent |
Identifica o ToolTipOpening evento exposto por objetos que usam o ToolTipService serviço para exibir dicas de ferramentas. |
| ToolTipProperty |
Identifica a ToolTip propriedade anexada. |
| VerticalOffsetProperty |
Identifica a VerticalOffset propriedade anexada. |
Propriedades Anexadas
| Nome | Description |
|---|---|
| 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 de soltar. |
| HorizontalOffset |
Obtém ou define o deslocamento da esquerda da área especificada para a dica de ferramenta pelo e PlacementTarget pelas PlacementRectangle propriedades. |
| InitialShowDelay |
Obtém ou define o período de tempo antes que uma dica de ferramenta seja aberta. |
| IsEnabled |
Obtém ou define se uma dica de ferramenta é exibida. |
| IsOpen |
Obtém 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 relativa à qual a dica de ferramenta está posicionada. |
| PlacementTarget |
Obtém ou define o objeto relativo ao qual a dica de ferramenta está 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 das 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 pela e PlacementTarget pelas PlacementRectangle propriedades. |
Métodos
| Nome | Description |
|---|---|
| AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) |
Adiciona um manipulador para o ToolTipClosing evento anexado. |
| AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) |
Adiciona um manipulador para o ToolTipOpening evento anexado. |
| GetBetweenShowDelay(DependencyObject) |
Obtém o valor da BetweenShowDelay propriedade anexada para um objeto. |
| GetHasDropShadow(DependencyObject) |
Obtém o valor da HasDropShadow propriedade anexada para um objeto. |
| GetHorizontalOffset(DependencyObject) |
Obtém o valor da HorizontalOffset propriedade anexada para um objeto. |
| GetInitialShowDelay(DependencyObject) |
Obtém o valor da InitialShowDelay propriedade anexada para um objeto. |
| GetIsEnabled(DependencyObject) |
Obtém o valor da IsEnabled propriedade anexada para um objeto. |
| GetIsOpen(DependencyObject) |
Obtém o valor da IsOpen propriedade anexada para um objeto. |
| GetPlacement(DependencyObject) |
Obtém o valor da Placement propriedade anexada para um objeto. |
| GetPlacementRectangle(DependencyObject) |
Obtém o valor da PlacementRectangle propriedade anexada para um objeto. |
| GetPlacementTarget(DependencyObject) |
Obtém o valor da PlacementTarget propriedade anexada para um objeto. |
| GetShowDuration(DependencyObject) |
Obtém o valor da ShowDuration propriedade anexada para um objeto. |
| GetShowOnDisabled(DependencyObject) |
Obtém o valor da ShowOnDisabled propriedade anexada para um objeto. |
| GetShowsToolTipOnKeyboardFocus(DependencyObject) |
Representa um serviço que fornece propriedades e eventos para controlar a exibição e o comportamento das dicas de ferramentas. |
| GetToolTip(DependencyObject) |
Obtém o valor da ToolTip propriedade anexada para um objeto. |
| GetVerticalOffset(DependencyObject) |
Obtém o valor da VerticalOffset propriedade anexada para um objeto. |
| RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) |
Remove um manipulador para o ToolTipClosing evento anexado. |
| RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) |
Remove um manipulador para o ToolTipOpening evento anexado. |
| SetBetweenShowDelay(DependencyObject, Int32) |
Define o valor da BetweenShowDelay propriedade anexada para um objeto. |
| SetHasDropShadow(DependencyObject, Boolean) |
Define o valor da HasDropShadow propriedade anexada para um objeto. |
| SetHorizontalOffset(DependencyObject, Double) |
Define o valor da HorizontalOffset propriedade anexada para um objeto. |
| SetInitialShowDelay(DependencyObject, Int32) |
Define o valor da InitialShowDelay propriedade anexada para um objeto. |
| SetIsEnabled(DependencyObject, Boolean) |
Define o valor da IsEnabled propriedade anexada para um objeto. |
| SetPlacement(DependencyObject, PlacementMode) |
Define o valor da Placement propriedade anexada para um objeto. |
| SetPlacementRectangle(DependencyObject, Rect) |
Define o valor da PlacementRectangle propriedade anexada para um objeto. |
| SetPlacementTarget(DependencyObject, UIElement) |
Define o valor da PlacementTarget propriedade anexada para um objeto. |
| SetShowDuration(DependencyObject, Int32) |
Define o valor da ShowDuration propriedade anexada para um objeto. |
| SetShowOnDisabled(DependencyObject, Boolean) |
Define o valor da ShowOnDisabled propriedade anexada para um objeto. |
| SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>) |
Representa um serviço que fornece propriedades e eventos para controlar a exibição e o comportamento das dicas de ferramentas. |
| SetToolTip(DependencyObject, Object) |
Define o valor da ToolTip propriedade anexada para um objeto. |
| SetVerticalOffset(DependencyObject, Double) |
Define o valor da VerticalOffset propriedade anexada para um objeto. |
Eventos Anexados
| Nome | Description |
|---|---|
| ToolTipClosing |
Ocorre quando o ToolTip fechamento é fechado. |
| ToolTipOpening |
Ocorre quando a abertura ToolTip é aberta. |
