Interface IElementTreeChangeListener

Defines methods for receiving notifications about changes in the element tree structure.

Namespace: Telerik.WinControls
Assembly: Telerik.WinControls.dll

Syntax

public interface IElementTreeChangeListener
Remarks

IElementTreeChangeListener provides a contract for objects that need to respond to structural changes in the RadElement hierarchy, such as elements being added, removed, or disposed. This is essential for maintaining consistency in complex control scenarios.

Implementers can use these notifications to update internal state, invalidate cached information, or perform cleanup operations when the element tree structure changes.

Methods

OnElementAdded(RadElement)

Called when a RadElement is added to the element tree.

Declaration
void OnElementAdded(RadElement addedElement)
Parameters
RadElement addedElement

The RadElement that was added to the tree.

OnElementDisposed(RadElement, RadElement)

Called when a RadElement is disposed.

Declaration
void OnElementDisposed(RadElement formerParent, RadElement disposed)
Parameters
RadElement formerParent

The former parent RadElement of the disposed element.
RadElement disposed

The RadElement that was disposed.

OnElementRemoved(RadElement, RadElement)

Called when a RadElement is removed from the element tree.

Declaration
void OnElementRemoved(RadElement formerParent, RadElement removedElement)
Parameters
RadElement formerParent

The parent RadElement from which the element was removed.
RadElement removedElement

The RadElement that was removed from the tree.

Extension Methods