Class
UISparkElement

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

cs-api-definition
public abstract class UISparkElement : RadObject, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, ISparkElementPresenter, IStylableElement, IStylableNode, IShapedElement

Inheritance: objectDisposableObjectRadObjectUISparkElement

Derived Classes: SparkAnnotationSparkAreaSparkSeriesSparkViewSparkAxis

Implements: ICustomTypeDescriptorIDisposableINotifyPropertyChangedIShapedElementISparkElementPresenterIStylableElementIStylableNode

Inherited Members RadObject.BindingContextPropertyRadObject.RadTypeRadObject.ReplaceDefaultDescriptors(PropertyDescriptorCollection)RadObject.DisposeManagedResources()RadObject.ClearPropertyStore()RadObject.SuspendPropertyNotifications()RadObject.ResumePropertyNotifications()RadObject.GetPropertyValue(RadProperty)RadObject.SetDefaultValueOverride(RadProperty, object)RadObject.SetValue(RadProperty, object)RadObject.ResetValue(RadProperty)RadObject.ResetLocalValue(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(RadProperty)RadObject.CanRaisePropertyChangeNotifications(RadPropertyValue)RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)RadObject.UnbindProperty(RadProperty)RadObject.GetInheritedValue(RadProperty)RadObject.OnPropertyChanging(RadPropertyChangingEventArgs)RadObject.OnNotifyPropertyChanged(string)RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadObject.OnShouldSerializeProperty(ShouldSerializePropertyEventArgs)RadObject.IsPropertyCancelable(RadPropertyMetadata)RadObject.PropertyValuesRadObject.PropertyFilterRadObject.RadObjectTypeRadObject.BindingContextRadObject.PropertyChangedRadObject.RadPropertyChangedRadObject.RadPropertyChangingDisposableObject.GetBitState(long)DisposableObject.SetBitState(long, bool)DisposableObject.OnBitStateChanged(long, bool, bool)DisposableObject.Dispose()DisposableObject.Dispose(bool)DisposableObject.PerformDispose(bool)DisposableObject.DisposeUnmanagedResources()DisposableObject.BitStateDisposableObject.EventsDisposableObject.IsDisposingDisposableObject.IsDisposedDisposableObject.DisposedDisposableObject.Disposing

Constructors

UISparkElement()

Initialized a new instance of the UISparkElement class.

Declaration

cs-api-definition
public UISparkElement()

Fields

BackColorProperty

Declaration

cs-api-definition
public static RadProperty BackColorProperty

Field Value

RadProperty

BorderColorProperty

Declaration

cs-api-definition
public static RadProperty BorderColorProperty

Field Value

RadProperty

BorderDashStyleProperty

Declaration

cs-api-definition
public static RadProperty BorderDashStyleProperty

Field Value

RadProperty

BorderWidthProperty

Declaration

cs-api-definition
public static RadProperty BorderWidthProperty

Field Value

RadProperty

ClassProperty

Declaration

cs-api-definition
public static RadProperty ClassProperty

Field Value

RadProperty

CustomFontProperty

Declaration

cs-api-definition
public static RadProperty CustomFontProperty

Field Value

RadProperty

CustomFontSizeProperty

Declaration

cs-api-definition
public static RadProperty CustomFontSizeProperty

Field Value

RadProperty

CustomFontStyleProperty

Declaration

cs-api-definition
public static RadProperty CustomFontStyleProperty

Field Value

RadProperty

FontProperty

Declaration

cs-api-definition
public static RadProperty FontProperty

Field Value

RadProperty

ForeColorProperty

Declaration

cs-api-definition
public static RadProperty ForeColorProperty

Field Value

RadProperty

IsMouseDownProperty

Declaration

cs-api-definition
public static RadProperty IsMouseDownProperty

Field Value

RadProperty

IsMouseOverProperty

Declaration

cs-api-definition
public static RadProperty IsMouseOverProperty

Field Value

RadProperty

IsVisibleProperty

Declaration

cs-api-definition
public static RadProperty IsVisibleProperty

Field Value

RadProperty

ShapeProperty

Declaration

cs-api-definition
public static RadProperty ShapeProperty

Field Value

RadProperty

SmoothingModeProperty

Declaration

cs-api-definition
public static RadProperty SmoothingModeProperty

Field Value

RadProperty

VisualStateProperty

Declaration

cs-api-definition
public static RadProperty VisualStateProperty

Field Value

RadProperty

Properties

BackColor

Gets or sets the back color.

Declaration

cs-api-definition
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BackColor { get; set; }

Property Value

Color

The color of the back.

BorderColor

Gets or sets the color of the border.

Declaration

cs-api-definition
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderColor { get; set; }

Property Value

Color

The color of the border.

BorderDashStyle

Specifies the style of dashed lines drawn with a border.

Declaration

cs-api-definition
public DashStyle BorderDashStyle { get; set; }

Property Value

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

cs-api-definition
public float BorderWidth { get; set; }

Property Value

float

Children

Declaration

cs-api-definition
[Browsable(false)]
public SparkElementCollection Children { get; }

Property Value

SparkElementCollection

ChildrenHierarchy

Gets the children hierarchy.

Declaration

cs-api-definition
[Browsable(false)]
public IEnumerable<RadObject> ChildrenHierarchy { get; }

Property Value

IEnumerable<RadObject>

The children hierarchy.

Implements IStylableNode.ChildrenHierarchy

Class

Gets the class.

Declaration

cs-api-definition
[Browsable(false)]
public string Class { get; }

Property Value

string

The class.

Implements IStylableNode.Class

DpiScaleFactor

Gets or sets the dpi scale factor.

Declaration

cs-api-definition
public SizeF DpiScaleFactor { get; protected set; }

Property Value

SizeF

The dpi scale factor.

FallbackToDefaultTheme

Gets whether to fallback to default theme.

Declaration

cs-api-definition
[Browsable(false)]
public virtual bool FallbackToDefaultTheme { get; }

Property Value

bool

The fallback to default theme.

Implements IStylableElement.FallbackToDefaultTheme

Font

Gets or sets the font.

Declaration

cs-api-definition
public Font Font { get; set; }

Property Value

Font

The font.

ForeColor

Gets or sets the fore color.

Declaration

cs-api-definition
[TypeConverter(typeof(RadColorEditorConverter))]
public Color ForeColor { get; set; }

Property Value

Color

The color of the fore.

IsAttached

Gets if it is attached.

Declaration

cs-api-definition
[Browsable(false)]
public bool IsAttached { get; }

Property Value

bool

The is attached.

IsMouseDown

Gets if the mouse is down.

Declaration

cs-api-definition
[Browsable(false)]
public bool IsMouseDown { get; }

Property Value

bool

The is mouse down.

IsMouseOver

Gets if the mouse is over.

Declaration

cs-api-definition
[Browsable(false)]
public bool IsMouseOver { get; }

Property Value

bool

The is mouse over.

IsVisible

Gets or sets whether the element is visible.

Declaration

cs-api-definition
public virtual bool IsVisible { get; set; }

Property Value

bool

Implements ISparkElementPresenter.IsVisible

Level

Gets the level.

Declaration

cs-api-definition
[Browsable(false)]
public int Level { get; }

Property Value

int

The level.

Parent

Declaration

cs-api-definition
[Browsable(false)]
public virtual RadObject Parent { get; set; }

Property Value

RadObject

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

cs-api-definition
[TypeConverter(typeof(ElementShapeConverter))]
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 UITypeEditor.

SmoothingMode

Gets or sets the SmoothingMode of the element.

Declaration

cs-api-definition
public SmoothingMode SmoothingMode { get; set; }

Property Value

SmoothingMode

StateManager

Gets or sets the state manager.

Declaration

cs-api-definition
[Browsable(false)]
public virtual ItemStateManagerBase StateManager { get; set; }

Property Value

ItemStateManagerBase

The state manager.

Implements IStylableElement.StateManager

Style

Gets or sets the style.

Declaration

cs-api-definition
[Browsable(false)]
public virtual StyleSheet Style { get; set; }

Property Value

StyleSheet

The style.

Implements IStylableNode.Style

ThemeRole

Gets or sets the theme role.

Declaration

cs-api-definition
[Browsable(false)]
public virtual string ThemeRole { get; set; }

Property Value

string

The theme role.

Implements IStylableElement.ThemeRole

View

Gets the view.

Declaration

cs-api-definition
[Browsable(false)]
public SparkView View { get; }

Property Value

SparkView

The view.

VisualState

Gets or sets the state of the visual.

Declaration

cs-api-definition
[Browsable(false)]
public virtual string VisualState { get; set; }

Property Value

string

The state of the visual.

Implements IStylableElement.VisualState

Methods

AddStylePropertySetting(IPropertySetting)

Registers a style setting for this instance.

Declaration

cs-api-definition
protected override ValueUpdateResult AddStylePropertySetting(IPropertySetting setting)

Parameters

setting

IPropertySetting

Returns

ValueUpdateResult

Overrides RadObject.AddStylePropertySetting(IPropertySetting)

ApplyStyle()

Applies the style.

Declaration

cs-api-definition
protected virtual void ApplyStyle()

ApplyStyleByIndex(PropertySettingGroup, int)

Applies the style by the index.

Declaration

cs-api-definition
protected virtual void ApplyStyleByIndex(PropertySettingGroup group, int index)

Parameters

group

PropertySettingGroup

The group.

index

int

The index.

ApplyStyleSettingsCore(PropertySettingGroup)

Applies the style settings.

Declaration

cs-api-definition
protected virtual void ApplyStyleSettingsCore(PropertySettingGroup group)

Parameters

group

PropertySettingGroup

The group.

Attach(UISparkElement)

Attaches the specified parent.

Declaration

cs-api-definition
public void Attach(UISparkElement parent)

Parameters

parent

UISparkElement

The parent.

BuildVisualState()

Builds the visual state.

Declaration

cs-api-definition
protected virtual void BuildVisualState()

Dettach()

Dettaches this instance.

Declaration

cs-api-definition
public void Dettach()

DpiScaleChanged(SizeF)

Called when DPI scale is changed.

Declaration

cs-api-definition
protected virtual void DpiScaleChanged(SizeF scaleFactor)

Parameters

scaleFactor

SizeF

The scale factor.

GetCurrentShape()

Gets the current shape.

Declaration

cs-api-definition
public ElementShape GetCurrentShape()

Returns

ElementShape

Implements IShapedElement.GetCurrentShape()

GetScaledFont(float)

Gets the scaled font.

Declaration

cs-api-definition
protected virtual Font GetScaledFont(float scale)

Parameters

scale

float

The scale.

Returns

Font

GetThemeEffectiveType()

Gets the type of the theme effective.

Declaration

cs-api-definition
public virtual Type GetThemeEffectiveType()

Returns

Type

Implements IStylableNode.GetThemeEffectiveType()

GetValue(RadProperty)

Retrieves the current value for the specified property.

Declaration

cs-api-definition
public override object GetValue(RadProperty property)

Parameters

property

RadProperty

Returns

object

Overrides RadObject.GetValue(RadProperty)

Invalidate()

Invalidates the UISparkElement.

Declaration

cs-api-definition
public virtual void Invalidate()

MeasureContentOverride(SparkNode, object)

Measures the content override.

Declaration

cs-api-definition
protected virtual RadSize MeasureContentOverride(SparkNode owner, object content)

Parameters

owner

SparkNode

The owner.

content

object

The content.

Returns

RadSize

OnAttached(UISparkElement)

Called when [attached].

Declaration

cs-api-definition
protected virtual void OnAttached(UISparkElement parent)

Parameters

parent

UISparkElement

The parent.

OnDettached()

Called when [dettached].

Declaration

cs-api-definition
protected virtual void OnDettached()

OnPropertyChanged(RadPropertyChangedEventArgs)

Raises the RadPropertyChanged event and the standard .NET PropertyChanged event to notify subscribers of property value changes.

Declaration

cs-api-definition
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)

Parameters

e

RadPropertyChangedEventArgs

The RadPropertyChangedEventArgs containing information about the property change.

Overrides RadObject.OnPropertyChanged(RadPropertyChangedEventArgs)

Refresh()

Refreshes the UISparkElement.

Declaration

cs-api-definition
public virtual void Refresh()