The ItemSettingsResolved object contains the same properties as the UltraExplorerBarItemSettings object. You can use this object to determine what values are in effect for any given setting of the ItemSettings object. Some properties of the ItemSettings object may be set to their "use default" value, which indicates that the setting in effect for the Item is being inherited rather than explicitly set at the Item level. For these properties, you cannot determine which setting is actually being applied to the Item. However, the properties of the ItemSettingsResolved object will always return a meaningful value that you can examine to determine how the Item will appear or behave.
If you need to examine property settings at the Item level and take action based on the setting in effect for the Item, access the properties via the ItemSettingsResolved object to make sure you will always have a valid value for comparison purposes.
'Declaration Public Class UltraExplorerBarItemSettingsResolved
public class UltraExplorerBarItemSettingsResolved
Imports System.Diagnostics Imports Infragistics.Win Imports Infragistics.Win.UltraWinExplorerBar Private Sub Button49_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button49.Click ' Display information about the settings on the first item in the first group. If (Me.ultraExplorerBar1.Groups.Count < 1) Then Return End If If (Me.ultraExplorerBar1.Groups(0).Items.Count < 1) Then Return End If ' Get a reference to the first item in the first group. Dim firstItem As UltraExplorerBarItem = Me.ultraExplorerBar1.Groups(0).Items(0) ' AllowDragCopy If (firstItem.Settings.AllowDragCopy = ItemDragStyle.Default) Then Debug.WriteLine("The first group's AllowDragCopy setting is 'Default'. Its resolved setting is: " + firstItem.SettingsResolved.AllowDragCopy.ToString()) Else Debug.WriteLine("The first group's AllowDragCopy setting is: " + firstItem.Settings.AllowDragCopy.ToString()) End If End Sub
using System.Diagnostics; using Infragistics.Win; using Infragistics.Win.UltraWinExplorerBar; private void button49_Click(object sender, System.EventArgs e) { // Display information about the settings on the first item in the first group. if (this.ultraExplorerBar1.Groups.Count < 1) return; if (this.ultraExplorerBar1.Groups[0].Items.Count < 1) return; // Get a reference to the first item in the first group. UltraExplorerBarItem firstItem = this.ultraExplorerBar1.Groups[0].Items[0]; // AllowDragCopy if (firstItem.Settings.AllowDragCopy == ItemDragStyle.Default) Debug.WriteLine("The first group's AllowDragCopy setting is 'Default'. Its resolved setting is: " + firstItem.SettingsResolved.AllowDragCopy.ToString()); else Debug.WriteLine("The first group's AllowDragCopy setting is: " + firstItem.Settings.AllowDragCopy.ToString()); }
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