ToolTip.ShowAlways 属性

定义

获取或设置一个值,该值指示是否显示工具提示窗口,甚至是在其父控件不活动的时候。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

属性值

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

示例

下面的代码示例创建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. 然后, 该代码初始化延迟属性AutoPopDelayInitialDelayReshowDelayThe 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. 最后, 该示例将工具提示文本与窗体上的Button两个控件 ( CheckBox和) 相关联。Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. 此代码示例要求在示例中定义的Form方法位于Button包含名为button1的控件和CheckBox名为checkBox1的控件, 并且该方法是从构造函数中调用的。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

注解

使用属性, 即使的容器ToolTip不处于活动状态, 也可以显示工具提示窗口。 ShowAlwaysWith 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. 由于在窗体上通常不true UserControl 是活动窗口,因此设置此属性将使中的控件可以随时显示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.

适用于

另请参阅