ToolTip.SetToolTip(Control, String) Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Associa il testo della descrizione comando al controllo specificato.

public:
 void SetToolTip(System::Windows::Forms::Control ^ control, System::String ^ caption);

public void SetToolTip (System.Windows.Forms.Control control, string? caption);

member this.SetToolTip : System.Windows.Forms.Control * string -> unit

Public Sub SetToolTip (control As Control, caption As String)

Parametri

control

Control

Oggetto Control cui associare il testo della descrizione comandi.

caption

String

Testo della descrizione comandi da visualizzare quando il puntatore si trova sul controllo.

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 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. In questo esempio è necessario 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

Oltre a specificare il testo della descrizione comando da visualizzare per un controllo, è anche possibile utilizzare questo metodo per modificare il testo della descrizione comando per un controllo . La chiamata al SetToolTip metodo più volte per un determinato controllo non specifica più testo della descrizione comando da visualizzare per un controllo, ma modifica invece il testo della descrizione comando corrente per il controllo. Per determinare il testo della descrizione comando associato a un controllo in fase di esecuzione, utilizzare il GetToolTip metodo .

Come regola generale, il testo utilizzato deve essere breve; Tuttavia, è possibile inserire interruzioni di riga usando la \r\n sequenza di caratteri di escape. Le e commerciale (&) nel testo vengono gestite come descritto dalla StripAmpersands proprietà .

Vedi anche

• GetToolTip(Control)
• StripAmpersands
• ToString()
• ToolTipTitle
• Tag