CheckedItem プロパティ (UltraExplorerBar)

現在チェックされている UltraExplorerBarItem を返す/設定します。または現在チェックされている Item がない場合には null を返します。

シンタックス

Visual Basic

'宣言
 
Public Property CheckedItem As UltraExplorerBarItem

C#

public UltraExplorerBarItem CheckedItem {get; set;}

解説

コントロールの StateButtonCheckStyle プロパティが 0 Exclusive Within Control の場合、このプロパティは、現在チェックされているコントロール内の UltraExplorerBarItem (ある場合) を返します。

コントロールの StateButtonCheckStyle プロパティが 1 Exclusive Within Group の場合、このプロパティは、現在の ActiveGroup 内のチェック済み項目 (ある場合) を返します。ActiveGroup が null (VB では Nothing) で、ActiveItem が null でない場合は、ActiveItem を含む Group が使用されます。

注: Item をチェックするためには、その Style プロパティを 1 StateButton に解決する必要があります。

注: Style が '1 StateButton' の全 Item 間での相互排他性は、コントロールの StateButtonCheckStyle プロパティによって決まります。

使用例

Visual Basic

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

	Private Sub Button4_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button4.Click

		' If there is no checked item, set the StateButtonCheckStyle to 'ExclusiveWithinControl'
		' and check the first state button type item we find.
		If (Me.ultraExplorerBar1.CheckedItem Is Nothing) Then
			Me.ultraExplorerBar1.StateButtonCheckStyle = StateButtonCheckStyle.ExclusiveWithinControl


			' Iterate thru all Groups and Items and check the first StateButton type Item we find
			Dim group As UltraExplorerBarGroup
			For Each group In Me.ultraExplorerBar1.Groups

				Dim item As UltraExplorerBarItem
				For Each item In group.Items
					If item.SettingsResolved.Style = ItemStyle.StateButton Then
						item.Checked = True

						Exit For
					End If
				Next

				' If we set a CheckedItem above, exit our Group loop.
				If (Not Me.ultraExplorerBar1.CheckedItem Is Nothing) Then
					Exit For
				End If
			Next
		End If

	End Sub

C#

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

		private void button4_Click(object sender, System.EventArgs e)
		{
			// If there is no checked item, set the StateButtonCheckStyle to 'ExclusiveWithinControl'
			// and check the first state button type item we find.
			if (this.ultraExplorerBar1.CheckedItem == null)
			{
				this.ultraExplorerBar1.StateButtonCheckStyle = StateButtonCheckStyle.ExclusiveWithinControl;


				// Iterate thru all Groups and Items and check the first StateButton type Item we find
				foreach(UltraExplorerBarGroup group in this.ultraExplorerBar1.Groups)
				{
					foreach(UltraExplorerBarItem item in group.Items)
					{
						if (item.SettingsResolved.Style == ItemStyle.StateButton)
						{
							item.Checked = true;

							break;
						}
					}

					// If we set a CheckedItem above, exit our Group loop.
					if (this.ultraExplorerBar1.CheckedItem != null)
						break;
				}
			}
		}