ToolTip.SetToolTip(Control, String) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

使工具提示文本与指定的控件相关联。

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)

参数

control

Control

要将工具提示文本与其关联的 Control。

caption

String

指针位于控件上方时要显示的工具提示文本。

示例

下面的代码示例创建 类的实例， ToolTip 并将实例与 Form 在其中创建实例的 关联。 然后，代码初始化延迟属性 AutoPopDelay、 InitialDelay和 ReshowDelay。 此外， 类的 ToolTip 实例将 ShowAlways 属性设置为 ， true 以便无论窗体是否处于活动状态，都可以显示工具提示文本。 最后，该示例将工具提示文本与窗体上的两个控件（和 ButtonCheckBox）相关联。 此示例要求示例中定义的方法位于 包含名为 的控件和CheckBox名为 的checkBox1控件的 中，并且该方法是从 的构造函数调用的Form。button1ButtonForm

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

注解

除了指定要为控件显示的工具提示文本外，还可以使用此方法修改控件的工具提示文本。 SetToolTip多次为给定控件调用 方法不会指定要为控件显示的多个工具提示文本，而是更改控件的当前工具提示文本。 若要确定在运行时与控件关联的工具提示文本，请使用 GetToolTip 方法。

作为一般规则，使用的文本应简短：但是，可以使用转义字符序列插入换行符 \r\n 。 文本中的和号 (&) 按 属性所述 StripAmpersands 进行处理。

另请参阅

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