ToolTipService Classe

Definizione

Rappresenta un servizio che fornisce proprietà ed eventi per controllare la visualizzazione e il comportamento delle descrizioni comandi.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
Ereditarietà
ToolTipService

Esempi

Nell'esempio seguente viene illustrato come utilizzare ToolTipService la classe per specificare il comportamento di una descrizione comando.The following example shows how the use the ToolTipService class to specify the behavior of a tooltip. Per impostare le proprietà della ToolTipService classe, è possibile associarle direttamente all'elemento che espone la descrizione comando.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>

Commenti

Per definire una descrizione comando per un elemento, impostare FrameworkContentElement.ToolTip la FrameworkElement.ToolTip proprietà o.You define a tooltip for an element by setting the FrameworkContentElement.ToolTip or FrameworkElement.ToolTip property. La proprietà ToolTip accetta un elemento figlio.The ToolTip property takes one child. Il contenuto dell'elemento figlio può variare da una stringa di testo semplice a un contenuto più complesso, StackPanel ad esempio un oggetto con Image testo e elementi incorporati.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.

È possibile definire il contenuto della descrizione ToolTip comando come oggetto, ma questa operazione non è obbligatoria.You can define tooltip content as a ToolTip object, but this is not required. Quando non si definisce il contenuto della descrizione comando come ToolTip oggetto, è possibile usare le ToolTipService proprietà per posizionare e personalizzare il contenuto della descrizione comando.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. Le proprietà associate della ToolTipService classe vengono utilizzate per determinare la posizione, il comportamento e l'aspetto di una descrizione comando.Attached properties of the ToolTipService class are used to determine the placement, behavior, and appearance of a tooltip. Queste proprietà vengono impostate sull'elemento che definisce la descrizione comando.These properties are set on the element that defines the tooltip.

La ToolTip classe e la ToolTipService classe condividono molte delle stesse proprietà usate per personalizzare una descrizione comando.The ToolTip class and the ToolTipService class share many of the same properties that are used to customize a tooltip. Se sono impostate ToolTipService entrambe le proprietà ToolTipServicee, la proprietà avrà la precedenza. ToolTipIf equivalent ToolTip and ToolTipService properties are both set, the ToolTipService property takes precedence. Se, ad esempio, la ToolTip.Placement proprietà e la ToolTipService.Placement proprietà sono impostate per un System.Windows.Controls.ToolTip oggetto, viene utilizzato il valore ToolTipService.Placement della proprietà.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.

Le proprietà ToolTipService temporali seguenti sono definite solo per ToolTipService la classe e vengono usate da tutte le descrizioni comandi:The following ToolTipService timing properties are only defined for the ToolTipService class and are used by all tooltips:

Per informazioni su come gestire gli eventi che si verificano quando la descrizione comando si apre o si ToolTipOpeningEvent chiude ToolTipClosingEvent , vedere i campi e.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, HorizontalOffsete siVerticalOffset comportanoinmodoanalogoalleproprietàconlostessoPopup nome nella classe.Placement, PlacementRectangle, PlacementTarget, HorizontalOffset, and VerticalOffset behave similarly to the properties of the same name in the Popup class. Per altre informazioni, vedere Comportamento del controllo Popup in relazione al posizionamento.For more information, see Popup Placement Behavior.

Campi

BetweenShowDelayProperty

Identifica la proprietà associata BetweenShowDelay.Identifies the BetweenShowDelay attached property.

HasDropShadowProperty

Identifica la proprietà associata HasDropShadow.Identifies the HasDropShadow attached property.

HorizontalOffsetProperty

Identifica la proprietà associata HorizontalOffset.Identifies the HorizontalOffset attached property.

InitialShowDelayProperty

Identifica la proprietà associata InitialShowDelay.Identifies the InitialShowDelay attached property.

IsEnabledProperty

Identifica la proprietà associata IsEnabled.Identifies the IsEnabled attached property.

IsOpenProperty

Identifica la proprietà associata IsOpen.Identifies the IsOpen attached property.

PlacementProperty

Identifica la proprietà associata Placement.Identifies the Placement attached property.

PlacementRectangleProperty

Identifica la proprietà associata PlacementRectangle.Identifies the PlacementRectangle attached property.

PlacementTargetProperty

Identifica la proprietà associata PlacementTarget.Identifies the PlacementTarget attached property.

ShowDurationProperty

Identifica la proprietà associata ShowDuration.Identifies the ShowDuration attached property.

ShowOnDisabledProperty

Identifica la proprietà associata ShowOnDisabled.Identifies the ShowOnDisabled attached property.

ToolTipClosingEvent

Identifica l'evento ToolTipClosing esposto da oggetti che utilizzano il servizio ToolTipService per visualizzare le descrizioni comandi.Identifies the ToolTipClosing event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipOpeningEvent

Identifica l'evento ToolTipOpening esposto da oggetti che utilizzano il servizio ToolTipService per visualizzare le descrizioni comandi.Identifies the ToolTipOpening event that is exposed by objects that use the ToolTipService service to display tooltips.

ToolTipProperty

Identifica la proprietà associata ToolTip.Identifies the ToolTip attached property.

VerticalOffsetProperty

Identifica la proprietà associata VerticalOffset.Identifies the VerticalOffset attached property.

Proprietà associate

BetweenShowDelay

Ottiene o imposta l'intervallo di tempo massimo tra la visualizzazione delle due descrizioni comandi in cui la seconda descrizione comandi viene visualizzata senza un ritardo.Gets or sets the maximum time between the display of two tooltips where the second tooltip appears without a delay.

HasDropShadow

Ottiene o imposta se la descrizione comandi viene visualizzata con una ombreggiatura.Gets or sets whether the tooltip displays a drop shadow effect.

HorizontalOffset

Ottiene o imposta l'offset dalla sinistra dell'area specificata per la descrizione comandi dalle proprietà PlacementRectangle e PlacementTarget.Gets or sets the offset from the left of the area that is specified for the tooltip by the PlacementRectangle and PlacementTarget properties.

InitialShowDelay

Ottiene o imposta la lunghezza del periodo di tempo che trascorre prima che si apra una descrizione comandi.Gets or sets the length of time before a tooltip opens.

IsEnabled

Ottiene o imposta se appare una descrizione comandi.Gets or sets whether a tooltip appears.

IsOpen

Indica se una descrizione comandi è attualmente visibile.Gets whether a tooltip is currently visible.

Placement

Ottiene o imposta l'orientamento della descrizione comandi quando si apre e ne specifica il comportamento quando si sovrappone ai limiti dello schermo.Gets or sets the orientation of the tooltip when it opens, and specifies how the tooltip behaves when it overlaps screen boundaries.

PlacementRectangle

Ottiene o imposta l'area rettangolare in relazione a cui è posizionata la descrizione comandi.Gets or sets the rectangular area relative to which the tooltip is positioned.

PlacementTarget

Ottiene o imposta l’oggetto in relazione a cui è posizionata la descrizione comandi.Gets or sets the object relative to which the tooltip is positioned.

ShowDuration

Ottiene o imposta il periodo di tempo per cui una descrizione comandi rimane visibile.Gets or sets the amount of time that a tooltip remains visible.

ShowOnDisabled

Ottiene o imposta se viene visualizzata una descrizione comandi per un oggetto che non è abilitato.Gets or sets whether a tooltip appears for an object that is not enabled.

ToolTip

Ottiene o imposta il contenuto della descrizione comandi.Gets or sets the content of a tooltip.

VerticalOffset

Ottiene o imposta la distanza dall’alto dell'area specificata per la descrizione comandi dalle proprietà PlacementRectangle e PlacementTarget.Gets or sets the distance from the top of the area that is specified for the tooltip by the PlacementRectangle and PlacementTarget properties.

Metodi

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Aggiunge un gestore per l'evento associato ToolTipClosing.Adds a handler for the ToolTipClosing attached event.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Aggiunge un gestore per l'evento associato ToolTipOpening.Adds a handler for the ToolTipOpening attached event.

GetBetweenShowDelay(DependencyObject)

Ottiene il valore della proprietà associata BetweenShowDelay per un oggetto.Gets the value of the BetweenShowDelay attached property for an object.

GetHasDropShadow(DependencyObject)

Ottiene il valore della proprietà associata HasDropShadow per un oggetto.Gets the value of the HasDropShadow attached property for an object.

GetHorizontalOffset(DependencyObject)

Ottiene il valore della proprietà associata HorizontalOffset per un oggetto.Gets the value of the HorizontalOffset attached property for an object.

GetInitialShowDelay(DependencyObject)

Ottiene il valore della proprietà associata InitialShowDelay per un oggetto.Gets the value of the InitialShowDelay attached property for an object.

GetIsEnabled(DependencyObject)

Ottiene il valore della proprietà associata IsEnabled per un oggetto.Gets the value of the IsEnabled attached property for an object.

GetIsOpen(DependencyObject)

Ottiene il valore della proprietà associata IsOpen per un oggetto.Gets the value of the IsOpen attached property for an object.

GetPlacement(DependencyObject)

Ottiene il valore della proprietà associata Placement per un oggetto.Gets the value of the Placement attached property for an object.

GetPlacementRectangle(DependencyObject)

Ottiene il valore della proprietà associata PlacementRectangle per un oggetto.Gets the value of the PlacementRectangle attached property for an object.

GetPlacementTarget(DependencyObject)

Ottiene il valore della proprietà associata PlacementTarget per un oggetto.Gets the value of the PlacementTarget attached property for an object.

GetShowDuration(DependencyObject)

Ottiene il valore della proprietà associata ShowDuration per un oggetto.Gets the value of the ShowDuration attached property for an object.

GetShowOnDisabled(DependencyObject)

Ottiene il valore della proprietà associata ShowOnDisabled per un oggetto.Gets the value of the ShowOnDisabled attached property for an object.

GetToolTip(DependencyObject)

Ottiene il valore della proprietà associata ToolTip per un oggetto.Gets the value of the ToolTip attached property for an object.

GetVerticalOffset(DependencyObject)

Ottiene il valore della proprietà associata VerticalOffset per un oggetto.Gets the value of the VerticalOffset attached property for an object.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Rimuove un gestore per l'evento associato ToolTipClosing.Removes a handler for the ToolTipClosing attached event.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Rimuove un gestore per l'evento associato ToolTipOpening.Removes a handler for the ToolTipOpening attached event.

SetBetweenShowDelay(DependencyObject, Int32)

Imposta il valore della proprietà associata BetweenShowDelay per un oggetto.Sets the value of the BetweenShowDelay attached property for an object.

SetHasDropShadow(DependencyObject, Boolean)

Imposta il valore della proprietà associata HasDropShadow per un oggetto.Sets the value of the HasDropShadow attached property for an object.

SetHorizontalOffset(DependencyObject, Double)

Imposta il valore della proprietà associata HorizontalOffset per un oggetto.Sets the value of the HorizontalOffset attached property for an object.

SetInitialShowDelay(DependencyObject, Int32)

Imposta il valore della proprietà associata InitialShowDelay per un oggetto.Sets the value of the InitialShowDelay attached property for an object.

SetIsEnabled(DependencyObject, Boolean)

Imposta il valore della proprietà associata IsEnabled per un oggetto.Sets the value of the IsEnabled attached property for an object.

SetPlacement(DependencyObject, PlacementMode)

Imposta il valore della proprietà associata Placement per un oggetto.Sets the value of the Placement attached property for an object.

SetPlacementRectangle(DependencyObject, Rect)

Imposta il valore della proprietà associata PlacementRectangle per un oggetto.Sets the value of the PlacementRectangle attached property for an object.

SetPlacementTarget(DependencyObject, UIElement)

Imposta il valore della proprietà associata PlacementTarget per un oggetto.Sets the value of the PlacementTarget attached property for an object.

SetShowDuration(DependencyObject, Int32)

Imposta il valore della proprietà associata ShowDuration per un oggetto.Sets the value of the ShowDuration attached property for an object.

SetShowOnDisabled(DependencyObject, Boolean)

Imposta il valore della proprietà associata ShowOnDisabled per un oggetto.Sets the value of the ShowOnDisabled attached property for an object.

SetToolTip(DependencyObject, Object)

Imposta il valore della proprietà associata ToolTip per un oggetto.Sets the value of the ToolTip attached property for an object.

SetVerticalOffset(DependencyObject, Double)

Imposta il valore della proprietà associata VerticalOffset per un oggetto.Sets the value of the VerticalOffset attached property for an object.

Eventi associati

ToolTipClosing

Si verifica quando si chiude il controllo ToolTip.Occurs when the ToolTip closes.

ToolTipOpening

Si verifica all'apertura di ToolTip.Occurs when the ToolTip opens.

Si applica a

Vedi anche