Condividi tramite


ToolTipService Classe

Definizione

Rappresenta un servizio che implementa proprietà per controllare la visualizzazione e il comportamento delle descrizioni comandi.

public ref class ToolTipService abstract sealed
public static class ToolTipService
type ToolTipService = class
Public Class ToolTipService
Ereditarietà
ToolTipService

Esempio

Nell'esempio seguente viene illustrato come usare la ToolTipService classe per specificare il comportamento di una descrizione comando. È possibile impostare le proprietà della classe associandole direttamente all'elemento ToolTipService che espone la descrizione comando.

<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

Definire una descrizione comando per un elemento impostando la FrameworkContentElement.ToolTip proprietà o FrameworkElement.ToolTip . La proprietà ToolTip accetta un elemento figlio. Il contenuto dell'elemento figlio può variare da una semplice stringa di testo a un contenuto più complesso, ad esempio un StackPanel oggetto con testo e Image elementi incorporati.

È possibile definire il contenuto della descrizione comando come ToolTip oggetto, ma questo non è obbligatorio. 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. Le proprietà associate della classe vengono usate per determinare il posizionamento, il comportamento e l'aspetto ToolTipService di una descrizione comando. Queste proprietà vengono impostate sull'elemento che definisce la descrizione comando.

La ToolTip classe e la ToolTipService classe condividono molte delle stesse proprietà usate per personalizzare una descrizione comando. Se le proprietà equivalenti ToolTip e ToolTipService sono entrambe impostate, la proprietà ha la ToolTipService precedenza. Ad esempio, se sia la proprietà che la ToolTipService.PlacementToolTip.Placement proprietà vengono impostate per un System.Windows.Controls.ToolTip oggetto, viene usato il valore della ToolTipService.Placement proprietà.

Le proprietà di intervallo seguenti ToolTipService sono definite solo per la ToolTipService classe e vengono usate da tutte le descrizioni comandi:

Per informazioni su come gestire gli eventi che si verificano quando la descrizione comando viene aperta o chiusa, vedere i ToolTipOpeningEvent campi e ToolTipClosingEvent .

Placement, PlacementRectanglePlacementTarget, , HorizontalOffsete VerticalOffset si comportano in modo analogo alle proprietà dello stesso nome nella Popup classe . Per altre informazioni, vedere Comportamento del controllo Popup in relazione al posizionamento.

Campi

BetweenShowDelayProperty

Identifica la proprietà associata BetweenShowDelay.

HasDropShadowProperty

Identifica la proprietà associata HasDropShadow.

HorizontalOffsetProperty

Identifica la proprietà associata HorizontalOffset.

InitialShowDelayProperty

Identifica la proprietà associata InitialShowDelay.

IsEnabledProperty

Identifica la proprietà associata IsEnabled.

IsOpenProperty

Identifica la proprietà associata IsOpen.

PlacementProperty

Identifica la proprietà associata Placement.

PlacementRectangleProperty

Identifica la proprietà associata PlacementRectangle.

PlacementTargetProperty

Identifica la proprietà associata PlacementTarget.

ShowDurationProperty

Identifica la proprietà associata ShowDuration.

ShowOnDisabledProperty

Identifica la proprietà associata ShowOnDisabled.

ShowsToolTipOnKeyboardFocusProperty

Rappresenta un servizio che implementa proprietà per controllare la visualizzazione e il comportamento delle descrizioni comandi.

ToolTipClosingEvent

Identifica l'evento ToolTipClosing esposto da oggetti che utilizzano il servizio ToolTipService per visualizzare le descrizioni comandi.

ToolTipOpeningEvent

Identifica l'evento ToolTipOpening esposto da oggetti che utilizzano il servizio ToolTipService per visualizzare le descrizioni comandi.

ToolTipProperty

Identifica la proprietà associata ToolTip.

VerticalOffsetProperty

Identifica la proprietà associata VerticalOffset.

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.

HasDropShadow

Ottiene o imposta se la descrizione comandi viene visualizzata con una ombreggiatura.

HorizontalOffset

Ottiene o imposta l'offset dalla parte sinistra dell'area specificata per la descrizione comando dalle proprietà PlacementRectangle e PlacementTarget.

InitialShowDelay

Ottiene o imposta l'intervallo di tempo prima dell'apertura di una descrizione comando.

IsEnabled

Ottiene o imposta se appare una descrizione comandi.

IsOpen

Indica se una descrizione comandi è attualmente visibile.

Placement

Ottiene o imposta l'orientamento della descrizione comando all'apertura e specifica il comportamento della descrizione comando in caso di sovrapposizione ai limiti dello schermo.

PlacementRectangle

Ottiene o imposta l'area rettangolare in relazione alla quale viene posizionata la descrizione comando.

PlacementTarget

Ottiene o imposta l'oggetto in relazione al quale viene posizionata la descrizione comando.

ShowDuration

Ottiene o imposta la quantità di tempo durante la quale una descrizione comando resta visibile.

ShowOnDisabled

Ottiene o imposta un valore che indica se viene visualizzata una descrizione comando per un oggetto non abilitato.

ShowsToolTipOnKeyboardFocus

Rappresenta un servizio che implementa proprietà per controllare la visualizzazione e il comportamento delle descrizioni comandi.

ToolTip

Ottiene o imposta il contenuto di una descrizione comando.

VerticalOffset

Ottiene o imposta la distanza dalla parte superiore dell'area specificata per la descrizione comando dalle proprietà PlacementRectangle e PlacementTarget.

Metodi

AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Aggiunge un gestore per l'evento associato ToolTipClosing.

AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Aggiunge un gestore per l'evento associato ToolTipOpening.

GetBetweenShowDelay(DependencyObject)

Ottiene il valore della proprietà associata BetweenShowDelay per un oggetto.

GetHasDropShadow(DependencyObject)

Ottiene il valore della proprietà associata HasDropShadow per un oggetto.

GetHorizontalOffset(DependencyObject)

Ottiene il valore della proprietà associata HorizontalOffset per un oggetto.

GetInitialShowDelay(DependencyObject)

Ottiene il valore della proprietà associata InitialShowDelay per un oggetto.

GetIsEnabled(DependencyObject)

Ottiene il valore della proprietà associata IsEnabled per un oggetto.

GetIsOpen(DependencyObject)

Ottiene il valore della proprietà associata IsOpen per un oggetto.

GetPlacement(DependencyObject)

Ottiene il valore della proprietà associata Placement per un oggetto.

GetPlacementRectangle(DependencyObject)

Ottiene il valore della proprietà associata PlacementRectangle per un oggetto.

GetPlacementTarget(DependencyObject)

Ottiene il valore della proprietà associata PlacementTarget per un oggetto.

GetShowDuration(DependencyObject)

Ottiene il valore della proprietà associata ShowDuration per un oggetto.

GetShowOnDisabled(DependencyObject)

Ottiene il valore della proprietà associata ShowOnDisabled per un oggetto.

GetShowsToolTipOnKeyboardFocus(DependencyObject)

Rappresenta un servizio che implementa proprietà per controllare la visualizzazione e il comportamento delle descrizioni comandi.

GetToolTip(DependencyObject)

Ottiene il valore della proprietà associata ToolTip per un oggetto.

GetVerticalOffset(DependencyObject)

Ottiene il valore della proprietà associata VerticalOffset per un oggetto.

RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)

Rimuove un gestore per l'evento associato ToolTipClosing.

RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)

Rimuove un gestore per l'evento associato ToolTipOpening.

SetBetweenShowDelay(DependencyObject, Int32)

Imposta il valore della proprietà associata BetweenShowDelay per un oggetto.

SetHasDropShadow(DependencyObject, Boolean)

Imposta il valore della proprietà associata HasDropShadow per un oggetto.

SetHorizontalOffset(DependencyObject, Double)

Imposta il valore della proprietà associata HorizontalOffset per un oggetto.

SetInitialShowDelay(DependencyObject, Int32)

Imposta il valore della proprietà associata InitialShowDelay per un oggetto.

SetIsEnabled(DependencyObject, Boolean)

Imposta il valore della proprietà associata IsEnabled per un oggetto.

SetPlacement(DependencyObject, PlacementMode)

Imposta il valore della proprietà associata Placement per un oggetto.

SetPlacementRectangle(DependencyObject, Rect)

Imposta il valore della proprietà associata PlacementRectangle per un oggetto.

SetPlacementTarget(DependencyObject, UIElement)

Imposta il valore della proprietà associata PlacementTarget per un oggetto.

SetShowDuration(DependencyObject, Int32)

Imposta il valore della proprietà associata ShowDuration per un oggetto.

SetShowOnDisabled(DependencyObject, Boolean)

Imposta il valore della proprietà associata ShowOnDisabled per un oggetto.

SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>)

Rappresenta un servizio che implementa proprietà per controllare la visualizzazione e il comportamento delle descrizioni comandi.

SetToolTip(DependencyObject, Object)

Imposta il valore della proprietà associata ToolTip per un oggetto.

SetVerticalOffset(DependencyObject, Double)

Imposta il valore della proprietà associata VerticalOffset per un oggetto.

Eventi associati

ToolTipClosing

Si verifica quando si chiude il controllo ToolTip.

ToolTipOpening

Si verifica all'apertura di ToolTip.

Si applica a

Vedi anche