ToolTipService Classe

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 fornisce proprietà ed eventi per controllare la visualizzazione e il comportamento delle descrizioni comando.

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. Per impostare le proprietà della ToolTipService classe, associarle direttamente all'elemento 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

Per definire una descrizione comando per un elemento, impostare la FrameworkContentElement.ToolTip proprietà o FrameworkElement.ToolTip . La proprietà ToolTip accetta un elemento figlio. Il contenuto dell'elemento figlio può variare da una stringa di testo semplice 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 ToolTipService classe vengono usate per determinare la posizione, il comportamento e l'aspetto 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 e ToolTipService sono entrambe ToolTip impostate, la proprietà ha la ToolTipService precedenza. Ad esempio, se sia la ToolTip.Placement proprietà che la ToolTipService.Placement proprietà vengono impostate per un System.Windows.Controls.ToolTip oggetto, viene utilizzato 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 comando:

Per informazioni su come gestire gli eventi che si verificano all'apertura o alla chiusura della descrizione comando, vedere i ToolTipOpeningEvent campi e ToolTipClosingEvent .

Placement, PlacementRectangle, HorizontalOffset, e VerticalOffset si comportano in modo analogo alle proprietà dello stesso nome nella Popup classe . PlacementTarget Per maggiori informazioni, vedere Comportamento di posizionamento popup.

Campi

Nome	Descrizione
BetweenShowDelayProperty	Identifica la BetweenShowDelay proprietà associata.
HasDropShadowProperty	Identifica la HasDropShadow proprietà associata.
HorizontalOffsetProperty	Identifica la HorizontalOffset proprietà associata.
InitialShowDelayProperty	Identifica la InitialShowDelay proprietà associata.
IsEnabledProperty	Identifica la IsEnabled proprietà associata.
IsOpenProperty	Identifica la IsOpen proprietà associata.
PlacementProperty	Identifica la Placement proprietà associata.
PlacementRectangleProperty	Identifica la PlacementRectangle proprietà associata.
PlacementTargetProperty	Identifica la PlacementTarget proprietà associata.
ShowDurationProperty	Identifica la ShowDuration proprietà associata.
ShowOnDisabledProperty	Identifica la ShowOnDisabled proprietà associata.
ShowsToolTipOnKeyboardFocusProperty	Rappresenta un servizio che fornisce proprietà ed eventi per controllare la visualizzazione e il comportamento delle descrizioni comando.
ToolTipClosingEvent	Identifica l'evento ToolTipClosing esposto da oggetti che utilizzano il ToolTipService servizio per visualizzare le descrizioni comando.
ToolTipOpeningEvent	Identifica l'evento ToolTipOpening esposto da oggetti che utilizzano il ToolTipService servizio per visualizzare le descrizioni comando.
ToolTipProperty	Identifica la ToolTip proprietà associata.
VerticalOffsetProperty	Identifica la VerticalOffset proprietà associata.

Proprietà associate

Nome	Descrizione
BetweenShowDelay	Ottiene o imposta il tempo massimo tra la visualizzazione di due descrizioni comando in cui viene visualizzata la seconda descrizione comando senza alcun ritardo.
HasDropShadow	Ottiene o imposta un valore che indica se la descrizione comando visualizza un effetto ombreggiatura.
HorizontalOffset	Ottiene o imposta l'offset a sinistra dell'area specificata per la descrizione comando dalle PlacementRectangle proprietà e PlacementTarget .
InitialShowDelay	Ottiene o imposta il periodo di tempo prima dell'apertura di una descrizione comando.
IsEnabled	Ottiene o imposta un valore che indica se viene visualizzata una descrizione comando.
IsOpen	Ottiene un valore che indica se una descrizione comando è attualmente visibile.
Placement	Ottiene o imposta l'orientamento della descrizione comando all'apertura e specifica il comportamento della descrizione comando quando si sovrappone ai limiti dello schermo.
PlacementRectangle	Ottiene o imposta l'area rettangolare relativa alla quale è posizionata la descrizione comando.
PlacementTarget	Ottiene o imposta l'oggetto relativo al quale è posizionata la descrizione comando.
ShowDuration	Ottiene o imposta la quantità di tempo in cui una descrizione comando rimane 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 fornisce proprietà ed eventi per controllare la visualizzazione e il comportamento delle descrizioni comando.
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 in base alle PlacementRectangle proprietà e PlacementTarget .

Metodi

Nome	Descrizione
AddToolTipClosingHandler(DependencyObject, ToolTipEventHandler)	Aggiunge un gestore per l'evento ToolTipClosing associato.
AddToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)	Aggiunge un gestore per l'evento ToolTipOpening associato.
GetBetweenShowDelay(DependencyObject)	Ottiene il valore della BetweenShowDelay proprietà associata per un oggetto .
GetHasDropShadow(DependencyObject)	Ottiene il valore della HasDropShadow proprietà associata per un oggetto .
GetHorizontalOffset(DependencyObject)	Ottiene il valore della HorizontalOffset proprietà associata per un oggetto .
GetInitialShowDelay(DependencyObject)	Ottiene il valore della InitialShowDelay proprietà associata per un oggetto .
GetIsEnabled(DependencyObject)	Ottiene il valore della IsEnabled proprietà associata per un oggetto .
GetIsOpen(DependencyObject)	Ottiene il valore della IsOpen proprietà associata per un oggetto .
GetPlacement(DependencyObject)	Ottiene il valore della Placement proprietà associata per un oggetto .
GetPlacementRectangle(DependencyObject)	Ottiene il valore della PlacementRectangle proprietà associata per un oggetto .
GetPlacementTarget(DependencyObject)	Ottiene il valore della PlacementTarget proprietà associata per un oggetto .
GetShowDuration(DependencyObject)	Ottiene il valore della ShowDuration proprietà associata per un oggetto .
GetShowOnDisabled(DependencyObject)	Ottiene il valore della ShowOnDisabled proprietà associata per un oggetto .
GetShowsToolTipOnKeyboardFocus(DependencyObject)	Rappresenta un servizio che fornisce proprietà ed eventi per controllare la visualizzazione e il comportamento delle descrizioni comando.
GetToolTip(DependencyObject)	Ottiene il valore della ToolTip proprietà associata per un oggetto .
GetVerticalOffset(DependencyObject)	Ottiene il valore della VerticalOffset proprietà associata per un oggetto .
RemoveToolTipClosingHandler(DependencyObject, ToolTipEventHandler)	Rimuove un gestore per l'evento ToolTipClosing associato.
RemoveToolTipOpeningHandler(DependencyObject, ToolTipEventHandler)	Rimuove un gestore per l'evento ToolTipOpening associato.
SetBetweenShowDelay(DependencyObject, Int32)	Imposta il valore della BetweenShowDelay proprietà associata per un oggetto .
SetHasDropShadow(DependencyObject, Boolean)	Imposta il valore della HasDropShadow proprietà associata per un oggetto .
SetHorizontalOffset(DependencyObject, Double)	Imposta il valore della HorizontalOffset proprietà associata per un oggetto .
SetInitialShowDelay(DependencyObject, Int32)	Imposta il valore della InitialShowDelay proprietà associata per un oggetto .
SetIsEnabled(DependencyObject, Boolean)	Imposta il valore della IsEnabled proprietà associata per un oggetto .
SetPlacement(DependencyObject, PlacementMode)	Imposta il valore della Placement proprietà associata per un oggetto .
SetPlacementRectangle(DependencyObject, Rect)	Imposta il valore della PlacementRectangle proprietà associata per un oggetto .
SetPlacementTarget(DependencyObject, UIElement)	Imposta il valore della PlacementTarget proprietà associata per un oggetto .
SetShowDuration(DependencyObject, Int32)	Imposta il valore della ShowDuration proprietà associata per un oggetto .
SetShowOnDisabled(DependencyObject, Boolean)	Imposta il valore della ShowOnDisabled proprietà associata per un oggetto .
SetShowsToolTipOnKeyboardFocus(DependencyObject, Nullable<Boolean>)	Rappresenta un servizio che fornisce proprietà ed eventi per controllare la visualizzazione e il comportamento delle descrizioni comando.
SetToolTip(DependencyObject, Object)	Imposta il valore della ToolTip proprietà associata per un oggetto .
SetVerticalOffset(DependencyObject, Double)	Imposta il valore della VerticalOffset proprietà associata per un oggetto .

Eventi associati

Nome	Descrizione
ToolTipClosing	Si verifica quando l'oggetto ToolTip viene chiuso.
ToolTipOpening	Si verifica all'apertura dell'oggetto ToolTip .

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?