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.
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
'Declaration
Public Class UltraExplorerBarItemSettings
Inherits UltraExplorerBarSettingsBase
Implements Infragistics.Win.Notifications.INotificationBadgeSettingsOwner
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;
}
}
'Declaration
Public Class UltraExplorerBarItemSettings
Inherits UltraExplorerBarSettingsBase
Implements Infragistics.Win.Notifications.INotificationBadgeSettingsOwner
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
