UltraExplorerBarItem クラス

UltraExplorerBarItem オブジェクトは、UltraWinExplorerBar グループ内の項目を表します。Item はメニュー項目に似たインターフェイス 要素で、クリックしたときにプログラム内のアクションが呼び出されます。Item はアイコンと、項目の機能を説明するテキスト文字列から構成されます。Item には、標準のアイコンとラベルの外観の他に、状態 (トグル) ボタンやセパレーターなどのあらかじめ定義された外観のいずれかを設定できます。

Item の詳細な外観の多くは、その項目を含む Group の設定によって決まります。 (通常これらの設定は GroupSettings オブジェクトから取得されます)。たとえば、Group レベルの設定によって、項目のアイコンの大小や、テキストとアイコンの相対的な位置などが決まります。また、Item はコントロールでない点に注意してください。UltraWinExplorerBar の Group に WinForms コントロールを配置できますが、そうすると Group 内に存在する Item がすべて非表示になります。Item と WinForms コントロールは、1 つの Group 内で相互排他的です。

シンタックス

Visual Basic

'宣言
 
Public Class UltraExplorerBarItem 
   Inherits Infragistics.Shared.KeyedSubObjectBase
   Implements Infragistics.Shared.IKeyedSubObject, Infragistics.Shared.IKeyedSubObjectEx, Infragistics.Shared.ISelectableItem, Infragistics.Win.Notifications.INotificationBadgeProvider 

C#

public class UltraExplorerBarItem : Infragistics.Shared.KeyedSubObjectBase, Infragistics.Shared.IKeyedSubObject, Infragistics.Shared.IKeyedSubObjectEx, Infragistics.Shared.ISelectableItem, Infragistics.Win.Notifications.INotificationBadgeProvider  

使用例

Visual Basic

Imports System.Diagnostics
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinExplorerBar


	Private Sub Button88_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button88.Click

		' Add items to the Items collection using the different overloads.


		' Can't proceed unless we have at least 1 group.
		If (Me.ultraExplorerBar1.Groups.Count < 1) Then
			Return
		End If


		' Items.Add()
		Dim item As UltraExplorerBarItem = Me.ultraExplorerBar1.Groups(0).Items.Add()

		item.Text = "FirstItemAdded"


		' Items.Add(UltraExplorerBarItem item)
		item = New UltraExplorerBarItem("SecondItemKey")
		item.Text = "SecondItemAdded"

		Dim index As Integer = Me.ultraExplorerBar1.Groups(0).Items.Add(item)


		' Items.Add(string Key, string Text)
		item = Me.ultraExplorerBar1.Groups(0).Items.Add("ThirdItemKey", "ThirdItem")


		' Items.Add(string Key)
		item = Me.ultraExplorerBar1.Groups(0).Items.Add("FourthItemKey")


		' Items.Add(string Key)
		Dim item1 As UltraExplorerBarItem = New UltraExplorerBarItem()
		Dim item2 As UltraExplorerBarItem = New UltraExplorerBarItem()
		Dim item3 As UltraExplorerBarItem = New UltraExplorerBarItem()
		Dim item4 As UltraExplorerBarItem = New UltraExplorerBarItem()

		Me.ultraExplorerBar1.Groups(0).Items.AddRange(New UltraExplorerBarItem() {item1, item2, item3, item4})

	End Sub

C#

using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.UltraWinExplorerBar;


		private void button88_Click(object sender, System.EventArgs e)
		{
			// Add items to the Items collection using the different overloads.


			// Can't proceed unless we have at least 1 group.
			if (this.ultraExplorerBar1.Groups.Count < 1)
				return;


			// Items.Add()
			UltraExplorerBarItem item = this.ultraExplorerBar1.Groups[0].Items.Add();

			item.Text = "FirstItemAdded";


			// Items.Add(UltraExplorerBarItem item)
			item		= new UltraExplorerBarItem("SecondItemKey");
			item.Text	= "SecondItemAdded";

			int index	= this.ultraExplorerBar1.Groups[0].Items.Add(item);


			// Items.Add(string Key, string Text)
			item = this.ultraExplorerBar1.Groups[0].Items.Add("ThirdItemKey", "ThirdItem");


			// Items.Add(string Key)
			item = this.ultraExplorerBar1.Groups[0].Items.Add("FourthItemKey");


			// Items.Add(string Key)
			UltraExplorerBarItem item1	= new UltraExplorerBarItem();
			UltraExplorerBarItem item2	= new UltraExplorerBarItem();
			UltraExplorerBarItem item3	= new UltraExplorerBarItem();
			UltraExplorerBarItem item4	= new UltraExplorerBarItem();
			this.ultraExplorerBar1.Groups[0].Items.AddRange(new UltraExplorerBarItem [] { item1, item2, item3, item4 } );
		}