ToolTipService Clase

Referencia

Definición

Espacio de nombres:: System.Windows.Controls

Ensamblado:: PresentationFramework.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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: Object
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

Compartir a través de