UltraExplorerBarItem オブジェクトは、UltraWinExplorerBar グループ内の項目を表します。Item はメニュー項目に似たインターフェイス 要素で、クリックしたときにプログラム内のアクションが呼び出されます。Item はアイコンと、項目の機能を説明するテキスト文字列から構成されます。Item には、標準のアイコンとラベルの外観の他に、状態(トグル)ボタンやセパレーターなどのあらかじめ定義された外観のいずれかを設定できます。
Item の詳細な外観の多くは、その項目を含む Group の設定によって決まります。(通常これらの設定は GroupSettings オブジェクトから取得されます)。たとえば、Group レベルの設定によって、項目のアイコンの大小や、テキストとアイコンの相対的な位置などが決まります。また、Item はコントロールでない点に注意してください。UltraWinExplorerBar の Group に WinForms コントロールを配置できますが、そうすると Group 内に存在する Item がすべて非表示になります。Item と WinForms コントロールは、1 つの Group 内で相互排他的です。
'宣言 Public Class UltraExplorerBarItem Inherits Infragistics.Shared.KeyedSubObjectBase Implements Infragistics.Shared.IKeyedSubObject, Infragistics.Shared.IKeyedSubObjectEx, Infragistics.Shared.ISelectableItem, Infragistics.Win.Notifications.INotificationBadgeProvider
public class UltraExplorerBarItem : Infragistics.Shared.KeyedSubObjectBase, Infragistics.Shared.IKeyedSubObject, Infragistics.Shared.IKeyedSubObjectEx, Infragistics.Shared.ISelectableItem, Infragistics.Win.Notifications.INotificationBadgeProvider
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
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 } ); }