UltraExplorerBarItemSettingsResolved Class

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.

Syntax

Visual Basic

'Declaration
 
Public Class UltraExplorerBarItemSettingsResolved 

C#

public class UltraExplorerBarItemSettingsResolved 

Example

The following code displays the current setting of the Item.Settings.AllowDragCopy property. If the property is set to 'Default' the resolved value of the property is displayed from the Item.SettingsResolved object.

Visual Basic

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

C#

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());
		}

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