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. 既定では、 falseです。The 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. 次に、遅延プロパティ AutoPopDelayInitialDelay、および ReshowDelayを初期化します。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. 最後に、フォームの2つのコントロール、ButtonCheckBoxにツールヒントテキストを関連付けます。Finally, the example associates ToolTip text with two controls on a form, a Button and a CheckBox. このコード例では、例で定義されているメソッドが、button1 という名前の Button コントロールと checkBox1という名前の CheckBox コントロールを含む 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

注釈

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.

適用対象

こちらもご覧ください