Class ChartStyleInfo
This class contains appearance information for each ChartPoint ChartPoint.
Inheritance
Implements
Inherited Members
Namespace: Syncfusion.Windows.Forms.Chart
Assembly: Syncfusion.Chart.Base.dll
Syntax
public class ChartStyleInfo : ChartStyleInfoBase, ICustomTypeDescriptor, IDisposable, IStyleInfo, ISupportInitialize, IFormattable, IConvertible, IXmlSerializable
Constructors
ChartStyleInfo()
Overloaded constructor. Initializes a new style object.
Declaration
public ChartStyleInfo()
ChartStyleInfo(StyleInfoIdentityBase)
Initializes a new style object and associates it with an existing Syncfusion.Windows.Forms.Chart.ChartStyleInfoIdentity.
Declaration
public ChartStyleInfo(StyleInfoIdentityBase identity)
Parameters
| Type | Name | Description |
|---|---|---|
| StyleInfoIdentityBase | identity | A Syncfusion.Windows.Forms.Chart.ChartStyleInfoIdentity that holds the identity for this ChartStyleInfo. |
ChartStyleInfo(StyleInfoIdentityBase, ChartStyleInfoStore)
Initializes a new style object and associates it with an existing Syncfusion.Windows.Forms.Chart.ChartStyleInfoIdentity.
Declaration
public ChartStyleInfo(StyleInfoIdentityBase identity, ChartStyleInfoStore store)
Parameters
| Type | Name | Description |
|---|---|---|
| StyleInfoIdentityBase | identity | A Syncfusion.Windows.Forms.Chart.ChartStyleInfoIdentity that holds the identity for this ChartStyleInfo. |
| ChartStyleInfoStore | store | A ChartStyleInfoStore that holds data for this ChartStyleInfo. All changes made in this style object will be saved in the ChartStyleInfoStore object. |
ChartStyleInfo(ChartStyleInfo)
Initializes a new style object and copies all data from an existing style object.
Declaration
public ChartStyleInfo(ChartStyleInfo style)
Parameters
| Type | Name | Description |
|---|---|---|
| ChartStyleInfo | style | The style object that contains the original data. |
ChartStyleInfo(ChartStyleInfoStore)
Initializes a new style object and associates it with an existing ChartStyleInfoStore.
Declaration
public ChartStyleInfo(ChartStyleInfoStore store)
Parameters
| Type | Name | Description |
|---|---|---|
| ChartStyleInfoStore | store | A ChartStyleInfoStore that holds data for this ChartStyleInfo. All changes made in this style object will be saved in the ChartStyleInfoStore object. |
Properties
AltTagFormat
Gets or sets the alt tag with default settings that is to be used. this is used in ASP.NET chart to define the format of "alt" tag value. for the appearance of the ChartPoint.
Declaration
public string AltTagFormat { get; set; }
Property Value
| Type |
|---|
| System.String |
BaseStyle
Gets or sets the base style with default settings that is to be used for the appearance of the ChartPoint.
Declaration
public string BaseStyle { get; set; }
Property Value
| Type |
|---|
| System.String |
Border
Gets or sets the information that is to be used for drawing lines.
Declaration
[ChartTemplate(ChartTemplateSet.Content)]
public ChartLineInfo Border { get; set; }
Property Value
| Type | Description |
|---|---|
| ChartLineInfo | The border. |
Callout
Gets or sets the attributes of the Callout that is to be displayed at this point.
Declaration
[ChartTemplate(ChartTemplateSet.Content)]
public ChartCalloutInfo Callout { get; set; }
Property Value
| Type | Description |
|---|---|
| ChartCalloutInfo | The Callout. |
CustomProperties
Returns a collection of custom property objects that have at least one initialized value. The primary purpose of this collection is to support design-time code serialization of custom properties.
Declaration
public ChartStyleInfoCustomPropertiesCollection CustomProperties { get; }
Property Value
| Type |
|---|
| ChartStyleInfoCustomPropertiesCollection |
Default
Returns a ChartStyleInfo with default settings.
Declaration
public static ChartStyleInfo Default { get; }
Property Value
| Type |
|---|
| ChartStyleInfo |
DimmedInterior
Gets or sets the attributes of the brush that are to be used to hide this point when the mouse moves over on other point.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public BrushInfo DimmedInterior { get; set; }
Property Value
| Type |
|---|
| BrushInfo |
DisplayShadow
Gets a value indicating whether a shadow should be rendered when this point is displayed.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public bool DisplayShadow { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
DisplayText
Gets or Sets whether text should be displayed at this point.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public bool DisplayText { get; set; }
Property Value
| Type |
|---|
| System.Boolean |
DrawTextShape
Gets or sets whether text should be draw with shape in the background at this point.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public bool DrawTextShape { get; set; }
Property Value
| Type |
|---|
| System.Boolean |
ElementBorders
Gets or sets the border settings for elements associated with the chart point. You can specify the inner and outer border. It is currently used only by symbols rendered by the ChartPoint.
Declaration
[Obsolete("This property isn't used anymore. Use the Symbol.Border property.")]
public ChartBordersInfo ElementBorders { get; set; }
Property Value
| Type |
|---|
| ChartBordersInfo |
Font
Gets /sets the font that is to be used for drawing text.
Declaration
public ChartFontInfo Font { get; set; }
Property Value
| Type | Description |
|---|---|
| ChartFontInfo | The font. |
Format
Gets or sets the stringformat.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public StringFormat Format { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Drawing.StringFormat | The format. |
GdipFont
Creates or returns a cached GDI+ font generated from font information of the Font object.
Declaration
public Font GdipFont { get; }
Property Value
| Type | Description |
|---|---|
| System.Drawing.Font | The gdip font. |
GdipPen
Creates or returns a cached GDI+ font generated from font information of the Font object.
Declaration
public Pen GdipPen { get; }
Property Value
| Type | Description |
|---|---|
| System.Drawing.Pen | The gdip pen. |
HasBaseStyle
Gets a value indicating whether this instance has base style.
Declaration
public bool HasBaseStyle { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasBorder
Gets a value indicating whether line information has been initialized for the current object.
Declaration
public bool HasBorder { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasCallout
Gets a value indicating whether Callout information has been initialized for the current object.
Declaration
public bool HasCallout { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasDimmedInterior
Gets a value indicating whether this style contains the local value of DimmedInterior property.
Declaration
public bool HasDimmedInterior { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasDisplayShadow
Declaration
public bool HasDisplayShadow { get; }
Property Value
| Type |
|---|
| System.Boolean |
HasDisplayText
Gets a value indicating whether this style contains the local value of DisplayText property.
Declaration
public bool HasDisplayText { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasElementBorders
Gets a value indicating whether this style contains the local value of ElementBorders property.
Declaration
public bool HasElementBorders { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasFont
Gets a value indicating whether font information has been initialized for the current object.
Declaration
public bool HasFont { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasFormat
Declaration
public bool HasFormat { get; }
Property Value
| Type |
|---|
| System.Boolean |
HasHighlightInterior
Gets a value indicating whether this style contains the local value of HighlightInterior property.
Declaration
public bool HasHighlightInterior { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasHighlightOnMouseOver
Gets a value indicating whether this style contains the local value of HighlightOnMouseOver property.
Declaration
[Obsolete("This property isn't used anymore.")]
public bool HasHighlightOnMouseOver { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasHitTestRadius
Gets a value indicating whether this style contains the local value of HitTestRadius property.
Declaration
public bool HasHitTestRadius { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasImageIndex
Gets a value indicating whether image index information has been initialized for the current object.
Declaration
public bool HasImageIndex { get; }
Property Value
| Type |
|---|
| System.Boolean |
HasImages
Gets a value indicating whether ImageList information has been initialized for the current object.
Declaration
public bool HasImages { get; }
Property Value
| Type |
|---|
| System.Boolean |
HasInterior
Gets a value indicating whether interior information has been initialized for the current object.
Declaration
public bool HasInterior { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasLabel
Gets a value indicating whether this style contains the local value of Label property.
Declaration
public bool HasLabel { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasPointWidth
Gets a value indicating whether this style contains the local value of PointWidth property.
Declaration
public bool HasPointWidth { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasRelatedPoints
Gets a value indicating whether this instance has related points.
Declaration
public bool HasRelatedPoints { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasShadowInterior
Gets a value indicating whether this style contains the local value of ShadowInterior property.
Declaration
public bool HasShadowInterior { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasShadowOffset
Gets a value indicating whether this style contains the local value of ShadowOffset property.
Declaration
public bool HasShadowOffset { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasSymbol
Gets a value indicating whether symbol information has been initialized for the current object.
Declaration
public bool HasSymbol { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasText
Gets a value indicating whether text information has been initialized for the current object.
Declaration
public bool HasText { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasTextColor
Gets a value indicating whether this instance has text color.
Declaration
public bool HasTextColor { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasTextFormat
Gets a value indicating whether this style contains the local value of TextFormat property.
Declaration
public bool HasTextFormat { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasTextOffset
Gets a value indicating whether this style contains the local value of TextOffset property.
Declaration
public bool HasTextOffset { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasTextOrientation
Gets a value indicating whether this instance has text orientation.
Declaration
public bool HasTextOrientation { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasToolTip
Gets a value indicating whether ToolTip information has been initialized for the current object.
Declaration
public bool HasToolTip { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasToolTipFormat
Gets a value indicating whether this instance has tool tip format.
Declaration
public bool HasToolTipFormat { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HasUrl
Gets a value indicating whether Url information has been initialized for the current object.
Declaration
public bool HasUrl { get; }
Property Value
| Type | Description |
|---|---|
| System.Boolean |
|
HighlightInterior
Gets or sets the attributes of the brush that are to be used to highlight this point when the mouse moves over it and HasHighlightOnMouseOver is enabled.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public BrushInfo HighlightInterior { get; set; }
Property Value
| Type |
|---|
| BrushInfo |
HighlightOnMouseOver
Gets a value indicating whether this point should be highlighted when the mouse moves over it.
Declaration
[Obsolete("This property isn't used anymore.")]
public bool HighlightOnMouseOver { get; set; }
Property Value
| Type |
|---|
| System.Boolean |
HitTestRadius
Controls the circle around this point that would be considered as being within the bounds of this point for hit-testing purposes.
Declaration
public float HitTestRadius { get; set; }
Property Value
| Type |
|---|
| System.Single |
ImageIndex
Gets or sets the image index from the associated System.Windows.Forms.ImageList property.
Declaration
public int ImageIndex { get; set; }
Property Value
| Type | Description |
|---|---|
| System.Int32 | The index of the image. |
Images
Gets or sets the imagelist that is to be associated with this ChartPoint. This property is used in conjunction with the ImageIndex property to display images associated with this point.
Declaration
[ChartTemplate(ChartTemplateSet.Collection)]
public ChartImageCollection Images { get; set; }
Property Value
| Type | Description |
|---|---|
| ChartImageCollection | The images. |
Interior
Gets or sets a solid backcolor, gradient or pattern style with both back and forecolor for a ChartPoint's background.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public BrushInfo Interior { get; set; }
Property Value
| Type | Description |
|---|---|
| BrushInfo | The interior. |
Label
Gets or sets the Label value.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public string Label { get; set; }
Property Value
| Type |
|---|
| System.String |
PointWidth
Gets or sets the width of this point relative to the total width available. It is specially useful with Gantt charts to render series that overlap.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public float PointWidth { get; set; }
Property Value
| Type |
|---|
| System.Single |
RelatedPoints
Gets or sets the offset of the text from the position of the ChartPoint.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public ChartRelatedPointInfo RelatedPoints { get; set; }
Property Value
| Type |
|---|
| ChartRelatedPointInfo |
ShadowInterior
Gets or sets the interior attributes of the shadow displayed underneath this point.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public BrushInfo ShadowInterior { get; set; }
Property Value
| Type |
|---|
| BrushInfo |
ShadowOffset
Gets or sets the offset that is to be used when a shadow is rendered for this ChartPoint.
Declaration
public Size ShadowOffset { get; set; }
Property Value
| Type |
|---|
| System.Drawing.Size |
Store
Gets the ChartStyleInfoStore object that holds all the data for this style object.
Declaration
public ChartStyleInfoStore Store { get; }
Property Value
| Type |
|---|
| ChartStyleInfoStore |
Symbol
Gets or sets the attributes of the symbol that is to be displayed at this point.
Declaration
[ChartTemplate(ChartTemplateSet.Content)]
public ChartSymbolInfo Symbol { get; set; }
Property Value
| Type | Description |
|---|---|
| ChartSymbolInfo | The symbol. |
Text
Gets or sets the text that is to be associated with a ChartPoint. This text will be rendered at a position near the point if DisplayText is set to True.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public string Text { get; set; }
Property Value
| Type | Description |
|---|---|
| System.String | The text. |
TextColor
Gets or sets the color of the text that is to be rendered for a ChartPoint.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public Color TextColor { get; set; }
Property Value
| Type |
|---|
| System.Drawing.Color |
TextFormat
Gets or sets the format that is to be applied to values that are displayed as text.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public string TextFormat { get; set; }
Property Value
| Type |
|---|
| System.String |
TextOffset
Gets or sets the offset of the text from the position of the ChartPoint.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public float TextOffset { get; set; }
Property Value
| Type |
|---|
| System.Single |
TextOrientation
Gets or sets the orientation of text that is to be displayed at this point.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public ChartTextOrientation TextOrientation { get; set; }
Property Value
| Type |
|---|
| ChartTextOrientation |
TextShape
Gets or sets custom shape in the background of the displaytext. Before use this, enable "DrawTextShape" property of series style.
Declaration
public ChartCustomShapeInfo TextShape { get; set; }
Property Value
| Type |
|---|
| ChartCustomShapeInfo |
ToolTip
Gets or sets the ToolTip that is to be associated with the ChartPoint.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public string ToolTip { get; set; }
Property Value
| Type | Description |
|---|---|
| System.String | The tool tip. |
ToolTipFormat
Gets or sets the formatting that is to be applied to values that are displayed as ToolTips.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public string ToolTipFormat { get; set; }
Property Value
| Type | Description |
|---|---|
| System.String | The tool tip format. |
Url
Gets or sets the Url that is to be associated with a ChartPoint. This Url will be applied to the point if EnableUrl and CalcRegion property is set to True.This property is applicable only for ChartWeb.
Declaration
[ChartTemplate(ChartTemplateSet.Simple)]
public string Url { get; set; }
Property Value
| Type | Description |
|---|---|
| System.String | The Url. |
Methods
CopyFrom(IStyleInfo)
Copies properties from another style object. This method raises Changing and Changed notifications if the other object differs. (ModifyStyle does not raise these events).
Declaration
public void CopyFrom(IStyleInfo iStyle)
Parameters
| Type | Name | Description |
|---|---|---|
| IStyleInfo | iStyle | The style object to be applied on the current object. |
CreateSubObjectIdentity(StyleInfoProperty)
Override this method to create a product-specific identity object for a sub object.
Declaration
public override StyleInfoSubObjectIdentity CreateSubObjectIdentity(StyleInfoProperty sip)
Parameters
| Type | Name | Description |
|---|---|---|
| StyleInfoProperty | sip |
Returns
| Type | Description |
|---|---|
| StyleInfoSubObjectIdentity | An identity object for a subobject of this style. |
Overrides
Dispose()
Method to dispose ChartStyleInfo object
Declaration
public void Dispose()
ResetBaseStyle()
Resets the base style.
Declaration
public void ResetBaseStyle()
ResetBorder()
Resets line information.
Declaration
public void ResetBorder()
ResetCallout()
Resets Callout information.
Declaration
public void ResetCallout()
ResetDimmedInterior()
Resets DimmedInterior.
Declaration
public void ResetDimmedInterior()
ResetDisplayShadow()
Resets DisplayShadow.
Declaration
public void ResetDisplayShadow()
ResetDisplayText()
Resets DisplayText.
Declaration
public void ResetDisplayText()
ResetElementBorders()
Resets border information.
Declaration
public void ResetElementBorders()
ResetFont()
Resets font information.
Declaration
public void ResetFont()
ResetFormat()
Resets the Format.
Declaration
public void ResetFormat()
ResetHighlightInterior()
Declaration
public void ResetHighlightInterior()
ResetHighlightOnMouseOver()
Declaration
[Obsolete("This method isn't used anymore.")]
public void ResetHighlightOnMouseOver()
ResetHihglightInterior()
Declaration
[Obsolete("Use ResetHighlightInterior")]
public void ResetHihglightInterior()
ResetHitTestRadius()
Resets HitTestRadius.
Declaration
public void ResetHitTestRadius()
ResetImageIndex()
Resets image index information.
Declaration
public void ResetImageIndex()
ResetImages()
Resets ImageList information.
Declaration
public void ResetImages()
ResetInterior()
Resets interior information.
Declaration
public void ResetInterior()
ResetLabel()
Resets Label.
Declaration
public void ResetLabel()
ResetName()
Resets Name.
Declaration
public void ResetName()
ResetPointWidth()
Resets PointWidth.
Declaration
public void ResetPointWidth()
ResetRelatedPoints()
Resets RelatedPoints.
Declaration
public void ResetRelatedPoints()
ResetShadowInterior()
Resets ShadowInterior.
Declaration
public void ResetShadowInterior()
ResetShadowOffset()
Resets ShadowOffset.
Declaration
public void ResetShadowOffset()
ResetSymbol()
Resets symbol information.
Declaration
public void ResetSymbol()
ResetSystem()
Resets System.
Declaration
public void ResetSystem()
ResetText()
Resets text information.
Declaration
public void ResetText()
ResetTextColor()
Resets TextColor.
Declaration
public void ResetTextColor()
ResetTextFormat()
Resets TextFormat.
Declaration
public void ResetTextFormat()
ResetTextOffset()
Reset TextOffset.
Declaration
public void ResetTextOffset()
ResetTextOrientation()
Resets TextOrientation.
Declaration
public void ResetTextOrientation()
ResetToolTip()
Resets ToolTip information.
Declaration
public void ResetToolTip()
ResetToolTipFormat()
Resets TooltipFormat.
Declaration
public void ResetToolTipFormat()
ResetUrl()
Resets Url information.
Declaration
public void ResetUrl()
WriteXmlSchema(XmlWriter)
Serializes this style to XML.
Declaration
public void WriteXmlSchema(XmlWriter xw)
Parameters
| Type | Name | Description |
|---|---|---|
| System.Xml.XmlWriter | xw |