ToolTipService Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à: Object
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.Placement ToolTip.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, PlacementRectangle PlacementTarget, , 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