ToolTip.SetToolTip(Control, String) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ordnet QuickInfo-Text dem angegebenen Steuerelement zu.

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

public void SetToolTip (System.Windows.Forms.Control control, 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)

Parameter

control: Control

Das Control, dem der QuickInfo-Text zugeordnet werden soll.

caption: String

Der QuickInfo-Text, der angezeigt wird, wenn sich der Zeiger auf dem Steuerelement befindet.

Beispiele

Im folgenden Codebeispiel wird eine instance der ToolTip -Klasse erstellt und der instance zugeordnet, in Form der die instance erstellt wird. Der Code initialisiert dann die Verzögerungseigenschaften AutoPopDelay, InitialDelayund ReshowDelay. Darüber hinaus legt der instance der ToolTip -Klasse die ShowAlways -Eigenschaft auf festtrue, damit QuickInfo-Text unabhängig davon angezeigt werden kann, ob das Formular aktiv ist. Schließlich ordnet das Beispiel QuickInfo-Text zwei Steuerelementen in einem Formular zu, einem Button und einem CheckBox. Dieses Beispiel erfordert, dass sich die im Beispiel definierte Methode in einem Form befindet, das ein Button Steuerelement namens button1 und ein CheckBox Steuerelement mit dem Namen checkBox1enthält, und dass die -Methode vom -Konstruktor des Formaufgerufen wird.

// 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

Hinweise

Zusätzlich zum Angeben des QuickInfo-Texts, der für ein Steuerelement angezeigt werden soll, können Sie diese Methode auch verwenden, um den QuickInfo-Text für ein Steuerelement zu ändern. Wenn Sie die SetToolTip -Methode mehrmals für ein bestimmtes Steuerelement aufrufen, werden nicht mehrere QuickInfo-Text angegeben, der für ein Steuerelement angezeigt werden soll, sondern der aktuelle QuickInfo-Text für das Steuerelement wird geändert. Verwenden Sie die -Methode, um den QuickInfo-Text zu bestimmen, der GetToolTip einem Steuerelement zur Laufzeit zugeordnet ist.

In der Regel sollte der verwendete Text kurz sein; Sie können jedoch Zeilenumbrüche einfügen, indem Sie die \r\n Escapezeichensequenz verwenden. Ampersands (&) im Text werden wie von der StripAmpersands -Eigenschaft beschrieben behandelt.

Gilt für:

Freigeben über