ToolTip.SetToolTip(Control, String) Methode

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)

Parameters

Voorbeelden

In het volgende codevoorbeeld wordt een exemplaar van de ToolTip klasse gemaakt en wordt het exemplaar gekoppeld aan het Form exemplaar dat binnen is gemaakt. De code initialiseert vervolgens de vertragingseigenschappen AutoPopDelay, InitialDelayen ReshowDelay. Daarnaast stelt het exemplaar van de ToolTip klasse de ShowAlways eigenschap in om true in te schakelen dat knopinfotekst wordt weergegeven, ongeacht of het formulier actief is. Ten slotte koppelt het voorbeeld knopinfotekst aan twee besturingselementen in een formulier, a Button en a CheckBox. Voor dit voorbeeld is vereist dat de in het voorbeeld gedefinieerde methode zich bevindt in een Form besturingselement dat een Button besturingselement met de naam button1 en een CheckBox besturingselement met de naam checkBox1bevat, en dat de methode wordt aangeroepen vanuit de constructor van de 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

Opmerkingen

Naast het opgeven van de knopinfotekst die moet worden weergegeven voor een besturingselement, kunt u deze methode ook gebruiken om de knopinfotekst voor een besturingselement te wijzigen. Als u de SetToolTip methode meer dan één keer aanroept voor een bepaald besturingselement, geeft u niet meerdere knopinfotekst op die moet worden weergegeven voor een besturingselement, maar wordt de huidige tekst voor knopinfo voor het besturingselement gewijzigd. Gebruik de GetToolTip methode om de tekst van de knopinfo te bepalen die is gekoppeld aan een besturingselement tijdens runtime.

Als algemene regel moet de gebruikte tekst kort zijn; U kunt echter regeleinden invoegen met behulp van de \r\n escape-tekenreeks. Ampersands (&) in de tekst worden verwerkt zoals beschreven door de StripAmpersands eigenschap.

Zie ook

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