Condividi tramite


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.

public ref class ToolTip sealed : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider
public ref class ToolTip : System::ComponentModel::Component, System::ComponentModel::IExtenderProvider
public sealed 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 NotInheritable Class ToolTip
Inherits Component
Implements IExtenderProvider
Public Class ToolTip
Inherits Component
Implements IExtenderProvider
Ereditarietà
Implementazioni

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.

Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite.

(Ereditato da Component)
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()
Obsoleti.

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

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.

Si applica a

Vedi anche