ToolTip.ShowAlways 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个值,该值指示是否显示工具提示窗口,甚至是在其父控件不活动的时候。
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
属性值
如果始终显示工具提示,则为 true
;否则为 false
。 默认值为 false
。
示例
下面的代码示例创建类的 ToolTip 实例,并将该实例与 Form 在其中创建的实例相关联。 然后,代码初始化延迟属性 AutoPopDelay, InitialDelay以及 ReshowDelay。 此外,类的 ToolTip 实例设置 ShowAlways 属性以 true
允许显示工具提示文本,而不管窗体是否处于活动状态。 最后,该示例将工具提示文本与窗体、a Button 和 a CheckBox上的两个控件相关联。 代码示例要求示例中定义的方法位于包含Button命名控件和CheckBox命名checkBox1
控件的控件内Form,并且该方法是从构造函数调用的Formbutton1
。
// 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
注解
借助该 ShowAlways 属性,即使容器 ToolTip 不处于活动状态,也可以显示工具提示窗口。 可以在无模式窗口应用程序中使用此功能,以允许显示工具提示窗口,而不管哪个无模式窗口处于活动状态。 如果要使用 UserControl 创建控件,此功能也很有用,其中包含一些显示工具提示窗口的控件。 UserControl由于窗体上通常不是活动窗口,因此true
将此属性设置为允许控件UserControl随时显示工具提示窗口。