About Progress

  • Company
    • Company Overview
    • Leadership
    • Corporate Social Responsibility
    • Investor Relations
    • Press Releases
    • Press Coverage
    • Recognitions
    • Progress Labs
    • Events
    • Customers
    • Careers
    • Offices
  • Technology
    • Cloud Native App Dev Platform
    • Cognitive Services
    • Web Content Management
    • UI/UX Tools
    • Secure Data Connectivity and Integration
    • Secure Managed File Transfer
    • OpenEdge
    • Network Monitoring
  • Services
    • Consulting
    • Education
    • Modernization
    • Outsourcing
  • Product Bundles

    DevCraft

    All Telerik .NET tools and Kendo UI JavaScript components in one package. Now enhanced with:

    • Conversational UI
    • Online Training
    • Document Processing Library
    Web
    Kendo UI UI for jQuery UI for Angular UI for React UI for Vue UI for ASP.NET AJAX UI for ASP.NET MVC UI for ASP.NET Core UI for Blazor UI for Silverlight UI for PHP UI for JSP
    Mobile
    UI for Xamarin NativeScript OSS framework
    Desktop
    UI for WPF UI for UWP UI for WinForms
    Reporting & Mocking
    Telerik Reporting Telerik Report Server Telerik JustMock
    Automated Testing
    Test Studio Test Studio Dev Edition
    Debugging
    FiddlerCore
    CMS
    Sitefinity
    UX Design
    Unite UX
    Document Management
    Telerik Document Processing
    Innovations Lab
    VR DataViz
    Free Tools
    Fiddler JustAssembly JustDecompile VB.NET to C# Converter Testing Framework
    View all products
  • Overview
  • Demos
    • What's New
    • Roadmap
    • Release History
  • Docs & Support
  • Pricing
  • Search
  • Shopping cart
    • Account Overview
    • Edit Profile
    • Payment Profiles
    • Renewals & Upgrades
    • Support Tickets
    • Log out
  • Login
  • Contact Us
  • Try now

Class UISparkElement

Inheritance
System.Object
DisposableObject
RadObject
UISparkElement
SparkAnnotation
SparkArea
SparkAxis
SparkSeries
SparkView
Inherited Members
RadObject.BindingContextProperty
RadObject.RadType
RadObject.DisposeManagedResources()
RadObject.ClearPropertyStore()
RadObject.SuspendPropertyNotifications()
RadObject.ResumePropertyNotifications()
RadObject.GetPropertyValue(RadProperty)
RadObject.SetDefaultValueOverride(RadProperty, Object)
RadObject.SetValueAtDesignTime(RadProperty, Object)
RadObject.SetValue(RadProperty, Object)
RadObject.ResetValue(RadProperty)
RadObject.ResetValue(RadProperty, ValueResetFlags)
RadObject.UpdateValue(RadProperty)
RadObject.GetValueSource(RadProperty)
RadObject.GetRegisteredRadProperty(String)
RadObject.UpdateValueCore(RadPropertyValue)
RadObject.SetValueCore(RadPropertyValue, Object, Object, ValueSource)
RadObject.ResetValueCore(RadPropertyValue, ValueResetFlags)
RadObject.GetDefaultValue(RadPropertyValue, Object)
RadObject.CoerceValue(RadPropertyValue, Object)
RadObject.ShouldSerializeProperty(PropertyDescriptor)
RadObject.CanRaisePropertyChangeNotifications(RadPropertyValue)
RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)
RadObject.UnbindProperty(RadProperty)
RadObject.RemoveStylePropertySetting(IPropertySetting)
RadObject.RemoveStylePropertySetting(RadProperty)
RadObject.GetInheritedValue(RadProperty)
RadObject.OnPropertyChanging(RadPropertyChangingEventArgs)
RadObject.OnNotifyPropertyChanged(String)
RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)
RadObject.IsPropertyCancelable(RadPropertyMetadata)
RadObject.PropertyValues
RadObject.IsDesignMode
RadObject.PropertyFilter
RadObject.RadObjectType
RadObject.BindingContext
RadObject.PropertyChanged
RadObject.RadPropertyChanged
RadObject.RadPropertyChanging
DisposableObject.GetBitState(Int64)
DisposableObject.SetBitState(Int64, Boolean)
DisposableObject.OnBitStateChanged(Int64, Boolean, Boolean)
DisposableObject.Dispose()
DisposableObject.Dispose(Boolean)
DisposableObject.PerformDispose(Boolean)
DisposableObject.DisposeUnmanagedResources()
DisposableObject.BitState
DisposableObject.Events
DisposableObject.IsDisposing
DisposableObject.IsDisposed
DisposableObject.Disposed
DisposableObject.Disposing
System.Object.ToString()
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

public abstract class UISparkElement : RadObject, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, ISparkElementPresenter, IStylableElement, IStylableNode, IShapedElement

Constructors

UISparkElement()

Initialized a new instance of the UISparkElement class.

Declaration
public UISparkElement()

Fields

BackColorProperty

Declaration
public static RadProperty BackColorProperty
Field Value
RadProperty

BorderColorProperty

Declaration
public static RadProperty BorderColorProperty
Field Value
RadProperty

BorderDashStyleProperty

Declaration
public static RadProperty BorderDashStyleProperty
Field Value
RadProperty

BorderWidthProperty

Declaration
public static RadProperty BorderWidthProperty
Field Value
RadProperty

ClassProperty

Declaration
public static RadProperty ClassProperty
Field Value
RadProperty

CustomFontProperty

Declaration
public static RadProperty CustomFontProperty
Field Value
RadProperty

CustomFontSizeProperty

Declaration
public static RadProperty CustomFontSizeProperty
Field Value
RadProperty

CustomFontStyleProperty

Declaration
public static RadProperty CustomFontStyleProperty
Field Value
RadProperty

FontProperty

Declaration
public static RadProperty FontProperty
Field Value
RadProperty

ForeColorProperty

Declaration
public static RadProperty ForeColorProperty
Field Value
RadProperty

IsMouseDownProperty

Declaration
public static RadProperty IsMouseDownProperty
Field Value
RadProperty

IsMouseOverProperty

Declaration
public static RadProperty IsMouseOverProperty
Field Value
RadProperty

IsVisibleProperty

Declaration
public static RadProperty IsVisibleProperty
Field Value
RadProperty

ShapeProperty

Declaration
public static RadProperty ShapeProperty
Field Value
RadProperty

SmoothingModeProperty

Declaration
public static RadProperty SmoothingModeProperty
Field Value
RadProperty

VisualStateProperty

Declaration
public static RadProperty VisualStateProperty
Field Value
RadProperty

Properties

BackColor

Gets or sets the back color.

Declaration
[RadPropertyDefaultValue("BackColor", typeof(UISparkElement))]
public Color BackColor { get; set; }
Property Value
System.Drawing.Color

The color of the back.

BorderColor

Gets or sets the color of the border.

Declaration
[RadPropertyDefaultValue("BorderColor", typeof(UISparkElement))]
public Color BorderColor { get; set; }
Property Value
System.Drawing.Color

The color of the border.

BorderDashStyle

Specifies the style of dashed lines drawn with a border.

Declaration
[RadPropertyDefaultValue("BorderDashStyle", typeof(UISparkElement))]
public DashStyle BorderDashStyle { get; set; }
Property Value
System.Drawing.Drawing2D.DashStyle

BorderWidth

Gets or sets a float value width of the left border. This property has effect only if FourBorders style is used in BoxStyle property and affects only the width of the left border.

Declaration
[RadPropertyDefaultValue("BorderWidth", typeof(UISparkElement))]
public float BorderWidth { get; set; }
Property Value
System.Single

Children

Declaration
public SparkElementCollection Children { get; }
Property Value
SparkElementCollection

ChildrenHierarchy

Gets the children hierarchy.

Declaration
public IEnumerable<RadObject> ChildrenHierarchy { get; }
Property Value
System.Collections.Generic.IEnumerable<RadObject>

The children hierarchy.

Implements
IStylableNode.ChildrenHierarchy

Class

Gets the class.

Declaration
public string Class { get; }
Property Value
System.String

The class.

Implements
IStylableNode.Class

CustomFont

Gets or sets the custom font.

Declaration
[RadPropertyDefaultValue("CustomFont", typeof(UISparkElement))]
[VsbBrowsable(true)]
public virtual string CustomFont { get; set; }
Property Value
System.String

The custom font.

CustomFontSize

Gets or sets the size of the custom font.

Declaration
[RadPropertyDefaultValue("CustomFontSize", typeof(UISparkElement))]
[VsbBrowsable(true)]
public virtual float CustomFontSize { get; set; }
Property Value
System.Single

The size of the custom font.

CustomFontStyle

Gets or sets the custom font style.

Declaration
[VsbBrowsable(true)]
[RadPropertyDefaultValue("CustomFontStyle", typeof(UISparkElement))]
public virtual FontStyle CustomFontStyle { get; set; }
Property Value
System.Drawing.FontStyle

The custom font style.

DpiScaleFactor

Gets or sets the dpi scale factor.

Declaration
public SizeF DpiScaleFactor { get; protected set; }
Property Value
System.Drawing.SizeF

The dpi scale factor.

FallbackToDefaultTheme

Gets whether to fallback to default theme.

Declaration
public virtual bool FallbackToDefaultTheme { get; }
Property Value
System.Boolean

The fallback to default theme.

Implements
IStylableElement.FallbackToDefaultTheme

Font

Gets or sets the font.

Declaration
[RadPropertyDefaultValue("Font", typeof(UISparkElement))]
public Font Font { get; set; }
Property Value
System.Drawing.Font

The font.

ForeColor

Gets or sets the fore color.

Declaration
[RadPropertyDefaultValue("ForeColor", typeof(UISparkElement))]
public Color ForeColor { get; set; }
Property Value
System.Drawing.Color

The color of the fore.

IsAttached

Gets if it is attached.

Declaration
public bool IsAttached { get; }
Property Value
System.Boolean

The is attached.

IsMouseDown

Gets if the mouse is down.

Declaration
public bool IsMouseDown { get; }
Property Value
System.Boolean

The is mouse down.

IsMouseOver

Gets if the mouse is over.

Declaration
public bool IsMouseOver { get; }
Property Value
System.Boolean

The is mouse over.

IsVisible

Gets or sets whether the element is visible.

Declaration
[RadPropertyDefaultValue("IsVisible", typeof(UISparkElement))]
public virtual bool IsVisible { get; set; }
Property Value
System.Boolean

Implements
ISparkElementPresenter.IsVisible

Level

Gets the level.

Declaration
public int Level { get; }
Property Value
System.Int32

The level.

Parent

Declaration
public virtual RadObject Parent { get; set; }
Property Value
RadObject

ScaledFontsCache

Gets the scaled fonts cache.

Declaration
protected virtual Dictionary<float, Font> ScaledFontsCache { get; }
Property Value
System.Collections.Generic.Dictionary<System.Single, System.Drawing.Font>

The scaled fonts cache.

Shape

Gets or sets an instance of the Shape object of an element. The shape of the element is both responsible for clipping the element's children and for providing its' border(s) with custom shape.

Declaration
[RadPropertyDefaultValue("Shape", typeof(UISparkElement))]
public ElementShape Shape { get; set; }
Property Value
ElementShape

Remarks

Value of null (or Nothing in VisualBasic.Net) indicates that element has rectangular (or no) shape. Shape is an object that defines the bounding graphics path of an element. Graphics clip is always applied when an element has shape. Shape is considered when painting the border element, and when hit-testing an element. Some predefined shapes are available, like RoundRectShape or EllipseShape. CustomShape offers a way to specify element's shape with a sequance of points and curves using code or the design time ElementShapeEditor System.Drawing.Design.UITypeEditor.

SmoothingMode

Gets or sets the SmoothingMode of the element.

Declaration
[RadPropertyDefaultValue("SmoothingMode", typeof(UISparkElement))]
public SmoothingMode SmoothingMode { get; set; }
Property Value
System.Drawing.Drawing2D.SmoothingMode

StateManager

Gets or sets the state manager.

Declaration
public virtual ItemStateManagerBase StateManager { get; set; }
Property Value
ItemStateManagerBase

The state manager.

Implements
IStylableElement.StateManager

Style

Gets or sets the style.

Declaration
public virtual StyleSheet Style { get; set; }
Property Value
StyleSheet

The style.

Implements
IStylableNode.Style

ThemeRole

Gets or sets the theme role.

Declaration
public virtual string ThemeRole { get; set; }
Property Value
System.String

The theme role.

Implements
IStylableElement.ThemeRole

View

Gets the view.

Declaration
public SparkView View { get; }
Property Value
SparkView

The view.

VisualState

Gets or sets the state of the visual.

Declaration
public virtual string VisualState { get; set; }
Property Value
System.String

The state of the visual.

Implements
IStylableElement.VisualState

Methods

AddStylePropertySetting(IPropertySetting)

Registers a style setting for this instance.

Declaration
protected override ValueUpdateResult AddStylePropertySetting(IPropertySetting setting)
Parameters
IPropertySetting setting

Returns
ValueUpdateResult

Overrides
RadObject.AddStylePropertySetting(IPropertySetting)

ApplyStyle()

Applies the style.

Declaration
protected virtual void ApplyStyle()

ApplyStyleByIndex(PropertySettingGroup, Int32)

Applies the style by the index.

Declaration
protected virtual void ApplyStyleByIndex(PropertySettingGroup group, int index)
Parameters
PropertySettingGroup group

The group.

System.Int32 index

The index.

ApplyStyleSettingsCore(PropertySettingGroup)

Applies the style settings.

Declaration
protected virtual void ApplyStyleSettingsCore(PropertySettingGroup group)
Parameters
PropertySettingGroup group

The group.

Attach(UISparkElement)

Attaches the specified parent.

Declaration
public void Attach(UISparkElement parent)
Parameters
UISparkElement parent

The parent.

BuildVisualState()

Builds the visual state.

Declaration
protected virtual void BuildVisualState()

Dettach()

Dettaches this instance.

Declaration
public void Dettach()

DpiScaleChanged(SizeF)

Called when DPI scale is changed.

Declaration
protected virtual void DpiScaleChanged(SizeF scaleFactor)
Parameters
System.Drawing.SizeF scaleFactor

The scale factor.

GetCurrentShape()

Gets the current shape.

Declaration
public ElementShape GetCurrentShape()
Returns
ElementShape

Implements
IShapedElement.GetCurrentShape()

GetScaledFont(Single)

Gets the scaled font.

Declaration
protected virtual Font GetScaledFont(float scale)
Parameters
System.Single scale

The scale.

Returns
System.Drawing.Font

GetThemeEffectiveType()

Gets the type of the theme effective.

Declaration
public virtual Type GetThemeEffectiveType()
Returns
System.Type

Implements
IStylableNode.GetThemeEffectiveType()

GetValue(RadProperty)

Retrieves the current value for the specified property.

Declaration
public override object GetValue(RadProperty property)
Parameters
RadProperty property

Returns
System.Object

Overrides
RadObject.GetValue(RadProperty)

Invalidate()

Invalidates the UISparkElement.

Declaration
public virtual void Invalidate()

MeasureContentOverride(SparkNode, Object)

Measures the content override.

Declaration
protected virtual RadSize MeasureContentOverride(SparkNode owner, object content)
Parameters
SparkNode owner

The owner.

System.Object content

The content.

Returns
RadSize

OnAttached(UISparkElement)

Called when [attached].

Declaration
protected virtual void OnAttached(UISparkElement parent)
Parameters
UISparkElement parent

The parent.

OnDettached()

Called when [dettached].

Declaration
protected virtual void OnDettached()

OnPropertyChanged(RadPropertyChangedEventArgs)

Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
RadPropertyChangedEventArgs e

Overrides
RadObject.OnPropertyChanged(RadPropertyChangedEventArgs)

Refresh()

Refreshes the UISparkElement.

Declaration
public virtual void Refresh()

Explicit Interface Implementations

IStylableNode.ApplySettings(PropertySettingGroup)

Declaration
void IStylableNode.ApplySettings(PropertySettingGroup group)
Parameters
PropertySettingGroup group

Implements
IStylableNode.ApplySettings(PropertySettingGroup)

IStylableNode.Children

Declaration
IEnumerable<RadObject> IStylableNode.Children { get; }
Returns
System.Collections.Generic.IEnumerable<RadObject>

Implements
IStylableNode.Children

IStylableNode.Parent

Declaration
IStylableNode IStylableNode.Parent { get; }
Returns
IStylableNode

Implements
IStylableNode.Parent

ISparkElementPresenter.MeasureContent(SparkNode, Object)

Declaration
RadSize ISparkElementPresenter.MeasureContent(SparkNode owner, object content)
Parameters
SparkNode owner

System.Object content

Returns
RadSize

Implements
ISparkElementPresenter.MeasureContent(SparkNode, Object)

ISparkElementPresenter.RefreshNode(SparkNode)

Declaration
void ISparkElementPresenter.RefreshNode(SparkNode node)
Parameters
SparkNode node

Implements
ISparkElementPresenter.RefreshNode(SparkNode)

Extension Methods

CommonExtensions.ClearIfNoBindingAndSet(RadObject, RadProperty)
DispatcherExtensions.CheckAccess(RadObject)
CommonExtensions.SetIfDifferent(RadObject, RadProperty, Object)
CommonExtensions.ClearIfSet(RadObject, RadProperty)
CommonExtensions.IsLocalValueSet(RadObject, RadProperty)
DispatcherExtensions.CheckAccess(RadObject)
DispatcherExtensions.CheckAccess(RadObject)
DispatcherExtensions.CheckAccess(RadObject)
SvgExtentions.Traverse<T>(T, Func<T, IEnumerable<T>>)
SvgExtentions.TraverseDepthFirst<T>(T, Func<T, IEnumerable<T>>)

Was this article helpful?

 / 
Tell us how we can improve this article
Skip
Getting Started
  • Install Now
  • Demos
  • Step-by-Step Tutorial
  • Sample Applications
  • SDK Samples
  • Visual Studio Extensions
Support Resources
  • Code Library
  • Knowledge Base
  • Videos
Community
  • Forums
  • Blogs
  • Feedback Portal
  • Document Processing Feedback Portal

Copyright © 2018 Progress Software Corporation and/or its subsidiaries or affiliates.
All Rights Reserved.

Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries. See Trademarks for appropriate markings.