ToolTip Classe

Definizione

Viene visualizzata una piccola finestra rettangolare popup contenente una breve descrizione dello scopo di un controllo quando l'utente posiziona il puntatore sopra il controllo.Represents a small rectangular pop-up window that displays a brief description of a control's purpose when the user rests the pointer on the control.

public ref class ToolTip : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider
public class ToolTip : System.ComponentModel.Component, System.ComponentModel.IExtenderProvider
type ToolTip = class
    inherit Component
    interface IExtenderProvider
Public Class ToolTip
Inherits Component
Implements IExtenderProvider
Ereditarietà
Implementazioni

Esempi

Nell'esempio di codice seguente viene creata un'istanza della classe ToolTip e l'istanza viene associata al Form in cui viene creata l'istanza.The following code example creates an instance of the ToolTip class and associates the instance with the Form that the instance is created within. Il codice inizializza quindi le proprietà delay AutoPopDelay, InitialDelaye ReshowDelay.The code then initializes the delay properties AutoPopDelay, InitialDelay, and ReshowDelay. Inoltre, l'istanza della classe ToolTip imposta la proprietà ShowAlways su true per consentire il testo della descrizione comando da visualizzare sempre, indipendentemente dal fatto che il form sia attivo.In addition the instance of the ToolTip class sets the ShowAlways property to true to enable ToolTip text to always be display regardless of whether the form is active. Infine, l'esempio associa il testo della descrizione comando a due controlli in un form, un Button e una CheckBox.Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. Per l'esempio di codice è necessario che il metodo definito nell'esempio si trovi all'interno di un Form contenente un controllo Button denominato button1 e un controllo CheckBox denominato checkBox1e che il metodo venga chiamato dal costruttore del Form.The code example requires that the method defined in the example is located within a Form that contains a Button control named button1 and a CheckBox control named checkBox1, and that the method is called from the constructor of the Form.

// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
void Form1_Load( Object^ sender, System::EventArgs^ e )
{
   // Create the ToolTip and associate with the Form container.
   ToolTip^ toolTip1 = gcnew ToolTip;
   
   // Set up the delays for the ToolTip.
   toolTip1->AutoPopDelay = 5000;
   toolTip1->InitialDelay = 1000;
   toolTip1->ReshowDelay = 500;
   // Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1->ShowAlways = true;
   
   // Set up the ToolTip text for the Button and Checkbox.
   toolTip1->SetToolTip( this->button1, "My button1" );
   toolTip1->SetToolTip( this->checkBox1, "My checkBox1" );
}
// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
private void Form1_Load(object sender, System.EventArgs e)
{
   // Create the ToolTip and associate with the Form container.
   ToolTip toolTip1 = new ToolTip();

   // Set up the delays for the ToolTip.
   toolTip1.AutoPopDelay = 5000;
   toolTip1.InitialDelay = 1000;
   toolTip1.ReshowDelay = 500;
   // Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1.ShowAlways = true;
      
   // Set up the ToolTip text for the Button and Checkbox.
   toolTip1.SetToolTip(this.button1, "My button1");
   toolTip1.SetToolTip(this.checkBox1, "My checkBox1");
}
' This example assumes that the Form_Load event handling method
' is connected to the Load event of the form.
Private Sub Form1_Load(sender As Object, e As System.EventArgs) Handles MyBase.Load
   ' Create the ToolTip and associate with the Form container.
   Dim toolTip1 As New ToolTip()
   
   ' Set up the delays for the ToolTip.
   toolTip1.AutoPopDelay = 5000
   toolTip1.InitialDelay = 1000
   toolTip1.ReshowDelay = 500
   ' Force the ToolTip text to be displayed whether or not the form is active.
   toolTip1.ShowAlways = True
   
   ' Set up the ToolTip text for the Button and Checkbox.
   toolTip1.SetToolTip(Me.button1, "My button1")
   toolTip1.SetToolTip(Me.checkBox1, "My checkBox1")
End Sub

Commenti

Con la classe ToolTip è possibile fornire suggerimenti a un utente quando l'utente posiziona il puntatore su un controllo.With the ToolTip class, you can provide hints to a user when the user places the pointer on a control. La classe ToolTip viene in genere utilizzata per avvisare gli utenti dell'utilizzo previsto di un controllo.The ToolTip class is typically used to alert users to the intended use of a control. Ad esempio, è possibile specificare il testo della descrizione comando per un controllo TextBox che accetta un nome, specificando il formato del nome da tipizzare nel controllo.For example, you can specify ToolTip text for a TextBox control that accepts a name, specifying the format of the name to be typed into the control. Oltre a fornire suggerimenti, è anche possibile usare la classe ToolTip per fornire informazioni sullo stato della fase di esecuzione.In addition to providing hints, you can also use the ToolTip class to provide run time status information. Ad esempio, è possibile usare la classe ToolTip per visualizzare la velocità di connessione e i dati di qualità della linea quando l'utente sposta il puntatore su un controllo PictureBox che visualizza lo stato della connessione Internet.For example, you can use the ToolTip class to display connection speed and line quality data when the user moves the pointer onto a PictureBox control that displays Internet connection status.

La classe ToolTip può essere usata in qualsiasi contenitore.The ToolTip class can be used in any container. Per specificare in modo esplicito un contenitore, usare il costruttore ToolTip(IContainer).To explicitly specify a container, use the ToolTip(IContainer) constructor. Un singolo componente ToolTip viene in genere usato per creare descrizioni comandi per più controlli in un unico form.A single ToolTip component typically is used to create ToolTips for multiple controls on a single form. Dopo aver creato una ToolTip, utilizzare una chiamata separata al metodo SetToolTip per associare il testo visualizzato della descrizione comando a un singolo controllo.After you create a ToolTip, use a separate call to the SetToolTip method to associate ToolTip display text to an individual control. Quando l'utente sposta il puntatore su un controllo, viene visualizzata la descrizione comando con il relativo testo.Then when the user moves the pointer on a control, the ToolTip with its text is displayed. È possibile chiamare SetToolTip più di una volta per lo stesso controllo per modificare il testo associato al controllo.You can call SetToolTip more than once for the same control to change the text that is associated with the control. Per ottenere il testo associato a un controllo, usare il metodo GetToolTip.To get the text that is associated with a control, use the GetToolTip method. Per rimuovere tutte le associazioni di testo della descrizione comando con un'istanza della classe ToolTip, usare il metodo RemoveAll.To remove all ToolTip text associations with an instance of the ToolTip class, use the RemoveAll method.

Nota

Il testo della descrizione comando non viene visualizzato per i controlli disabilitati.ToolTip text is not displayed for controls that are disabled. Se la proprietà ShowAlways non è impostata su true, le descrizioni comandi non vengono visualizzate quando il relativo contenitore è inattivo.Unless the ShowAlways property is set to true, ToolTips are not displayed when their container is inactive.

La classe ToolTip fornisce le proprietà e i metodi seguenti per modificare il comportamento predefinito e l'aspetto di una descrizione comando.The ToolTip class provides the following properties and methods to modify the default behavior and appearance of a ToolTip.

CategoryCategory Membri associatiAssociated members
Visualizzazione manualeManual display Active, Show, Hide, ShowAlways, Popup, StopTimerActive, Show, Hide, ShowAlways, Popup, StopTimer
Temporizzazione descrizione comandoToolTip timing AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimerAutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
ContenutoContent SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAllSetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll
AspettoAppearance BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFadingBackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

Se si desidera disabilitare tutto il testo della descrizione comando in modo che non possa essere visualizzato nell'applicazione, è possibile utilizzare la proprietà Active.If you want to disable all ToolTip text so that it cannot be displayed in your application, you can use the Active property. In genere, la descrizione comando viene disegnata dal sistema operativo, ma per personalizzare l'aspetto del ToolTipè possibile impostare la proprietà OwnerDraw su true e gestire l'evento Draw.Usually the ToolTip is drawn by the operating system, but to customize the appearance of the ToolTip, you can set the OwnerDraw property to true and handle the Draw event.

La classe ToolTipTitle implementa l'interfaccia System.ComponentModel.IExtenderProvider, che dispone di un solo metodo, CanExtend.The ToolTipTitle class implements the System.ComponentModel.IExtenderProvider interface, which has a single method, CanExtend. Le descrizioni comandi estendono i controlli nello stesso form in fase di progettazione, aggiungendo una proprietà ToolTip.ToolTips extend controls on the same form at design time, adding a ToolTip property. Per ulteriori informazioni sui provider Extender, vedere provider Extender.For more information about extender providers, see Extender Providers.

Costruttori

ToolTip()

Inizializza una nuova istanza della classe ToolTip senza un contenitore specificato.Initializes a new instance of the ToolTip without a specified container.

ToolTip(IContainer)

Inizializza una nuova istanza della classe ToolTip con un contenitore specificato.Initializes a new instance of the ToolTip class with a specified container.

Proprietà

Active

Ottiene o imposta un valore che indica se la descrizione comando è attiva.Gets or sets a value indicating whether the ToolTip is currently active.

AutomaticDelay

Ottiene o imposta il ritardo automatico della descrizione comando.Gets or sets the automatic delay for the ToolTip.

AutoPopDelay

Ottiene o imposta l'intervallo di visibilità della descrizione comando quando il puntatore è fermo su un controllo che contiene il testo specificato della descrizione comando.Gets or sets the period of time the ToolTip remains visible if the pointer is stationary on a control with specified ToolTip text.

BackColor

Ottiene o imposta il colore di sfondo della descrizione comando.Gets or sets the background color for the ToolTip.

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Ereditato da Component)
Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Ereditato da Component)
CreateParams

Ottiene i parametri di creazione per la finestra della descrizione comando.Gets the creation parameters for the ToolTip window.

DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Ereditato da Component)
Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Ereditato da Component)
ForeColor

Ottiene o imposta il colore di primo piano della descrizione comando.Gets or sets the foreground color for the ToolTip.

InitialDelay

Ottiene o imposta il tempo di attesa prima della visualizzazione della descrizione comando.Gets or sets the time that passes before the ToolTip appears.

IsBalloon

Ottiene o imposta un valore che indica se la descrizione comando usa una finestra a forma di fumetto.Gets or sets a value indicating whether the ToolTip should use a balloon window.

OwnerDraw

Ottiene o imposta un valore che indica se la descrizione comando deve essere creata dal sistema operativo o mediante il codice fornito.Gets or sets a value indicating whether the ToolTip is drawn by the operating system or by code that you provide.

ReshowDelay

Ottiene o imposta la quantità di tempo che deve trascorrere prima che le successive finestre della descrizione comando vengano visualizzate quando il puntatore viene spostato da un controllo all'altro.Gets or sets the length of time that must transpire before subsequent ToolTip windows appear as the pointer moves from one control to another.

ShowAlways

Ottiene o imposta un valore che indica se una finestra della descrizione comando viene visualizzata anche quando il relativo controllo padre non è attivo.Gets or sets a value indicating whether a ToolTip window is displayed, even when its parent control is not active.

Site

Ottiene o imposta l'oggetto ISite dell'oggetto Component.Gets or sets the ISite of the Component.

(Ereditato da Component)
StripAmpersands

Ottiene o imposta un valore che determina come devono essere considerati i caratteri e commerciale (&).Gets or sets a value that determines how ampersand (&) characters are treated.

Tag

Ottiene o imposta l'oggetto contenente i dati forniti dal programmatore associati all'oggetto ToolTip.Gets or sets the object that contains programmer-supplied data associated with the ToolTip.

ToolTipIcon

Ottiene o imposta un valore che definisce il tipo di icona da visualizzare unitamente al testo della descrizione comando.Gets or sets a value that defines the type of icon to be displayed alongside the ToolTip text.

ToolTipTitle

Ottiene o imposta un titolo per la finestra della descrizione comando.Gets or sets a title for the ToolTip window.

UseAnimation

Ottiene o imposta un valore che determina se usare un effetto animazione durante la visualizzazione della descrizione comando.Gets or sets a value determining whether an animation effect should be used when displaying the ToolTip.

UseFading

Ottiene o imposta un valore che determina se usare un effetto dissolvenza durante la visualizzazione della descrizione comando.Gets or sets a value determining whether a fade effect should be used when displaying the ToolTip.

Metodi

CanExtend(Object)

Restituisce true se la descrizione comandi può offrire una proprietà di estensione al componente di destinazione specificato.Returns true if the ToolTip can offer an extender property to the specified target component.

CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e facoltativamente rilascia le risorse gestite.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Finalize()

Rilascia le risorse non gestite ed esegue altre operazioni di pulizia prima che l'oggetto Cursor venga recuperato dalla procedura di Garbage Collection.Releases the unmanaged resources and performs other cleanup operations before the Cursor is reclaimed by the garbage collector.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Ereditato da Component)
GetToolTip(Control)

Recupera il testo della descrizione comando associato al controllo specificato.Retrieves the ToolTip text associated with the specified control.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
Hide(IWin32Window)

Nasconde la finestra della descrizione comando specificata.Hides the specified ToolTip window.

InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
RemoveAll()

Rimuove tutto il testo della descrizione comando attualmente associato al componente ToolTip.Removes all ToolTip text currently associated with the ToolTip component.

SetToolTip(Control, String)

Associa il testo della descrizione comando al controllo specificato.Associates ToolTip text with the specified control.

Show(String, IWin32Window)

Imposta il testo della descrizione comando associato al controllo specificato e visualizza una descrizione comando modale.Sets the ToolTip text associated with the specified control, and displays the ToolTip modally.

Show(String, IWin32Window, Int32)

Imposta il testo della descrizione comando associato al controllo specificato e visualizza la descrizione per il tempo indicato.Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration.

Show(String, IWin32Window, Int32, Int32)

Imposta il testo della descrizione comando associato al controllo specificato e la visualizza come descrizione modale nella posizione relativa indicata.Sets the ToolTip text associated with the specified control, and then displays the ToolTip modally at the specified relative position.

Show(String, IWin32Window, Int32, Int32, Int32)

Imposta il testo della descrizione comando associato al controllo specificato e la visualizza per la durata indicata nella posizione relativa specificata.Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.

Show(String, IWin32Window, Point)

Imposta il testo della descrizione comando associato al controllo specificato e la visualizza come descrizione modale nella posizione relativa indicata.Sets the ToolTip text associated with the specified control, and then displays the ToolTip modally at the specified relative position.

Show(String, IWin32Window, Point, Int32)

Imposta il testo della descrizione comando associato al controllo specificato e la visualizza per la durata indicata nella posizione relativa specificata.Sets the ToolTip text associated with the specified control, and then displays the ToolTip for the specified duration at the specified relative position.

StopTimer()

Arresta il timer che nasconde le descrizioni comandi visualizzate.Stops the timer that hides displayed ToolTips.

ToString()

Restituisce una rappresentazione in forma di stringa per il controllo.Returns a string representation for this control.

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Ereditato da Component)
Draw

Si verifica quando viene disegnata la descrizione comando e la proprietà OwnerDraw è impostata su true, mentre la proprietà IsBalloon è false.Occurs when the ToolTip is drawn and the OwnerDraw property is set to true and the IsBalloon property is false.

Popup

Si verifica prima della visualizzazione iniziale della descrizione comando.Occurs before a ToolTip is initially displayed. Questo è l'evento predefinito per la classe ToolTip.This is the default event for the ToolTip class.

Si applica a

Vedi anche