New to Telerik UI for WinFormsStart a free 30-day trial

Base class that support Clone() Clone and INotifyPropertyChanged.

Definition

Namespace:Telerik.Pivot.Core

Assembly:Telerik.WinControls.PivotGrid.dll

Syntax:

C#
[DataContract]
public abstract class SettingsNode : Cloneable, INotifyPropertyChanged, ISupportInitialize, IServiceProvider, IEditable

Inheritance: objectCloneableSettingsNode

Derived Classes: AggregateFunctionStringFormatSelectorDescriptionBaseConditionGroupFilterGroupComparerObjectComparerTotalFormatValuesPositionDescription...

Implements: IEditableINotifyPropertyChangedIServiceProviderISupportInitialize

Inherited Members Cloneable.Clone()Cloneable.CreateInstanceCore()Cloneable.CloneCore(Cloneable)

Constructors

C#
protected SettingsNode()

Properties

Gets the SettingsNode this SettingsNode is used in.

C#
public SettingsNode Parent { get; }

Methods

Set this SettingsNode as parent of the child and becomes a target for the child's change notifications.

C#
protected void AddSettingsChild(SettingsNode child)
Parameters:childSettingsNode

The nested SettingsNode.

Enters the SettingsNode in a new editing scope. Use when applying multiple changes. If child SettingsNode are changed, notifications will be accumulated in this SettingsNode.

using(settingsNode.BeginEdit()) { // Apply multiple changes here. }
C#
public IDisposable BeginEdit()
Returns:

IDisposable

An edit scope token that you must Dispose() when you are done with the editing.

Implements: IEditable.BeginEdit()

C#
public void BeginInit()

Implements: ISupportInitialize.BeginInit()

C#
public void EndInit()

Implements: ISupportInitialize.EndInit()

C#
public object GetService(Type serviceType)
Parameters:serviceTypeTypeReturns:

object

Implements: IServiceProvider.GetService(Type)

Provides services available by this SettingsNode. Other services may be available in its Parent SettingsNodes. The default implementation returns this SettingsNode if the desired service type is assignable from the type of this. The GetService(Type) implementation of IServiceProvider would query the service on the local node and if not available would query up the Parent nodes.

C#
protected virtual object GetServiceOverride(Type serviceType)
Parameters:serviceTypeType

The type of the requested service.

Returns:

object

A service instance if available, null otherwise.

Raises the ServicesChanged event.

C#
protected void NotifyServicesChanged()

Will recursively notify all SettingsNode for a settings change.

C#
protected void NotifySettingsChanged(SettingsChangedEventArgs args)
Parameters:argsSettingsChangedEventArgs

SettingsChangedEventArgs that contain information about the change.

Override to provide custom behavior for derived classes when editing begins. SettingsNode is already in edit mode and changes within the method body will be accumulated and released upon exit.

C#
protected virtual void OnEnteredEditScope()

Override to provide custom behavior for derived classes when finishing editing. SettingsNode is still in edit mode and changes within the method body will be accumulated and released upon exit.

C#
protected virtual void OnExitingEditScope()

Raises this object's PropertyChanged event.

C#
protected void OnPropertyChanged(string propertyName)
Parameters:propertyNamestring

The property that has a new value.

Invoked when a SettingsChangedEventArgs reaches the SettingsNode.

C#
protected virtual void OnSettingsChanged(SettingsChangedEventArgs args)
Parameters:argsSettingsChangedEventArgs

The SettingsChangedEventArgs that contains the event data.

Unsets the parent initiated with AddSettingsChild(SettingsNode). This SettingsNode will no longer receive change notifications from the child.

C#
protected void RemoveSettingsChild(SettingsNode child)
Parameters:childSettingsNode

The nested SettingsNode.

Events

Invoked when a property value changes.

C#
public event PropertyChangedEventHandler PropertyChanged

Implements: INotifyPropertyChanged.PropertyChanged

Invoked when new services are available or existing services are removed.

C#
public event EventHandler<EventArgs> ServicesChanged

Invoked when this or one of the children is changed.

C#
public event EventHandler<SettingsChangedEventArgs> SettingsChanged