New to Telerik UI for WinFormsStart a free 30-day trial

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.ChartView.dll

Syntax:

C#
public abstract class UIChartElement : RadObject, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, IChartElementPresenter, IStylableElement, IStylableNode, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IShapedElement

Inheritance: objectDisposableObjectRadObjectUIChartElement

Derived Classes: AxisChartAnnotationChartAreaChartGridChartImageElementChartSeriesChartViewLegendItemStyleElementSelectedPoint...

Implements: IBorderElementIBoxElementIBoxStyleIChartElementPresenterICustomTypeDescriptorIDisposableIFillElementINotifyPropertyChangedIShapedElementIStylableElementIStylableNode...

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

Initialized a new instance of the UIChartElement class.

C#
public UIChartElement()

Fields

C#
public static RadProperty BackColor2Property
C#
public static RadProperty BackColor3Property
C#
public static RadProperty BackColor4Property
C#
public static RadProperty BackColorProperty
C#
public static RadProperty BackgroundShapeProperty
C#
public static RadProperty BorderBottomColorProperty
C#
public static RadProperty BorderBottomShadowColorProperty
C#
public static RadProperty BorderBottomWidthProperty
C#
public static RadProperty BorderBoxStyleProperty
C#
public static RadProperty BorderColor2Property
C#
public static RadProperty BorderColor3Property
C#
public static RadProperty BorderColor4Property
C#
public static RadProperty BorderColorProperty
C#
public static RadProperty BorderCornerRadiusProperty
C#
public static RadProperty BorderDashPatternProperty
C#
public static RadProperty BorderDashStyleProperty
C#
public static RadProperty BorderDrawModeProperty
C#
public static RadProperty BorderGradientAngleProperty
C#
public static RadProperty BorderGradientStyleProperty
C#
public static RadProperty BorderInnerColor2Property
C#
public static RadProperty BorderInnerColor3Property
C#
public static RadProperty BorderInnerColor4Property
C#
public static RadProperty BorderInnerColorProperty
C#
public static RadProperty BorderLeftColorProperty
C#
public static RadProperty BorderLeftShadowColorProperty
C#
public static RadProperty BorderLeftWidthProperty
C#
public static RadProperty BorderRightColorProperty
C#
public static RadProperty BorderRightShadowColorProperty
C#
public static RadProperty BorderRightWidthProperty
C#
public static RadProperty BorderTopColorProperty
C#
public static RadProperty BorderTopShadowColorProperty
C#
public static RadProperty BorderTopWidthProperty
C#
public static RadProperty BorderWidthProperty
C#
public static RadProperty ClassProperty
C#
public static RadProperty CustomFontProperty
C#
public static RadProperty CustomFontSizeProperty
C#
public static RadProperty CustomFontStyleProperty
C#
public static RadProperty FontProperty
C#
public static RadProperty ForeColorProperty
C#
public static RadProperty GradientAngleProperty
C#
public static RadProperty GradientPercentage2Property
C#
public static RadProperty GradientPercentageProperty
C#
public static RadProperty GradientStyleProperty
C#
public static RadProperty IsMouseDownProperty
C#
public static RadProperty IsMouseOverProperty
C#
public static RadProperty IsVisibleProperty
C#
public static RadProperty NumberOfColorsProperty
C#
public static RadProperty PaddingProperty
C#
public static RadProperty ShapeProperty
C#
public static RadProperty SmoothingModeProperty
C#
public static RadProperty VisualStateProperty

Properties

Gets or sets the back color.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BackColor { get; set; }
Property Value:

The color of the back.

Implements: IFillElement.BackColor

Gets or sets the back color2.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BackColor2 { get; set; }
Property Value:

The back color2.

Implements: IFillElement.BackColor2

Gets or sets the back color3.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BackColor3 { get; set; }
Property Value:

The back color3.

Implements: IFillElement.BackColor3

Gets or sets the back color4.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BackColor4 { get; set; }
Property Value:

The back color4.

Implements: IFillElement.BackColor4

Gets or sets the RadImageShape that describes the background of the element.

C#
[Browsable(false)]
[VsbBrowsable(true)]
public RadImageShape BackgroundShape { get; set; }

Gets and sets the bottom border color. This applies only if FourBorders is chosen for BoxStyle property, and affects only the bottom border.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderBottomColor { get; set; }

Gets and sets the bottom shadow color. This option applies only if fourBorders is chosen, and affects only the bottom border.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderBottomShadowColor { get; set; }

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

C#
public float BorderBottomWidth { get; set; }

Gets or sets the Border style. The two possible values are SingleBorder and FourBorder. In the single border case, all four sides share the same appearance although the entire border may have gradient. In four border case, each of the four sides may differ in appearance. For example, the left border may have different color, shadowcolor, and width from the rest. When SingleBorder is chosen, you should use the general properties such as width and color, and respectively, when the FourBorder style is chosen you should use properties prefixed with the corresponding side, for example, LeftColor, LeftWidth for the left side.

C#
public BorderBoxStyle BorderBoxStyle { get; set; }

Gets or sets the color of the border.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderColor { get; set; }
Property Value:

The color of the border.

Gets or sets color used by radial, glass, office glass, gel, and vista gradients. This is one of the colors that are used in the gradient effect.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderColor2 { get; set; }

Gets or sets color used by radial, glass, office glass, and vista gradients. This is one of the colors that are used in the gradient effect.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderColor3 { get; set; }

Gets or sets color used by radial, glass, office glass, and vista gradients. This is one of the colors that are used in the gradient effect.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderColor4 { get; set; }

Gets or sets the border corner radius.

C#
[Browsable(true)]
public int BorderCornerRadius { get; set; }
Property Value:

The border corner radius.

Specifies the style of dashed lines drawn with a border.

C#
public float[] BorderDashPattern { get; set; }

Implements: IBorderElement.BorderDashPattern

Specifies the style of dashed lines drawn with a border.

C#
public DashStyle BorderDashStyle { get; set; }

Implements: IBorderElement.BorderDashStyle

C#
public BorderDrawModes BorderDrawMode { get; set; }

Implements: IBorderElement.BorderDrawMode

Gets or sets gradient angle for linear gradient measured in degrees.

C#
public float BorderGradientAngle { get; set; }

Gets or sets gradient style. Possible styles are solid, linear, radial, glass, office glass, gel, and vista.

C#
public GradientStyles BorderGradientStyle { get; set; }

Gets or sets color used by radial, glass, office glass, gel, and vista gradients. This is one of the colors that are used in the gradient effect.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderInnerColor { get; set; }

Gets or sets color used by radial, glass, office glass, gel, and vista gradients. This is one of the colors that are used in the gradient effect.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderInnerColor2 { get; set; }

Gets or sets color used by radial, glass, office glass, gel, and vista gradients. This is one of the colors that are used in the gradient effect.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderInnerColor3 { get; set; }

Gets or sets color used by radial, glass, office glass, gel, and vista gradients. This is one of the colors that are used in the gradient effect.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderInnerColor4 { get; set; }

Gets and sets the left border color. This applies only if FourBorders is chosen for BoxStyle property, and affects only the left border.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderLeftColor { get; set; }

Gets and sets the left shadow color. This option applies only if fourBorders is chosen, and affects only the left border.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderLeftShadowColor { get; set; }

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.

C#
public float BorderLeftWidth { get; set; }

Gets and sets the right border color. This applies only if FourBorders is chosen for BoxStyle property, and affects only the right border.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderRightColor { get; set; }

Gets and sets the right shadow color. This option applies only if fourBorders is chosen, and affects only the right border.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderRightShadowColor { get; set; }

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

C#
public float BorderRightWidth { get; set; }

Gets and sets the top border color. This applies only if FourBorders is chosen for BoxStyle property, and affects only the top border.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderTopColor { get; set; }

Gets and sets the top shadow color. This option applies only if fourBorders is chosen, and affects only the top border.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color BorderTopShadowColor { get; set; }

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

C#
public float BorderTopWidth { get; set; }

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.

C#
public float BorderWidth { get; set; }
C#
[Browsable(false)]
public ChartElementCollection Children { get; }

Gets the children hierarchy.

C#
[Browsable(false)]
public IEnumerable<RadObject> ChildrenHierarchy { get; }
Property Value:

The children hierarchy.

Implements: IStylableNode.ChildrenHierarchy

Gets the class.

C#
[Browsable(false)]
public string Class { get; }
Property Value:

The class.

Implements: IStylableNode.Class

Gets or sets the dpi scale factor.

C#
public SizeF DpiScaleFactor { get; protected set; }
Property Value:

The dpi scale factor.

Gets whether to fallback to default theme.

C#
[Browsable(false)]
public virtual bool FallbackToDefaultTheme { get; }
Property Value:

The fallback to default theme.

Implements: IStylableElement.FallbackToDefaultTheme

Gets or sets the font.

C#
public Font Font { get; set; }
Property Value:

The font.

Gets or sets the fore color.

C#
[TypeConverter(typeof(RadColorEditorConverter))]
public Color ForeColor { get; set; }
Property Value:

The color of the fore.

Gets or sets the gradient angle.

C#
public float GradientAngle { get; set; }
Property Value:

The gradient angle.

Implements: IFillElement.GradientAngle

Gets or sets the GradientPercentage.

C#
public float GradientPercentage { get; set; }

Implements: IFillElement.GradientPercentage

Gets or sets the GradientPercentage2.

C#
public float GradientPercentage2 { get; set; }

Implements: IFillElement.GradientPercentage2

Gets or sets the gradient style.

C#
public GradientStyles GradientStyle { get; set; }

Implements: IFillElement.GradientStyle

Gets if it is attached.

C#
[Browsable(false)]
public bool IsAttached { get; }
Property Value:

The is attached.

Gets if the mouse is down.

C#
[Browsable(false)]
public bool IsMouseDown { get; }
Property Value:

The is mouse down.

Gets if the mouse is over.

C#
[Browsable(false)]
public bool IsMouseOver { get; }
Property Value:

The is mouse over.

Gets or sets whether the element is visible.

C#
public virtual bool IsVisible { get; set; }

Implements: IChartElementPresenter.IsVisible

Gets the level.

C#
[Browsable(false)]
public int Level { get; }
Property Value:

The level.

Gets or sets the number of colors.

C#
public int NumberOfColors { get; set; }

Implements: IFillElement.NumberOfColors

Gets or sets the padding of the element.

C#
public Padding Padding { get; set; }
Property Value:

The padding.

C#
[Browsable(false)]
public virtual RadObject Parent { get; set; }

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.

C#
[TypeConverter(typeof(ElementShapeConverter))]
public ElementShape Shape { get; set; }
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.

Gets or sets the size of the element which is the height and width of the visual rectangle that would contain the graphics of the element.

C#
[Browsable(true)]
public virtual Size Size { get; set; }

Implements: IFillElement.Size

Gets or sets the SmoothingMode of the element.

C#
public SmoothingMode SmoothingMode { get; set; }

Implements: IFillElement.SmoothingMode

StateManager

ItemStateManagerBase

Gets or sets the state manager.

C#
[Browsable(false)]
public virtual ItemStateManagerBase StateManager { get; set; }
Property Value:

The state manager.

Implements: IStylableElement.StateManager

Gets or sets the style.

C#
[Browsable(false)]
public virtual StyleSheet Style { get; set; }
Property Value:

The style.

Implements: IStylableNode.Style

Gets or sets the theme role.

C#
[Browsable(false)]
public virtual string ThemeRole { get; set; }
Property Value:

The theme role.

Implements: IStylableElement.ThemeRole

Gets the view.

C#
[Browsable(false)]
public ChartView View { get; }
Property Value:

The view.

Gets or sets the state of the visual.

C#
[Browsable(false)]
public virtual string VisualState { get; set; }
Property Value:

The state of the visual.

Implements: IStylableElement.VisualState

Methods

Registers a style setting for this instance.

C#
protected override ValueUpdateResult AddStylePropertySetting(IPropertySetting setting)
Parameters:settingIPropertySettingReturns:

ValueUpdateResult

Overrides: RadObject.AddStylePropertySetting(IPropertySetting)

Applies the style.

C#
protected virtual void ApplyStyle()

Applies the style by the index.

C#
protected virtual void ApplyStyleByIndex(PropertySettingGroup group, int index)
Parameters:groupPropertySettingGroup

The group.

indexint

The index.

Applies the style settings.

C#
protected virtual void ApplyStyleSettingsCore(PropertySettingGroup group)
Parameters:groupPropertySettingGroup

The group.

Attaches the specified parent.

C#
public void Attach(UIChartElement parent)
Parameters:parentUIChartElement

The parent.

Builds the visual state.

C#
protected virtual void BuildVisualState()

Dettaches this instance.

C#
public void Dettach()

Called when DPI scale is changed.

C#
protected virtual void DpiScaleChanged(SizeF scaleFactor)
Parameters:scaleFactorSizeF

The scale factor.

Gets the current shape.

C#
public ElementShape GetCurrentShape()
Returns:

ElementShape

Implements: IShapedElement.GetCurrentShape()

Gets the scaled font.

C#
protected virtual Font GetScaledFont(float scale)
Parameters:scalefloat

The scale.

Returns:

Font

Gets the type of the theme effective.

C#
public virtual Type GetThemeEffectiveType()
Returns:

Type

Implements: IStylableNode.GetThemeEffectiveType()

Retrieves the current value for the specified property.

C#
public override object GetValue(RadProperty property)
Parameters:propertyRadPropertyReturns:

object

Overrides: RadObject.GetValue(RadProperty)

Invalidates the UIChartElement.

C#
public virtual void Invalidate()

Measures the content override.

C#
protected virtual RadSize MeasureContentOverride(ChartNode owner, object content)
Parameters:ownerChartNode

The owner.

contentobject

The content.

Returns:

RadSize

Called when [attached].

C#
protected virtual void OnAttached(UIChartElement parent)
Parameters:parentUIChartElement

The parent.

Called when [dettached].

C#
protected virtual void OnDettached()

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

C#
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters:eRadPropertyChangedEventArgs

The RadPropertyChangedEventArgs containing information about the property change.

Overrides: RadObject.OnPropertyChanged(RadPropertyChangedEventArgs)

Refreshes the UIChartElement.

C#
public virtual void Refresh()
In this article
DefinitionConstructorsUIChartElement()FieldsBackColor2PropertyBackColor3PropertyBackColor4PropertyBackColorPropertyBackgroundShapePropertyBorderBottomColorPropertyBorderBottomShadowColorPropertyBorderBottomWidthPropertyBorderBoxStylePropertyBorderColor2PropertyBorderColor3PropertyBorderColor4PropertyBorderColorPropertyBorderCornerRadiusPropertyBorderDashPatternPropertyBorderDashStylePropertyBorderDrawModePropertyBorderGradientAnglePropertyBorderGradientStylePropertyBorderInnerColor2PropertyBorderInnerColor3PropertyBorderInnerColor4PropertyBorderInnerColorPropertyBorderLeftColorPropertyBorderLeftShadowColorPropertyBorderLeftWidthPropertyBorderRightColorPropertyBorderRightShadowColorPropertyBorderRightWidthPropertyBorderTopColorPropertyBorderTopShadowColorPropertyBorderTopWidthPropertyBorderWidthPropertyClassPropertyCustomFontPropertyCustomFontSizePropertyCustomFontStylePropertyFontPropertyForeColorPropertyGradientAnglePropertyGradientPercentage2PropertyGradientPercentagePropertyGradientStylePropertyIsMouseDownPropertyIsMouseOverPropertyIsVisiblePropertyNumberOfColorsPropertyPaddingPropertyShapePropertySmoothingModePropertyVisualStatePropertyPropertiesBackColorBackColor2BackColor3BackColor4BackgroundShapeBorderBottomColorBorderBottomShadowColorBorderBottomWidthBorderBoxStyleBorderColorBorderColor2BorderColor3BorderColor4BorderCornerRadiusBorderDashPatternBorderDashStyleBorderDrawModeBorderGradientAngleBorderGradientStyleBorderInnerColorBorderInnerColor2BorderInnerColor3BorderInnerColor4BorderLeftColorBorderLeftShadowColorBorderLeftWidthBorderRightColorBorderRightShadowColorBorderRightWidthBorderTopColorBorderTopShadowColorBorderTopWidthBorderWidthChildrenChildrenHierarchyClassDpiScaleFactorFallbackToDefaultThemeFontForeColorGradientAngleGradientPercentageGradientPercentage2GradientStyleIsAttachedIsMouseDownIsMouseOverIsVisibleLevelNumberOfColorsPaddingParentShapeSizeSmoothingModeStateManagerStyleThemeRoleViewVisualStateMethodsAddStylePropertySetting(IPropertySetting)ApplyStyle()ApplyStyleByIndex(PropertySettingGroup, int)ApplyStyleSettingsCore(PropertySettingGroup)Attach(UIChartElement)BuildVisualState()Dettach()DpiScaleChanged(SizeF)GetCurrentShape()GetScaledFont(float)GetThemeEffectiveType()GetValue(RadProperty)Invalidate()MeasureContentOverride(ChartNode, object)OnAttached(UIChartElement)OnDettached()OnPropertyChanged(RadPropertyChangedEventArgs)Refresh()
Not finding the help you need?
Contact Support