ToolTip ToolTip ToolTip ToolTip Class

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

L'esempio di codice seguente crea un'istanza del ToolTip classi e associa l'istanza con il Form che l'istanza viene creata all'interno.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 la proprietà di delay AutoPopDelay, InitialDelay, e ReshowDelay.The code then initializes the delay properties AutoPopDelay, InitialDelay, and ReshowDelay. Anche l'istanza del ToolTip classe set il ShowAlways proprietà true essere sempre visualizzato indipendentemente dal fatto che il form è attivo il testo della descrizione comando.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 con due controlli in un form, un Button e un CheckBox.Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. L'esempio di codice presuppone che il metodo definito nell'esempio si trovi all'interno di un Form che contiene un Button controllo denominato button1 e un CheckBox controllo denominato checkBox1, e che il metodo viene 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 ToolTip (classe), è possibile fornire suggerimenti a un utente quando l'utente posiziona il puntatore del mouse su un controllo.With the ToolTip class, you can provide hints to a user when the user places the pointer on a control. Il ToolTip classe viene generalmente utilizzato per avvertire gli utenti per l'uso 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 TextBox controllo che accetta un nome, che specifica il formato del nome a essere digitati 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 il ToolTip classe per fornire informazioni sullo stato di runtime.In addition to providing hints, you can also use the ToolTip class to provide run time status information. Ad esempio, è possibile usare la ToolTip classe per visualizzare i dati di qualità velocità e la linea di connessione quando l'utente sposta il puntatore del mouse su un PictureBox controllo 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.

Il ToolTip classe può essere utilizzata in qualsiasi contenitore.The ToolTip class can be used in any container. Per specificare in modo esplicito un contenitore, usare il ToolTip(IContainer) costruttore.To explicitly specify a container, use the ToolTip(IContainer) constructor. Un singolo ToolTip componente viene in genere usato per creare descrizioni comando 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 un ToolTip, usare una chiamata separata al SetToolTip metodo per associare il testo di visualizzazione 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 del mouse su un controllo, verrà visualizzata la descrizione comando con il testo.Then when the user moves the pointer on a control, the ToolTip with its text is displayed. È possibile chiamare SetToolTip più volte per lo stesso controllo modificare il testo che viene 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 GetToolTip (metodo).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 del ToolTip classe, usare il RemoveAll (metodo).To remove all ToolTip text associations with an instance of the ToolTip class, use the RemoveAll method.

Nota

Testo della descrizione comando non viene visualizzato per i controlli che sono disabilitati.ToolTip text is not displayed for controls that are disabled. A meno che il ShowAlways è impostata su true, descrizioni comandi non vengono visualizzati quando il relativo contenitore è attivo.Unless the ShowAlways property is set to true, ToolTips are not displayed when their container is inactive.

Il ToolTip classe fornisce le seguenti proprietà e metodi per modificare il comportamento predefinito e l'aspetto di una descrizione comandi.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 di descrizione comandoToolTip timing AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimerAutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
ContentContent 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 possono essere visualizzato nell'applicazione, è possibile usare il Active proprietà.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 disegnato dal sistema operativo, ma per personalizzare l'aspetto del ToolTip, è possibile impostare il OwnerDraw proprietà true e gestire il Draw evento.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.

Il ToolTipTitle classe implementa le System.ComponentModel.IExtenderProvider interfaccia che dispone di un singolo 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, aggiunta di un ToolTip proprietà.ToolTips extend controls on the same form at design time, adding a ToolTip property. Per altre informazioni sui provider di estensione, vedere provider di estensione.For more information about extender providers, see Extender Providers.

Costruttori

ToolTip() ToolTip() ToolTip() 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) ToolTip(IContainer) ToolTip(IContainer) 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 Active Active Active

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

AutomaticDelay AutomaticDelay AutomaticDelay AutomaticDelay

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

AutoPopDelay AutoPopDelay AutoPopDelay AutoPopDelay

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

BackColor BackColor BackColor BackColor

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

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
Container Container Container Container

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

(Inherited from Component)
CreateParams CreateParams CreateParams CreateParams

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

DesignMode DesignMode DesignMode 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.

(Inherited from Component)
Events Events Events Events

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

(Inherited from Component)
ForeColor ForeColor ForeColor ForeColor

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

InitialDelay InitialDelay InitialDelay InitialDelay

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

IsBalloon IsBalloon IsBalloon IsBalloon

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

OwnerDraw OwnerDraw OwnerDraw OwnerDraw

Ottiene o imposta un valore che indica se la descrizione comandi 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 ReshowDelay ReshowDelay ReshowDelay

Ottiene o imposta la quantità di tempo che deve trascorrere prima che le successive finestre della descrizione comandi 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 ShowAlways ShowAlways ShowAlways

Ottiene o imposta un valore che indica se una finestra della descrizione comandi 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 Site Site Site

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

(Inherited from Component)
StripAmpersands StripAmpersands StripAmpersands 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 Tag Tag 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 ToolTipIcon ToolTipIcon ToolTipIcon

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

ToolTipTitle ToolTipTitle ToolTipTitle ToolTipTitle

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

UseAnimation UseAnimation UseAnimation UseAnimation

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

UseFading UseFading UseFading UseFading

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

Metodi

CanExtend(Object) CanExtend(Object) CanExtend(Object) 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) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
Finalize() Finalize() Finalize() 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() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) 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.

(Inherited from Component)
GetToolTip(Control) GetToolTip(Control) GetToolTip(Control) GetToolTip(Control)

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

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
Hide(IWin32Window) Hide(IWin32Window) Hide(IWin32Window) Hide(IWin32Window)

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

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
RemoveAll() RemoveAll() RemoveAll() RemoveAll()

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

SetToolTip(Control, String) SetToolTip(Control, String) SetToolTip(Control, String) SetToolTip(Control, String)

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

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

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

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

Imposta il testo della descrizione comandi 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) Show(String, IWin32Window, Int32, Int32) Show(String, IWin32Window, Int32, Int32) Show(String, IWin32Window, Int32, Int32)

Imposta il testo della descrizione comandi 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) Show(String, IWin32Window, Int32, Int32, Int32) Show(String, IWin32Window, Int32, Int32, Int32) Show(String, IWin32Window, Int32, Int32, Int32)

Imposta il testo della descrizione comandi 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) Show(String, IWin32Window, Point) Show(String, IWin32Window, Point) Show(String, IWin32Window, Point)

Imposta il testo della descrizione comandi 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) Show(String, IWin32Window, Point, Int32) Show(String, IWin32Window, Point, Int32) Show(String, IWin32Window, Point, Int32)

Imposta il testo della descrizione comandi 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() StopTimer() StopTimer() StopTimer()

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

ToString() ToString() ToString() ToString()

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

Eventi

Disposed Disposed Disposed 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.

(Inherited from Component)
Draw Draw Draw 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 Popup Popup Popup

Viene generato prima della visualizzazione iniziale della descrizione comandi.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