Compartir a través de


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.

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 usa la ToolTipService clase para especificar el comportamiento de una información sobre herramientas. Para establecer las propiedades de la ToolTipService clase, adjuntelas directamente al elemento que expone la información sobre herramientas.

<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 propiedad o FrameworkElement.ToolTip . La propiedad ToolTip toma un elemento secundario. El contenido del elemento secundario puede variar de una cadena de texto simple a contenido más complejo, como un StackPanel que tiene texto incrustado y Image elementos.

Puede definir el contenido de la información sobre herramientas como un ToolTip objeto, pero esto no es necesario. Cuando no define el contenido de la información sobre herramientas como un ToolTip objeto, puede usar las ToolTipService propiedades para colocar y personalizar el contenido de la información sobre herramientas. 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. Estas propiedades se establecen en el elemento que define la información sobre herramientas.

La ToolTip clase y la ToolTipService clase comparten muchas de las mismas propiedades que se usan para personalizar una información sobre herramientas. Si se establecen propiedades y equivalentesToolTip, la ToolTipService propiedad tiene ToolTipService prioridad. Por ejemplo, si la ToolTip.Placement propiedad y la ToolTipService.Placement propiedad se establecen para un System.Windows.Controls.ToolTip objeto , se usa el valor de la ToolTipService.Placement propiedad .

Las siguientes ToolTipService propiedades de control de tiempo solo se definen para la ToolTipService clase y se usan en todas las informaciones sobre herramientas:

Para obtener información sobre cómo controlar los eventos que se producen cuando se abre o cierra la información sobre herramientas, vea los ToolTipOpeningEvent campos y ToolTipClosingEvent .

Placement, PlacementRectangle, PlacementTarget, HorizontalOffsety VerticalOffset se comportan de forma similar a las propiedades del mismo nombre en la Popup clase . Para más información, consulte Posición de un control Popup.

Campos

BetweenShowDelayProperty

Identifica la propiedad adjunta BetweenShowDelay.

HasDropShadowProperty

Identifica la propiedad adjunta HasDropShadow.

HorizontalOffsetProperty

Identifica la propiedad adjunta HorizontalOffset.

InitialShowDelayProperty

Identifica la propiedad adjunta InitialShowDelay.

IsEnabledProperty

Identifica la propiedad adjunta IsEnabled.

IsOpenProperty

Identifica la propiedad adjunta IsOpen.

PlacementProperty

Identifica la propiedad adjunta Placement.

PlacementRectangleProperty

Identifica la propiedad adjunta PlacementRectangle.

PlacementTargetProperty

Identifica la propiedad adjunta PlacementTarget.

ShowDurationProperty

Identifica la propiedad adjunta ShowDuration.

ShowOnDisabledProperty

Identifica la propiedad adjunta ShowOnDisabled.

ShowsToolTipOnKeyboardFocusProperty

Representa un servicio que proporciona propiedades y eventos para controlar la visualización y el comportamiento de la información sobre herramientas.

ToolTipClosingEvent

Identifica el evento ToolTipClosing que se expone mediante los objetos que utilizan el servicio ToolTipService para mostrar informaciones sobre herramientas.

ToolTipOpeningEvent

Identifica el evento ToolTipOpening que se expone mediante los objetos que utilizan el servicio ToolTipService para mostrar informaciones sobre herramientas.

ToolTipProperty

Identifica la propiedad adjunta ToolTip.

VerticalOffsetProperty

Identifica la propiedad adjunta VerticalOffset.

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.

HasDropShadow

Obtiene o establece si la información sobre herramientas muestra un efecto de sombra paralela.

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.

InitialShowDelay

Obtiene o establece el período de tiempo antes de abrirse una información sobre herramientas.

IsEnabled

Obtiene o establece si aparece una información sobre herramientas.

IsOpen

Obtiene si una información sobre herramientas está actualmente 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.

PlacementRectangle

Obtiene o establece el área rectangular respecto al cual se coloca la información sobre herramientas.

PlacementTarget

Obtiene o establece el objeto respecto al cual se coloca la información sobre herramientas.

ShowDuration

Obtiene o establece la cantidad de tiempo que la información sobre herramientas permanece visible.

ShowOnDisabled

Obtiene o establece si aparece información sobre herramientas para un objeto que no está habilitado.

ShowsToolTipOnKeyboardFocus

Representa un servicio que proporciona propiedades y eventos para controlar la visualización y el comportamiento de la información sobre herramientas.

ToolTip

Obtiene o establece el contenido de una información sobre herramientas.

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.

Métodos

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Agrega un controlador para el evento adjunto ToolTipClosing.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Agrega un controlador para el evento adjunto ToolTipOpening.

GetBetweenShowDelay(DependencyObject)

Obtiene el valor de la propiedad adjunta BetweenShowDelay de un objeto.

GetHasDropShadow(DependencyObject)

Obtiene el valor de la propiedad adjunta HasDropShadow de un objeto.

GetHorizontalOffset(DependencyObject)

Obtiene el valor de la propiedad adjunta HorizontalOffset de un objeto.

GetInitialShowDelay(DependencyObject)

Obtiene el valor de la propiedad adjunta InitialShowDelay de un objeto.

GetIsEnabled(DependencyObject)

Obtiene el valor de la propiedad adjunta IsEnabled de un objeto.

GetIsOpen(DependencyObject)

Obtiene el valor de la propiedad adjunta IsOpen de un objeto.

GetPlacement(DependencyObject)

Obtiene el valor de la propiedad adjunta Placement de un objeto.

GetPlacementRectangle(DependencyObject)

Obtiene el valor de la propiedad adjunta PlacementRectangle de un objeto.

GetPlacementTarget(DependencyObject)

Obtiene el valor de la propiedad adjunta PlacementTarget de un objeto.

GetShowDuration(DependencyObject)

Obtiene el valor de la propiedad adjunta ShowDuration de un objeto.

GetShowOnDisabled(DependencyObject)

Obtiene el valor de la propiedad adjunta ShowOnDisabled de un objeto.

GetShowsToolTipOnKeyboardFocus(DependencyObject)

Representa un servicio que proporciona propiedades y eventos para controlar la visualización y el comportamiento de la información sobre herramientas.

GetToolTip(DependencyObject)

Obtiene el valor de la propiedad adjunta ToolTip de un objeto.

GetVerticalOffset(DependencyObject)

Obtiene el valor de la propiedad adjunta VerticalOffset de un objeto.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Quita un controlador del evento adjunto ToolTipClosing.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Quita un controlador del evento adjunto ToolTipOpening.

SetBetweenShowDelay(DependencyObject, Int32)

Establece el valor de la propiedad adjunta BetweenShowDelay de un objeto.

SetHasDropShadow(DependencyObject, Boolean)

Establece el valor de la propiedad adjunta HasDropShadow de un objeto.

SetHorizontalOffset(DependencyObject, Double)

Establece el valor de la propiedad adjunta HorizontalOffset de un objeto.

SetInitialShowDelay(DependencyObject, Int32)

Establece el valor de la propiedad adjunta InitialShowDelay de un objeto.

SetIsEnabled(DependencyObject, Boolean)

Establece el valor de la propiedad adjunta IsEnabled de un objeto.

SetPlacement(DependencyObject, PlacementMode)

Establece el valor de la propiedad adjunta Placement de un objeto.

SetPlacementRectangle(DependencyObject, Rect)

Establece el valor de la propiedad adjunta PlacementRectangle de un objeto.

SetPlacementTarget(DependencyObject, UIElement)

Establece el valor de la propiedad adjunta PlacementTarget de un objeto.

SetShowDuration(DependencyObject, Int32)

Establece el valor de la propiedad adjunta ShowDuration de un objeto.

SetShowOnDisabled(DependencyObject, Boolean)

Establece el valor de la propiedad adjunta ShowOnDisabled de un objeto.

SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>)

Representa un servicio que proporciona propiedades y eventos para controlar la visualización y el comportamiento de la información sobre herramientas.

SetToolTip(DependencyObject, Object)

Establece el valor de la propiedad adjunta ToolTip de un objeto.

SetVerticalOffset(DependencyObject, Double)

Establece el valor de la propiedad adjunta VerticalOffset de un objeto.

Eventos adjuntos

ToolTipClosing

Se produce cuando se cierra el control ToolTip.

ToolTipOpening

Se produce cuando se abre ToolTip.

Se aplica a

Consulte también