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

ComponentThemableElementTree

Class

Represents a concrete implementation of RadElementTree that provides comprehensive theming and styling capabilities for Telerik controls, managing theme application and lifecycle within the element hierarchy.

Definition

Namespace:Telerik.WinControls

Assembly:Telerik.WinControls.dll

Syntax:

public class ComponentThemableElementTree : RadElementTree, IDisposable, IThemeChangeListener

Inheritance: objectRadElementTreeComponentThemableElementTree

Implements: IDisposableIThemeChangeListener

Inherited Members RadElementTree.InitializeRootElement()RadElementTree.Dispose()RadElementTree.GetElementAtPoint<T>(Point)RadElementTree.GetElementAtPoint(Point)RadElementTree.GetElementAtPoint(Point, Predicate<RadElement>)RadElementTree.GetPreferredSize(Size, Size)RadElementTree.PerformLayout()RadElementTree.PerformInnerLayout(bool, int, int, int, int)RadElementTree.OnAutoSizeChanged(EventArgs)RadElementTree.DisposingRadElementTree.RootElementRadElementTree.ControlRadElementTree.ComponentTreeHandlerRadElementTree.TreeNameRadElementTree.IsLayoutSuspended...

Constructors

ComponentThemableElementTree(IComponentTreeHandler)

public ComponentThemableElementTree(IComponentTreeHandler owner)

Parameters:ownerIComponentTreeHandler

Properties

AnimationsEnabled

bool

Gets value indicating whether the animated property changes are suspended for the control. Also see SuspendAnimations().

public bool AnimationsEnabled { get; }

EnableApplicationThemeName

bool

[Browsable(true)]
public bool EnableApplicationThemeName { get; set; }

EnableTheming

bool

public bool EnableTheming { get; set; }

FallbackToControlDefault

bool

Gets or sets a value indicating whether to fallback to control default theme if the control does not support the current theme.

[Browsable(false)]
public bool FallbackToControlDefault { get; set; }

Theme

Gets the currently used theme.

public Theme Theme { get; }

ThemeClassName

string

Gets or sets the class name string that ThemeResolutionService will use to find the themes registered for the control.

public virtual string ThemeClassName { get; set; }

Remarks:

By default the return value is RadControl's type FullName; Some controls like drop down menu has different ThemeClassName depending on the runtime usage of the control.

ThemeName

string

Gets or sets control's preffered theme name. Themes are stored and retrieved using APIs of ThemeResolutionService.

[Browsable(true)]
public string ThemeName { get; set; }

Remarks:

If ThemeResolutionService.ApplicatonThemeName refers to a non-empty string, the theme of a RadControl can differ from the one set using RadControls.ThemeName property. If the themes differ, the RadControls.ThemeName property will be overridden by ThemeResolutionService.ApplicatonThemeName. If no theme is registered with a name as ThemeResolutionService.ApplicatonThemeName, then control will revert to the theme specified by its ThemeName property. If ThemeName is assigned to a non-existing theme name, the control may have no visual properties assigned, which will cause it look and behave in unexpected manner. If ThemeName equals empty string, control's theme is set to a theme that is registered within ThemeResolutionService with the name "ControlDefault".

Methods

Dispose(bool)

Releases the unmanaged resources used by the RadElementTree and optionally releases the managed resources.

protected override void Dispose(bool disposing)

Parameters:disposingbool

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Overrides: RadElementTree.Dispose(bool)

ResumeAnimations()

Resumes the animated property changes for the conrol. For more info see SuspendAnimations()

public void ResumeAnimations()

SuspendAnimations()

Suspends the animated property changes for the control. When animation are suspended property changes still occur but without aniumations.

public void SuspendAnimations()