InstanceDisplaysText プロパティ

このツールインスタンスがテキストを表示するかどうかを返します。

シンタックス

Visual Basic

'宣言
 
Public ReadOnly Property InstanceDisplaysText As Boolean

C#

public bool InstanceDisplaysText {get;}

解説

ツールがツールバーまたはメニューに配置されたときにイメージ、テキスト、またはその両方のいずれを表示するかは、ToolPropsBase.DisplayStyle プロパティによって決まります。ツールのタイプごとにデフォルト設定は異なります。またいくつかのツールの設定は開発者またはエンドユーザーのいずれかが変更できます。

このプロパティはツールの特定のインスタンスがテキストを表示するかどうかを決定するための素早い方法を提供します。このプロパティはインスタンスのツール タイプ、その DisplayStyle 設定、ならびにツールバーまたはメニューのいずれに配置されるのかを考慮します。

使用例

Visual Basic

Imports System.Diagnostics
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinToolbars

	Private Sub Button21_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button21.Click

		Debug.WriteLine("Tool property values")

		Debug.IndentLevel += 1
		Dim toolbar As UltraToolbar
		For Each toolbar In Me.UltraToolbarsManager1.Toolbars
			Debug.WriteLine("Toolbar '" + toolbar.Key + "' tool info -----------------------")

			Debug.IndentLevel += 1

			Me.ProcessToolsCollection(toolbar.Tools)

			Debug.IndentLevel -= 1
		Next

		Debug.IndentLevel -= 1

	End Sub

	Private Sub ProcessToolsCollection(ByVal tools As ToolsCollection)

		Dim tool As ToolBase

		For Each tool In tools
			Debug.IndentLevel += 1

			' すべてのツールの共有プロパティを表示します (ToolBase から継承します)
			Debug.WriteLine("Tool #" + tool.Index.ToString() + " (Key: " + tool.Key + ") is a " + tool.GetType().Name.ToString())
			Debug.IndentLevel += 1

			Debug.WriteLine("Its default size is: " + tool.DefaultSize.ToString())
			Debug.WriteLine("Its minimum size is: " + tool.MinimumSize.ToString())

			If tool.IsControlContainer = True Then
				Debug.WriteLine("It IS a control container")
			Else
				Debug.WriteLine("It is NOT a control container")
			End If

			If tool.CanActivate = True Then
				Debug.WriteLine("It CAN be activated")
			Else
				Debug.WriteLine("It CANNOT be activated")
			End If

			If tool.ShouldDisplayToolTip = True Then
				Debug.WriteLine("It WILL display a tooltip if available")
			Else
				Debug.WriteLine("It will NOT display a tooltip")
			End If

			If Not tool.Control Is Nothing Then
				Debug.WriteLine("Its associated control is of type: " + tool.Control.GetType().Name)
			End If

			If Not tool.AttachedParentTool Is Nothing Then
				Debug.WriteLine("Its AttachedParentTool has a key of: " + tool.AttachedParentTool.Key)
			End If

			If tool.InstanceDisplaysImage = True Then
				Debug.WriteLine("It WILL display an image if one has been assigned")
			Else
				Debug.WriteLine("It will NOT display an image")
			End If

			If tool.InstanceDisplaysText = True Then
				Debug.WriteLine("It WILL display text if assigned")
			Else
				Debug.WriteLine("It will NOT display text")
			End If

			Debug.WriteLine("Its Height is: " + tool.Height.ToString())

			Debug.IndentLevel -= 1
			Debug.IndentLevel -= 1
		Next

	End Sub

C#

using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.UltraWinToolbars;

		private void button21_Click(object sender, System.EventArgs e)
		{

			Debug.WriteLine("Tool property values");

			Debug.IndentLevel++;
			foreach(UltraToolbar toolbar in this.ultraToolbarsManager1.Toolbars)
			{
				Debug.WriteLine("Toolbar '" + toolbar.Key + "' tool info -----------------------");

				Debug.IndentLevel++;

				this.ProcessToolsCollection(toolbar.Tools);

				Debug.IndentLevel--;
			}

			Debug.IndentLevel--;

		}

		private void ProcessToolsCollection(ToolsCollection tools)
		{

			foreach(ToolBase tool in tools)
			{
				Debug.IndentLevel++;

				// すべてのツールの共有プロパティを表示します (ToolBase から継承します)
				Debug.WriteLine("Tool #" + tool.Index.ToString() + " (Key: " + tool.Key + ") is a " + tool.GetType().Name.ToString());
				Debug.IndentLevel++;

				Debug.WriteLine("Its default size is: " + tool.DefaultSize.ToString());
				Debug.WriteLine("Its minimum size is: " + tool.MinimumSize.ToString());

				if (tool.IsControlContainer == true)
					Debug.WriteLine("It IS a control container");
				else
					Debug.WriteLine("It is NOT a control container");

				if (tool.CanActivate == true)
					Debug.WriteLine("It CAN be activated");
				else
					Debug.WriteLine("It CANNOT be activated");

				if (tool.ShouldDisplayToolTip == true)
					Debug.WriteLine("It WILL display a tooltip if available");
				else
					Debug.WriteLine("It will NOT display a tooltip");

				if (tool.Control != null)
					Debug.WriteLine("Its associated control is of type: " + tool.Control.GetType().Name);

				if (tool.AttachedParentTool != null)
					Debug.WriteLine("Its AttachedParentTool has a key of: " + tool.AttachedParentTool.Key);

				if (tool.InstanceDisplaysImage == true)
					Debug.WriteLine("It WILL display an image if one has been assigned");
				else
					Debug.WriteLine("It will NOT display an image");

				if (tool.InstanceDisplaysText == true)
					Debug.WriteLine("It WILL display text if assigned");
				else
					Debug.WriteLine("It will NOT display text");

				Debug.WriteLine("Its Height is: " + tool.Height.ToString());

				Debug.IndentLevel--;

				Debug.IndentLevel--;
			}

		}