ToolTip Classe

Definizione

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à

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 true per consentire la visualizzazione sempre del testo della descrizione comando indipendentemente dal fatto che la maschera sia attiva. Infine, nell'esempio viene associato il testo della descrizione comando a due controlli di una maschera, un Button oggetto 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 suggerimenti, è anche possibile usare la ToolTip classe per fornire informazioni sullo stato di runtime. Ad esempio, è possibile utilizzare la ToolTip classe per visualizzare i 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 comandi 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 , usare il RemoveAll metodo .

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

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 comando estendono i controlli nella stessa maschera in fase di progettazione, aggiungendo una ToolTip proprietà . Per altre informazioni sui provider di estensione, vedere Provider extender.

Vedi anche

• ToolTipIcon
• HelpProvider
• Provider extender
• Componente Descrizione comando (Windows Form)