New to Telerik UI for WinForms? Start a free 30-day trial

Provides the shared tree, layout, and property-change state for spark elements and data points.

Definition

Constructors

Initializes a new instance of the SparkNode class.

C#
protected SparkNode()

Properties

Gets the index of this node in its owning typed collection.

C#
[Browsable(false)]
public int CollectionIndex { get; }

Gets the index of this node in its parent SparkElement nodes collection.

C#
[Browsable(false)]
public int Index { get; }

Gets a value indicating whether the node is laid-out on the chart scene.

C#
[Browsable(false)]
public bool IsArrangeValid { get; }

Gets a value indicating whether the logical tree this node is part of is loaded.

C#
[Browsable(false)]
public virtual bool IsTreeLoaded { get; }

This actually checks for a valid SparkAreaModel reference and asks whether the area itself is loaded. This value may differ from the current NodeState.

Gets the rectangle (in physical coordinates) where this node resides.

C#
[Browsable(false)]
public RadRect LayoutSlot { get; }

Gets the current state of the node.

C#
[Browsable(false)]
public NodeState NodeState { get; }

Gets the SparkElement where this node resides.

C#
[Browsable(false)]
public SparkElement Parent { get; }

Gets the ISparkElementPresenter instance where this node is visualized.

C#
[Browsable(false)]
public virtual ISparkElementPresenter Presenter { get; }

Gets the spark area whre this node resides.

C#
[Browsable(false)]
public SparkAreaModel SparkArea { get; }

Methods

Arranges the node within the specified layout slot.

C#
public RadRect Arrange(RadRect rect, bool shouldRoundLayout = true)
Parameters:rectRadRectshouldRoundLayoutboolReturns:

RadRect

Clears a property and invokes the changing and changed hooks according to their independent tracking flags. Those hooks dispatch notifications only while the node is loaded; a canceled changing notification prevents the clear.

C#
public override bool ClearValueCore(int key)
Parameters:keyint

The registered property key.

Returns:

bool

When either tracking flag is enabled, false if the change is canceled and true otherwise. When both flags are disabled, the result of the base implementation.

Overrides: PropertyBagObject.ClearValueCore(int)

Delegates an "Invalidate" request to the owning ISparkView instance (if any).

C#
public virtual void Invalidate()

Sets a property and invokes the changing and changed hooks according to their independent tracking flags. Those hooks dispatch notifications only while the node is loaded; a canceled changing notification prevents the update.

C#
public override bool SetValueCore(int key, object value)
Parameters:keyint

The registered property key.

valueobject

The value to store.

Returns:

bool

When either tracking flag is enabled, false if the value is unchanged or the change is canceled, and true if stored. When both flags are disabled, the result of the base implementation.

Overrides: PropertyBagObject.SetValueCore(int, object)

Changes the height of the current layout slot without arranging the node again.

C#
protected virtual void UpdateLayoutSlotHeight(double newHeight)
Parameters:newHeightdouble

The replacement height.

Changes the width of the current layout slot without arranging the node again.

C#
protected virtual void UpdateLayoutSlotWidth(double newWidth)
Parameters:newWidthdouble

The replacement width.

Changes the X coordinate of the current layout slot without arranging the node again.

C#
protected virtual void UpdateLayoutSlotX(double newX)
Parameters:newXdouble

The replacement X coordinate.

Changes the Y coordinate of the current layout slot without arranging the node again.

C#
protected virtual void UpdateLayoutSlotY(double newY)
Parameters:newYdouble

The replacement Y coordinate.

Events

Occurs when a value of some property has changed.

C#
public event PropertyChangedEventHandler PropertyChanged

Implements: INotifyPropertyChanged.PropertyChanged