ToolTipService Clase

Definición

Representa un servicio que proporciona propiedades y eventos para controlar la visualizació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
ToolTipService

Ejemplos

En el ejemplo siguiente se muestra cómo usar la 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. Establezca las propiedades de la ToolTipService clase mediante su asociación directa 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

Para definir una información sobre herramientas para un elemento, establezca la FrameworkContentElement.ToolTip FrameworkElement.ToolTip propiedad o.You define a tooltip for an element by setting the FrameworkContentElement.ToolTip or FrameworkElement.ToolTip property. La propiedad ToolTip toma un elemento secundario.The ToolTip property takes one child. El contenido del elemento secundario puede variar de una cadena de texto simple a un contenido más complejo, como un StackPanel que tiene texto y elementos incrustados Image .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 el contenido de 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 el contenido de la información sobre herramientas como un ToolTip objeto, se pueden usar las ToolTipService propiedades para colocar 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. Las propiedades adjuntas de la ToolTipService clase se usan para determinar la ubicación, el comportamiento y la 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.

La ToolTip clase y la ToolTipService clase comparten muchas de las mismas propiedades que se usan 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 ToolTip ToolTipService se establecen las propiedades equivalentes y, la ToolTipService propiedad tiene prioridad.If equivalent ToolTip and ToolTipService properties are both set, the ToolTipService property takes precedence. Por ejemplo, si ToolTip.Placement se establecen tanto la propiedad como la ToolTipService.Placement propiedad para un System.Windows.Controls.ToolTip objeto, se utiliza el valor de la ToolTipService.Placement 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.

Las siguientes ToolTipService propiedades de tiempo solo se definen para la ToolTipService clase y se utilizan en toda la información 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 los ToolTipOpeningEvent ToolTipClosingEvent campos y.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 se comportan de manera similar a las propiedades del mismo nombre en la 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

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

HasDropShadowProperty

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

HorizontalOffsetProperty

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

InitialShowDelayProperty

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

IsEnabledProperty

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

IsOpenProperty

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

PlacementProperty

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

PlacementRectangleProperty

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

PlacementTargetProperty

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

ShowDurationProperty

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

ShowOnDisabledProperty

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

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

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

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

VerticalOffsetProperty

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

Propiedades adjuntas

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

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

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

Obtiene o establece el período de tiempo antes de abrirse una información sobre herramientas.Gets or sets the length of time before a tooltip opens.

IsEnabled

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

IsOpen

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

Placement

Obtiene o establece la orientación de la información sobre herramientas al abrirse y especifica cómo se comporta la información sobre herramientas 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

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

PlacementTarget

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

ShowDuration

Obtiene o establece la cantidad de tiempo que la información sobre herramientas permanece visible.Gets or sets the amount of time that a tooltip remains visible.

ShowOnDisabled

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

ToolTip

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

VerticalOffset

Obtiene o establece la distancia desde la parte superior del área que las propiedades PlacementRectangle y PlacementTarget especifican para la información sobre herramientas.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)

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

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

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

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)

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

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)

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

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)

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

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)

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

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)

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

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)

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

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)

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

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

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

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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)

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

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

ToolTipOpening

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

Se aplica a

Consulte también