Enabled プロパティ (UltraToolTipInfo)

マウスをコントロールに置いた時にツールチップが表示されるかどうかを取得または設定します。

シンタックス

Visual Basic

'宣言
 
Public Property Enabled As DefaultableBoolean

C#

public DefaultableBoolean Enabled {get; set;}

解説

このプロパティのデフォルト設定は DefaultableBoolean.Default です。デフォルトでは、マウスがコントロール上の同じ位置に静止し、UltraToolTipManager.InitialDelay プロパティによって指定された時間が経過したときに、ツールヒントが表示されます。デフォルトでツールチップは、ToolTipText が設定されている場合にのみ表示されます。

DefaultableBoolean.False に設定すると、ツールチップは表示されません。

DefaultableBoolean.True の設定では、ToolTipText が設定されていない場合でもツールチップを表示できます。これは、イメージのみのツールチップや、イメージとタイトルだけでテキストのないツールチップなどを表示する場合に便利です。

UltraToolTipManager コンポーネントの UltraToolTipManager.Enabled プロパティが False に設定されている場合は、このプロパティの設定にかかわらず、ツールチップは表示されません。

使用例

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.UltraWinToolTip

Private Sub InitializeToolTipInfo()
        ' Get the ToolTipInfo for TextBox1
        Dim toolTipInfo As UltraToolTipInfo = Me.UltraToolTipManager1.GetUltraToolTip(Me.TextBox1)

        ' Apply an image
        toolTipInfo.ToolTipImage = ToolTipImage.Custom
        toolTipInfo.Appearance.Image = Bitmap.FromFile("C:\Images\ToolTipImage.bmp")

        ' Normally, a tooltip will not display unless the ToolTipText has been set. 
        ' However, you can force a tooltip to display without text by
        ' explicitly setting Enabled to True. 
        toolTipInfo.Enabled = DefaultableBoolean.True
End Sub

C#

using Infragistics.Win;
using Infragistics.Win.UltraWinToolTip;

private void InitializeToolTipInfo()
{
	// Get the ToolTipInfo for TextBox1
	UltraToolTipInfo toolTipInfo = this.ultraToolTipManager1.GetUltraToolTip(this.textBox1);
				
	// Apply an image
	toolTipInfo.ToolTipImage = ToolTipImage.Custom;
	toolTipInfo.Appearance.Image = Bitmap.FromFile(@"C:\Images\ToolTipImage.bmp");			
			
	// Normally, a tooltip will not display unless the ToolTipText has been set. 
	// However, you can force a tooltip to display without text by
	// explicitly setting Enabled to True. 
	toolTipInfo.Enabled = DefaultableBoolean.True;
}