Version

UltraExplorerBarItemSettings Class

The UltraExplorerBarItemSettings object is used to encapsulate all of the appearance and behavior settings that are applied to an UltraExplorerBarItem object. The settings of this object are capable of being persisted by using the UltraExplorerBar.SaveAsBinary or UltraExplorerBar.SaveAsXml methods.

The settings of this object include AppearancesLarge and AppearancesSmall which determine the formatting of the Item in small and large icon modes, Enabled which determines whether the item can be activated, Indent which specifies the amount of indenting applied to the Item, and Style which determines whether the Item will function as a buttton, state button, label or separator.

Syntax
'Declaration
 
Public Class UltraExplorerBarItemSettings 
   Inherits UltraExplorerBarSettingsBase
   Implements Infragistics.Win.Notifications.INotificationBadgeSettingsOwner 
public class UltraExplorerBarItemSettings : UltraExplorerBarSettingsBase, Infragistics.Win.Notifications.INotificationBadgeSettingsOwner  
Example
The following code shows how to apply default settings for all Items in the control and then override those settings for the Items in a particular group.

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


	Private Sub Button9_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button9.Click

		' Modify some of the default Item settings specified at the control level.  These
		' ItemSettings apply to all Items in all Groups.  We will then override
		' the settings for Items in a specific Group below.
		Me.ultraExplorerBar1.ItemSettings.AllowEdit = DefaultableBoolean.False
		Me.ultraExplorerBar1.ItemSettings.AllowDragCopy = ItemDragStyle.None
		Me.ultraExplorerBar1.ItemSettings.AllowDragMove = ItemDragStyle.None
		Me.ultraExplorerBar1.ItemSettings.Enabled = DefaultableBoolean.False
		Me.ultraExplorerBar1.ItemSettings.Height = 18
		Me.ultraExplorerBar1.ItemSettings.HotTrackBorderStyle = UIElementBorderStyle.None
		Me.ultraExplorerBar1.ItemSettings.HotTracking = DefaultableBoolean.False
		Me.ultraExplorerBar1.ItemSettings.HotTrackStyle = ItemHotTrackStyle.HighlightText
		Me.ultraExplorerBar1.ItemSettings.Indent = 5
		Me.ultraExplorerBar1.ItemSettings.MaxLines = 5
		Me.ultraExplorerBar1.ItemSettings.SeparatorStyle = SeparatorStyle.Horizontal
		Me.ultraExplorerBar1.ItemSettings.ShowToolTips = DefaultableBoolean.False
		Me.ultraExplorerBar1.ItemSettings.Style = ItemStyle.StateButton
		Me.ultraExplorerBar1.ItemSettings.UseDefaultImage = DefaultableBoolean.True
		Me.ultraExplorerBar1.ItemSettings.UseMnemonics = DefaultableBoolean.False


		' Override the default Item settings set at the control level above for the
		' items in the first Group.
		If (Me.ultraExplorerBar1.Groups.Count > 0) Then
			Me.ultraExplorerBar1.Groups(0).ItemSettings.AllowEdit = DefaultableBoolean.True
			Me.ultraExplorerBar1.Groups(0).ItemSettings.AllowDragCopy = ItemDragStyle.WithinGroupOnly
			Me.ultraExplorerBar1.Groups(0).ItemSettings.AllowDragMove = ItemDragStyle.WithinGroupOnly
			Me.ultraExplorerBar1.Groups(0).ItemSettings.Enabled = DefaultableBoolean.True
			Me.ultraExplorerBar1.Groups(0).ItemSettings.Height = 22
			Me.ultraExplorerBar1.Groups(0).ItemSettings.HotTrackBorderStyle = UIElementBorderStyle.Dotted
			Me.ultraExplorerBar1.Groups(0).ItemSettings.HotTracking = DefaultableBoolean.True
			Me.ultraExplorerBar1.Groups(0).ItemSettings.HotTrackStyle = ItemHotTrackStyle.HighlightEntireItem
			Me.ultraExplorerBar1.Groups(0).ItemSettings.Indent = 0
			Me.ultraExplorerBar1.Groups(0).ItemSettings.MaxLines = 3
			Me.ultraExplorerBar1.Groups(0).ItemSettings.SeparatorStyle = SeparatorStyle.Vertical
			Me.ultraExplorerBar1.Groups(0).ItemSettings.ShowToolTips = DefaultableBoolean.True
			Me.ultraExplorerBar1.Groups(0).ItemSettings.Style = ItemStyle.Button
			Me.ultraExplorerBar1.Groups(0).ItemSettings.UseDefaultImage = DefaultableBoolean.False
			Me.ultraExplorerBar1.Groups(0).ItemSettings.UseMnemonics = DefaultableBoolean.True
		End If

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


		private void button9_Click(object sender, System.EventArgs e)
		{
			// Modify some of the default Item settings specified at the control level.  These
			// ItemSettings apply to all Items in all Groups.  We will then override
			// the settings for Items in a specific Group below.
			this.ultraExplorerBar1.ItemSettings.AllowEdit			= DefaultableBoolean.False;
			this.ultraExplorerBar1.ItemSettings.AllowDragCopy		= ItemDragStyle.None;
			this.ultraExplorerBar1.ItemSettings.AllowDragMove		= ItemDragStyle.None;
			this.ultraExplorerBar1.ItemSettings.Enabled				= DefaultableBoolean.False;
			this.ultraExplorerBar1.ItemSettings.Height				= 18;
			this.ultraExplorerBar1.ItemSettings.HotTrackBorderStyle	= UIElementBorderStyle.None;
			this.ultraExplorerBar1.ItemSettings.HotTracking			= DefaultableBoolean.False;
			this.ultraExplorerBar1.ItemSettings.HotTrackStyle		= ItemHotTrackStyle.HighlightText;
			this.ultraExplorerBar1.ItemSettings.Indent				= 5;
			this.ultraExplorerBar1.ItemSettings.MaxLines			= 5;
			this.ultraExplorerBar1.ItemSettings.SeparatorStyle		= SeparatorStyle.Horizontal;
			this.ultraExplorerBar1.ItemSettings.ShowToolTips		= DefaultableBoolean.False;
			this.ultraExplorerBar1.ItemSettings.Style				= ItemStyle.StateButton;
			this.ultraExplorerBar1.ItemSettings.UseDefaultImage		= DefaultableBoolean.True;
			this.ultraExplorerBar1.ItemSettings.UseMnemonics		= DefaultableBoolean.False;



			// Override the default Item settings set at the control level above for the
			// items in the first Group.
			if (this.ultraExplorerBar1.Groups.Count > 0)
			{
				this.ultraExplorerBar1.Groups[0].ItemSettings.AllowEdit			= DefaultableBoolean.True;
				this.ultraExplorerBar1.Groups[0].ItemSettings.AllowDragCopy		= ItemDragStyle.WithinGroupOnly;
				this.ultraExplorerBar1.Groups[0].ItemSettings.AllowDragMove		= ItemDragStyle.WithinGroupOnly;
				this.ultraExplorerBar1.Groups[0].ItemSettings.Enabled			= DefaultableBoolean.True;
				this.ultraExplorerBar1.Groups[0].ItemSettings.Height			= 22;
				this.ultraExplorerBar1.Groups[0].ItemSettings.HotTrackBorderStyle	= UIElementBorderStyle.Dotted;
				this.ultraExplorerBar1.Groups[0].ItemSettings.HotTracking		= DefaultableBoolean.True;
				this.ultraExplorerBar1.Groups[0].ItemSettings.HotTrackStyle		= ItemHotTrackStyle.HighlightEntireItem;
				this.ultraExplorerBar1.Groups[0].ItemSettings.Indent			= 0;
				this.ultraExplorerBar1.Groups[0].ItemSettings.MaxLines			= 3;
				this.ultraExplorerBar1.Groups[0].ItemSettings.SeparatorStyle	= SeparatorStyle.Vertical;
				this.ultraExplorerBar1.Groups[0].ItemSettings.ShowToolTips		= DefaultableBoolean.True;
				this.ultraExplorerBar1.Groups[0].ItemSettings.Style				= ItemStyle.Button;
				this.ultraExplorerBar1.Groups[0].ItemSettings.UseDefaultImage	= DefaultableBoolean.False;
				this.ultraExplorerBar1.Groups[0].ItemSettings.UseMnemonics		= DefaultableBoolean.True;
			}
		}
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also