ToolTipService ToolTipService ToolTipService ToolTipService Class

Definición

Representa un servicio que proporciona propiedades y eventos para controlar la presentación y el comportamiento de la información sobre herramientas.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
Herencia
ToolTipServiceToolTipServiceToolTipServiceToolTipService

Ejemplos

El ejemplo siguiente se muestra cómo utilizar el ToolTipService clase para especificar el comportamiento de una información sobre herramientas.The following example shows how the use the ToolTipService class to specify the behavior of a tooltip. Establecer las propiedades de la ToolTipService clase adjuntando directamente al elemento que expone la información sobre herramientas.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>

Comentarios

Definir una información sobre herramientas para un elemento estableciendo el FrameworkContentElement.ToolTip o FrameworkElement.ToolTip propiedad.You define a tooltip for an element by setting the FrameworkContentElement.ToolTip or FrameworkElement.ToolTip property. La propiedad ToolTip toma a un elemento secundario.The ToolTip property takes one child. El contenido del elemento secundario puede variar de una cadena de texto simple a contenido más complejo, como un StackPanel texto que ha incrustado y Image elementos.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.

Puede definir la información sobre herramientas como un ToolTip objeto, pero esto no es necesario.You can define tooltip content as a ToolTip object, but this is not required. Cuando no se define la información sobre herramientas contenido como un ToolTip objeto, puede usar el ToolTipService propiedades para ubicar y personalizar el contenido de la información sobre herramientas.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. Propiedades de adjuntas el ToolTipService clase se utilizan para determinar la selección de ubicación, el comportamiento y apariencia de una información sobre herramientas.Attached properties of the ToolTipService class are used to determine the placement, behavior, and appearance of a tooltip. Estas propiedades se establecen en el elemento que define la información sobre herramientas.These properties are set on the element that defines the tooltip.

El ToolTip clase y el ToolTipService clase comparten muchas de las mismas propiedades que se utilizan para personalizar una información sobre herramientas.The ToolTip class and the ToolTipService class share many of the same properties that are used to customize a tooltip. Si son equivalentes ToolTip y ToolTipService se establecen propiedades, la ToolTipService propiedad tiene prioridad.If equivalent ToolTip and ToolTipService properties are both set, the ToolTipService property takes precedence. Por ejemplo, si ambos el ToolTip.Placement propiedad y el ToolTipService.Placement propiedad se establecen para un System.Windows.Controls.ToolTip (objeto), el valor de la ToolTipService.Placement se utiliza la propiedad.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.

La siguiente ToolTipService sólo se definen propiedades de sincronización para el ToolTipService clase y se utilizan por todas las informaciones sobre herramientas:The following ToolTipService timing properties are only defined for the ToolTipService class and are used by all tooltips:

Para obtener información sobre cómo controlar los eventos que se producen cuando la información sobre herramientas se abre o se cierra, vea el ToolTipOpeningEvent y ToolTipClosingEvent campos.For information about how to handle the events that occur when the tooltip opens or closes, see the ToolTipOpeningEvent and ToolTipClosingEvent fields.

Placement, PlacementRectangle, PlacementTarget, HorizontalOffset, y VerticalOffset comportarse de manera similar a las propiedades del mismo nombre en el Popup clase.Placement, PlacementRectangle, PlacementTarget, HorizontalOffset, and VerticalOffset behave similarly to the properties of the same name in the Popup class. Para más información, consulte Posición de un control Popup.For more information, see Popup Placement Behavior.

Campos

BetweenShowDelayProperty BetweenShowDelayProperty BetweenShowDelayProperty BetweenShowDelayProperty

Identifica la propiedad adjunta BetweenShowDelay.Identifies the BetweenShowDelay attached property.

HasDropShadowProperty HasDropShadowProperty HasDropShadowProperty HasDropShadowProperty

Identifica la propiedad adjunta HasDropShadow.Identifies the HasDropShadow attached property.

HorizontalOffsetProperty HorizontalOffsetProperty HorizontalOffsetProperty HorizontalOffsetProperty

Identifica la propiedad adjunta HorizontalOffset.Identifies the HorizontalOffset attached property.

InitialShowDelayProperty InitialShowDelayProperty InitialShowDelayProperty InitialShowDelayProperty

Identifica la propiedad adjunta InitialShowDelay.Identifies the InitialShowDelay attached property.

IsEnabledProperty IsEnabledProperty IsEnabledProperty IsEnabledProperty

Identifica la propiedad adjunta IsEnabled.Identifies the IsEnabled attached property.

IsOpenProperty IsOpenProperty IsOpenProperty IsOpenProperty

Identifica la propiedad adjunta IsOpen.Identifies the IsOpen attached property.

PlacementProperty PlacementProperty PlacementProperty PlacementProperty

Identifica la propiedad adjunta Placement.Identifies the Placement attached property.

PlacementRectangleProperty PlacementRectangleProperty PlacementRectangleProperty PlacementRectangleProperty

Identifica la propiedad adjunta PlacementRectangle.Identifies the PlacementRectangle attached property.

PlacementTargetProperty PlacementTargetProperty PlacementTargetProperty PlacementTargetProperty

Identifica la propiedad adjunta PlacementTarget.Identifies the PlacementTarget attached property.

ShowDurationProperty ShowDurationProperty ShowDurationProperty ShowDurationProperty

Identifica la propiedad adjunta ShowDuration.Identifies the ShowDuration attached property.

ShowOnDisabledProperty ShowOnDisabledProperty ShowOnDisabledProperty ShowOnDisabledProperty

Identifica la propiedad adjunta ShowOnDisabled.Identifies the ShowOnDisabled attached property.

ToolTipClosingEvent ToolTipClosingEvent ToolTipClosingEvent ToolTipClosingEvent

Identifica el evento ToolTipClosing que se expone mediante los objetos que utilizan el servicio ToolTipService para mostrar informaciones sobre herramientas.Identifies the ToolTipClosing event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipOpeningEvent ToolTipOpeningEvent ToolTipOpeningEvent ToolTipOpeningEvent

Identifica el evento ToolTipOpening que se expone mediante los objetos que utilizan el servicio ToolTipService para mostrar informaciones sobre herramientas.Identifies the ToolTipOpening event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipProperty ToolTipProperty ToolTipProperty ToolTipProperty

Identifica la propiedad adjunta ToolTip.Identifies the ToolTip attached property.

VerticalOffsetProperty VerticalOffsetProperty VerticalOffsetProperty VerticalOffsetProperty

Identifica la propiedad adjunta VerticalOffset.Identifies the VerticalOffset attached property.

Propiedades adjuntas

BetweenShowDelay BetweenShowDelay BetweenShowDelay BetweenShowDelay

Obtiene o establece el tiempo máximo entre la presentación de dos informaciones sobre herramientas, la segunda de las cuales aparece sin retraso.Gets or sets the maximum time between the display of two tooltips where the second tooltip appears without a delay.

HasDropShadow HasDropShadow HasDropShadow HasDropShadow

Obtiene o establece si la información sobre herramientas muestra un efecto de sombra paralela.Gets or sets whether the tooltip displays a drop shadow effect.

HorizontalOffset HorizontalOffset HorizontalOffset HorizontalOffset

Obtiene o establece el desplazamiento desde la parte izquierda del área que las propiedades PlacementRectangle y PlacementTarget especifican para la información sobre herramientas.Gets or sets the offset from the left of the area that is specified for the tooltip by the PlacementRectangle and PlacementTarget properties.

InitialShowDelay InitialShowDelay InitialShowDelay InitialShowDelay

Obtiene o establece la duración del período que transcurre antes de que se abra una información sobre herramientas.Gets or sets the length of time before a tooltip opens.

IsEnabled IsEnabled IsEnabled IsEnabled

Obtiene o establece si aparece una información sobre herramientas.Gets or sets whether a tooltip appears.

IsOpen IsOpen IsOpen IsOpen

Obtiene si una información sobre herramientas está visible actualmente.Gets whether a tooltip is currently visible.

Placement Placement Placement Placement

Obtiene o establece la orientación de la información sobre herramientas cuando ésta se abre y especifica el modo en que se comporta cuando se superpone a los límites de la pantalla.Gets or sets the orientation of the tooltip when it opens, and specifies how the tooltip behaves when it overlaps screen boundaries.

PlacementRectangle PlacementRectangle PlacementRectangle PlacementRectangle

Obtiene o establece el área rectangular respecto a la cual se sitúa la información sobre herramientas.Gets or sets the rectangular area relative to which the tooltip is positioned.

PlacementTarget PlacementTarget PlacementTarget PlacementTarget

Obtiene o establece el objeto respecto al cual se sitúa la información sobre herramientas.Gets or sets the object relative to which the tooltip is positioned.

ShowDuration ShowDuration ShowDuration ShowDuration

Obtiene o establece el período de tiempo que una información sobre herramientas permanece visible.Gets or sets the amount of time that a tooltip remains visible.

ShowOnDisabled ShowOnDisabled ShowOnDisabled ShowOnDisabled

Obtiene o establece si aparece una información sobre herramientas en un objeto que no está habilitado.Gets or sets whether a tooltip appears for an object that is not enabled.

ToolTip ToolTip ToolTip ToolTip

Obtiene o establece el contenido de una información sobre herramientas.Gets or sets the content of a tooltip.

VerticalOffset VerticalOffset VerticalOffset VerticalOffset

Obtiene o establece la distancia desde la parte superior del área que se ha especificado para la información sobre herramientas en las propiedades PlacementRectangle y 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) AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler) AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Agrega un controlador para el evento adjunto ToolTipClosing.Adds a handler for the ToolTipClosing attached event.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Agrega un controlador para el evento adjunto ToolTipOpening.Adds a handler for the ToolTipOpening attached event.

GetBetweenShowDelay(DependencyObject) GetBetweenShowDelay(DependencyObject) GetBetweenShowDelay(DependencyObject) GetBetweenShowDelay(DependencyObject)

Obtiene el valor de la propiedad adjunta BetweenShowDelay de un objeto.Gets the value of the BetweenShowDelay attached property for an object.

GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject) GetHasDropShadow(DependencyObject)

Obtiene el valor de la propiedad adjunta HasDropShadow de un objeto.Gets the value of the HasDropShadow attached property for an object.

GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject) GetHorizontalOffset(DependencyObject)

Obtiene el valor de la propiedad adjunta HorizontalOffset de un objeto.Gets the value of the HorizontalOffset attached property for an object.

GetInitialShowDelay(DependencyObject) GetInitialShowDelay(DependencyObject) GetInitialShowDelay(DependencyObject) GetInitialShowDelay(DependencyObject)

Obtiene el valor de la propiedad adjunta InitialShowDelay de un objeto.Gets the value of the InitialShowDelay attached property for an object.

GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject) GetIsEnabled(DependencyObject)

Obtiene el valor de la propiedad adjunta IsEnabled de un objeto.Gets the value of the IsEnabled attached property for an object.

GetIsOpen(DependencyObject) GetIsOpen(DependencyObject) GetIsOpen(DependencyObject) GetIsOpen(DependencyObject)

Obtiene el valor de la propiedad adjunta IsOpen de un objeto.Gets the value of the IsOpen attached property for an object.

GetPlacement(DependencyObject) GetPlacement(DependencyObject) GetPlacement(DependencyObject) GetPlacement(DependencyObject)

Obtiene el valor de la propiedad adjunta Placement de un objeto.Gets the value of the Placement attached property for an object.

GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject) GetPlacementRectangle(DependencyObject)

Obtiene el valor de la propiedad adjunta PlacementRectangle de un objeto.Gets the value of the PlacementRectangle attached property for an object.

GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject) GetPlacementTarget(DependencyObject)

Obtiene el valor de la propiedad adjunta PlacementTarget de un objeto.Gets the value of the PlacementTarget attached property for an object.

GetShowDuration(DependencyObject) GetShowDuration(DependencyObject) GetShowDuration(DependencyObject) GetShowDuration(DependencyObject)

Obtiene el valor de la propiedad adjunta ShowDuration de un objeto.Gets the value of the ShowDuration attached property for an object.

GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject) GetShowOnDisabled(DependencyObject)

Obtiene el valor de la propiedad adjunta ShowOnDisabled de un objeto.Gets the value of the ShowOnDisabled attached property for an object.

GetToolTip(DependencyObject) GetToolTip(DependencyObject) GetToolTip(DependencyObject) GetToolTip(DependencyObject)

Obtiene el valor de la propiedad adjunta ToolTip de un objeto.Gets the value of the ToolTip attached property for an object.

GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject) GetVerticalOffset(DependencyObject)

Obtiene el valor de la propiedad adjunta VerticalOffset de un objeto.Gets the value of the VerticalOffset attached property for an object.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Quita un controlador del evento adjunto ToolTipClosing.Removes a handler for the ToolTipClosing attached event.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler) RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Quita un controlador del evento adjunto ToolTipOpening.Removes a handler for the ToolTipOpening attached event.

SetBetweenShowDelay(DependencyObject, Int32) SetBetweenShowDelay(DependencyObject, Int32) SetBetweenShowDelay(DependencyObject, Int32) SetBetweenShowDelay(DependencyObject, Int32)

Establece el valor de la propiedad adjunta BetweenShowDelay de un objeto.Sets the value of the BetweenShowDelay attached property for an object.

SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean) SetHasDropShadow(DependencyObject, Boolean)

Establece el valor de la propiedad adjunta HasDropShadow de un objeto.Sets the value of the HasDropShadow attached property for an object.

SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double) SetHorizontalOffset(DependencyObject, Double)

Establece el valor de la propiedad adjunta HorizontalOffset de un objeto.Sets the value of the HorizontalOffset attached property for an object.

SetInitialShowDelay(DependencyObject, Int32) SetInitialShowDelay(DependencyObject, Int32) SetInitialShowDelay(DependencyObject, Int32) SetInitialShowDelay(DependencyObject, Int32)

Establece el valor de la propiedad adjunta InitialShowDelay de un objeto.Sets the value of the InitialShowDelay attached property for an object.

SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean) SetIsEnabled(DependencyObject, Boolean)

Establece el valor de la propiedad adjunta IsEnabled de un objeto.Sets the value of the IsEnabled attached property for an object.

SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode) SetPlacement(DependencyObject, PlacementMode)

Establece el valor de la propiedad adjunta Placement de un objeto.Sets the value of the Placement attached property for an object.

SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect) SetPlacementRectangle(DependencyObject, Rect)

Establece el valor de la propiedad adjunta PlacementRectangle de un objeto.Sets the value of the PlacementRectangle attached property for an object.

SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement) SetPlacementTarget(DependencyObject, UIElement)

Establece el valor de la propiedad adjunta PlacementTarget de un objeto.Sets the value of the PlacementTarget attached property for an object.

SetShowDuration(DependencyObject, Int32) SetShowDuration(DependencyObject, Int32) SetShowDuration(DependencyObject, Int32) SetShowDuration(DependencyObject, Int32)

Establece el valor de la propiedad adjunta ShowDuration de un objeto.Sets the value of the ShowDuration attached property for an object.

SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean) SetShowOnDisabled(DependencyObject, Boolean)

Establece el valor de la propiedad adjunta ShowOnDisabled de un objeto.Sets the value of the ShowOnDisabled attached property for an object.

SetToolTip(DependencyObject, Object) SetToolTip(DependencyObject, Object) SetToolTip(DependencyObject, Object) SetToolTip(DependencyObject, Object)

Establece el valor de la propiedad adjunta ToolTip de un objeto.Sets the value of the ToolTip attached property for an object.

SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double) SetVerticalOffset(DependencyObject, Double)

Establece el valor de la propiedad adjunta VerticalOffset de un objeto.Sets the value of the VerticalOffset attached property for an object.

Eventos adjuntos

ToolTipClosing ToolTipClosing ToolTipClosing ToolTipClosing

Se produce cuando se cierra el control ToolTip.Occurs when the ToolTip closes.

ToolTipOpening ToolTipOpening ToolTipOpening ToolTipOpening

Se produce cuando se abre ToolTip.Occurs when the ToolTip opens.

Se aplica a

Consulte también: