ToolTip Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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.

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à

Object

MarshalByRefObject

Component

ToolTip

Implementazioni

IExtenderProvider

Esempio

Nell'esempio di codice seguente viene creata un'istanza della ToolTip classe e viene associata l'istanza all'oggetto Form in cui viene creata l'istanza. Il codice inizializza quindi le proprietà AutoPopDelaydi ritardo , InitialDelaye ReshowDelay. Inoltre, l'istanza della ToolTip classe imposta la ShowAlways proprietà su per true consentire la visualizzazione sempre del testo della descrizione comando indipendentemente dal fatto che il modulo sia attivo. Infine, l'esempio associa il testo della descrizione comando a due controlli di una maschera, un oggetto Button e un oggetto CheckBox. L'esempio di codice richiede che il metodo definito nell'esempio si trovi all'interno di un Form oggetto che contiene un Button controllo denominato e un CheckBox controllo denominato button1checkBox1e che il metodo viene chiamato dal costruttore di 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 su un controllo. La ToolTip classe viene in genere usata per avvisare gli utenti dell'uso previsto di un controllo. Ad esempio, è possibile specificare il testo della descrizione comando per un TextBox controllo che accetta un nome, specificando il formato del nome da digitare nel controllo. Oltre a fornire hint, è anche possibile usare la ToolTip classe per fornire informazioni sullo stato di runtime. Ad esempio, è possibile utilizzare la classe per visualizzare i ToolTip dati relativi alla velocità di connessione e alla qualità della linea quando l'utente sposta il puntatore in un PictureBox controllo che visualizza lo stato della connessione Internet.

La ToolTip classe può essere usata in qualsiasi contenitore. Per specificare in modo esplicito un contenitore, usare il ToolTip(IContainer) costruttore . Un singolo ToolTip componente viene in genere usato per creare descrizioni comando per più controlli in un singolo modulo. Dopo aver creato un ToolTipoggetto , usare una chiamata separata al metodo per associare il SetToolTip testo visualizzato della descrizione comando a un singolo controllo. Quindi, quando l'utente sposta il puntatore su un controllo, viene visualizzata la descrizione comando con il relativo testo. È possibile chiamare SetToolTip più volte per lo stesso controllo per modificare il testo associato al controllo. Per ottenere il testo associato a un controllo, utilizzare il GetToolTip metodo . Per rimuovere tutte le associazioni di testo della descrizione comando con un'istanza della ToolTip classe , utilizzare il RemoveAll metodo .

Nota

Il testo della descrizione comando non viene visualizzato per i controlli disabilitati. A meno che la ShowAlways proprietà non sia impostata su true, le descrizioni comando non vengono visualizzate quando il contenitore è inattivo.

La ToolTip classe fornisce le proprietà e i metodi seguenti per modificare il comportamento predefinito e l'aspetto di una descrizione comando.

Category	Membri associati
Visualizzazione manuale	Active, Show, Hide, ShowAlways, Popup, StopTimer
Intervallo descrizione comando	AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer
Contenuto	SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle, RemoveAll
Aspetto	BackColor, 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 usare la Active proprietà . In genere la descrizione comando viene disegnata dal sistema operativo, ma per personalizzare l'aspetto di ToolTip, è possibile impostare la OwnerDraw proprietà su true e gestire l'evento Draw .

La ToolTipTitle classe implementa l'interfaccia System.ComponentModel.IExtenderProvider , che ha un singolo metodo, CanExtend. Le descrizioni comandi estendono i controlli nella stessa maschera in fase di progettazione, aggiungendo una ToolTip proprietà . Per altre informazioni sui provider extender, vedere Extender Providers.For more information about extender providers, see Extender Providers.

Costruttori

ToolTip()	Inizializza una nuova istanza della classe ToolTip senza un contenitore specificato.
ToolTip(IContainer)	Inizializza una nuova istanza della classe ToolTip con un contenitore specificato.

Proprietà

Active	Ottiene o imposta un valore che indica se la descrizione comando è attiva.
AutomaticDelay	Ottiene o imposta il ritardo automatico della descrizione comando.
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.
BackColor	Ottiene o imposta il colore di sfondo della descrizione comando.
CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
CreateParams	Ottiene i parametri di creazione per la finestra della descrizione comando.
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
ForeColor	Ottiene o imposta il colore di primo piano della descrizione comando.
InitialDelay	Ottiene o imposta il tempo di attesa prima della visualizzazione della descrizione comando.
IsBalloon	Ottiene o imposta un valore che indica se la descrizione comando usa una finestra a forma di fumetto.
OwnerDraw	Ottiene o imposta un valore che indica se la descrizione comando deve essere creata dal sistema operativo o mediante il codice fornito.
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.
ShowAlways	Ottiene o imposta un valore che indica se una finestra della descrizione comando viene visualizzata anche quando il relativo controllo padre non è attivo.
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
StripAmpersands	Ottiene o imposta un valore che determina come devono essere considerati i caratteri e commerciale (&).
Tag	Ottiene o imposta l'oggetto contenente i dati forniti dal programmatore associati all'oggetto ToolTip.
ToolTipIcon	Ottiene o imposta un valore che definisce il tipo di icona da visualizzare unitamente al testo della descrizione comando.
ToolTipTitle	Ottiene o imposta un titolo per la finestra della descrizione comando.
UseAnimation	Ottiene o imposta un valore che determina se usare un effetto animazione durante la visualizzazione della descrizione comando.
UseFading	Ottiene o imposta un valore che determina se usare un effetto dissolvenza durante la visualizzazione della descrizione comando.

Metodi

CanExtend(Object)	Restituisce true se la descrizione comandi può offrire una proprietà di estensione al componente di destinazione specificato.
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. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (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.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetToolTip(Control)	Recupera il testo della descrizione comando associato al controllo specificato.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Hide(IWin32Window)	Nasconde la finestra della descrizione comando specificata.
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
RemoveAll()	Rimuove tutto il testo della descrizione comando attualmente associato al componente ToolTip.
SetToolTip(Control, String)	Associa il testo della descrizione comando al controllo specificato.
Show(String, IWin32Window)	Imposta il testo della descrizione comando associato al controllo specificato e visualizza una descrizione comando modale.
Show(String, IWin32Window, Int32)	Imposta il testo della descrizione comando associato al controllo specificato e visualizza la descrizione per il tempo indicato.
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.
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.
Show(String, IWin32Window, Point)	Imposta il testo della descrizione comando associato al controllo specificato e la visualizza come descrizione modale nella posizione relativa indicata.
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.
StopTimer()	Arresta il timer che nasconde le descrizioni comandi visualizzate.
ToString()	Restituisce una rappresentazione in forma di stringa per il controllo.

Eventi

Disposed	Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component)
Draw	Si verifica quando viene disegnata la descrizione comando e la proprietà OwnerDraw è impostata su true, mentre la proprietà IsBalloon è false.
Popup	Si verifica prima della visualizzazione iniziale della descrizione comando. Questo è l'evento predefinito per la classe ToolTip.

Vedi anche

• ToolTipIcon
• HelpProvider
• Provider di estensione
• Componente ToolTip (Windows Form)