ToolTip.ShowAlways Property

Definition

获取或设置一个值,该值指示是否显示工具提示窗口,甚至是在其父控件不活动的时候。Gets or sets a value indicating whether a ToolTip window is displayed, even when its parent control is not active.

public:
 property bool ShowAlways { bool get(); void set(bool value); };
public bool ShowAlways { get; set; }
member this.ShowAlways : bool with get, set
Public Property ShowAlways As Boolean

Property Value

Boolean

如果始终显示工具提示,则为 true;否则为 falsetrue if the ToolTip is always displayed; otherwise, false. 默认为 falseThe default is false.

Examples

下面的代码示例创建 ToolTip 类的实例,并将该实例与在其中创建该实例的 Form 相关联。The following code example creates an instance of the ToolTip class and associates the instance with the Form that the instance is created within. 然后,该代码将 AutoPopDelayInitialDelayReshowDelay初始化延迟属性。The code then initializes the delay properties AutoPopDelay, InitialDelay, and ReshowDelay. 此外,ToolTip 类的实例将 ShowAlways 属性设置为 true,以启用显示工具提示文本,而不管窗体是否处于活动状态。In addition the instance of the ToolTip class sets the ShowAlways property to true to enable ToolTip text to be displayed regardless of whether the form is active. 最后,该示例将工具提示文本与窗体上的两个控件、ButtonCheckBox相关联。Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. 此代码示例要求在示例中定义的方法位于包含名为 button1Button 控件和名为 checkBox1CheckBox 控件的 Form,以及从 Form的构造函数中调用方法。The code example requires that the method defined in the example is located within a Form that contains a Button control named button1 and a CheckBox control named checkBox1, and that the method is called from the constructor of the 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

Remarks

使用 ShowAlways 属性,即使 ToolTip 的容器不处于活动状态,也可以显示 "工具提示" 窗口。With the ShowAlways property, you can display a ToolTip window even when the container of the ToolTip is not active. 在无模式窗口应用程序中,可以使用此功能来启用工具提示窗口,而不管哪个无模式窗口处于活动状态。You can use this feature in a modeless window application to enable ToolTip windows to be displayed regardless of which modeless window is active. 如果要使用 UserControl创建控件(其中包含多个显示工具提示窗口的控件),此功能也很有用。This feature is also useful when you want to create a control by using the UserControl, which contains a number of controls within it that display ToolTip windows. 由于 UserControl 通常不是窗体上的活动窗口,因此将此属性设置为 "true 使 UserControl 内的控件可以随时显示工具提示窗口。Because the UserControl is often not the active window on a form, setting this property to true enables the controls within the UserControl to display ToolTip windows at any time.

Applies to

See also