A custom object implementing IAnnotation can be added to an UltraChart's Annotations collection, and thus be rendered on a chart like any other type of annotation object.
Alternatively, an IAnnotation object's RenderAnnotation method can be called from a custom layer, which would cause it to be rendered to the SceneGraph using the specified parameters for location.
In this method body, the Primitives which constitute the annotation should be created and added using the SceneGraph.Add method.
This overload of the RenderAnnotation method will be called by the Annotation Layer when an annotation's Location has matched with a parent primitive. For example, if the annotation's Row and Column are the same as another primitive's, a parent primitive has been found for the annotation, and this method will be called.
If multiple parent matches have been found for a single annotation, for example if the annotation uses the -2 wildcard for its row and/or column property, a single annotation will match many parents and thus, this method will be called many times.
In this method body, the Primitives which constitute the annotation should be created and added using the SceneGraph.Add method.
This overload of the RenderAnnotation method will be called by the Annotation Layer, with a Point provided as the basis for adding the annotation. This point will have been calculated by the Annotation Layer based on the property values specified by the Annotation's Location property.
In this method body, the Primitives which constitute the annotation should be created and added using the SceneGraph.Add method.
This overload of the RenderAnnotation method will be called by the Annotation Layer when an annotation's Location has matched with a parent primitive. For example, if the annotation's Row and Column are the same as another primitive's, a parent primitive has been found for the annotation, and this method will be called.
If multiple parent matches have been found for a single annotation, for example if the annotation uses the -2 wildcard for its row and/or column property, a single annotation will match many parents and thus, this method will be called many times.
In this method body, the Primitives which constitute the annotation should be created and added using the SceneGraph.Add method.
This overload of the RenderAnnotation method will be called by the Annotation Layer, with a Point provided as the basis for adding the annotation. This point will have been calculated by the Annotation Layer based on the property values specified by the Annotation's Location property.
This is not the Clone() method typically called by the chart core; it is only to implement ICloneable. This method will directly call the strongly-typed Clone() method of the Annotation.
Implemented in order for the collection editor to indicate the type of each Annotation in the list of annotations in the collection.
Generally, a center point from the parent primitive is used. Inheritors can override this method to return a different point.
If creating an annotations collection in code, pass either a reference to an instance of an UltraChart component, or null. The component reference is actually not needed unless this collection is going to be viewed in a designer (like a properties grid) in conjunction with a particular UltraChart component.
This is not the Clone() method typically called by the chart core; it is only to implement ICloneable. This method will directly call the strongly-typed Clone() method of the AnnotationCollection.
If the height and/or width properties are set to a neutral values (less than 0), this method returns an appropriate size for the box by measuring the string to be displayed in the box, using the font specified in the TextStyle. This size is then multiplied by an inflation factor (1.1) in order to provide spacing around the text.
The default rendering point for "child" annotations is used as the render point for this box.
If the height and/or width properties are set to a neutral values (less than 0), this method returns an appropriate size for the bubble by measuring the string to be displayed in the bubble, using the font specified in the TextStyle. This size is then multiplied by an inflation factor (1.1) in order to provide spacing around the text.
The default rendering point for "child" annotations is used as the render point for this callout.
The default rendering point for "child" annotations is used as the render point and offset point for this callout.
The default rendering point for "child" annotations is used as the render point for this callout.
The default rendering point for "child" annotations is used as the render point for this callout.
The default rendering point for "child" annotations is used as the render point for this ellipse.
The default rendering point for "child" annotations is used as the render point for this line.
The default rendering point for "child" annotations is used as the render point and offset point for this line.
The default rendering point for "child" annotations is used as the render point for this line.
The default rendering point for "child" annotations is used as the render point for this line.
The Annotation Layer will set this value based on the chart's outer bounds.
The Annotation Layer will set this value based on the chart's outer bounds.
The default rendering point for "child" annotations is used as the render point for this line+image annotation.
The default rendering point for "child" annotations is used as the render point and offset point for this line+image annotation.
The default rendering point for "child" annotations is used as the render point for this line+image annotation.
The default rendering point for "child" annotations is used as the render point for this line+image annotation.
The Annotation Layer will set this value based on the chart's outer bounds.
The Annotation Layer will set this value based on the chart's outer bounds.
This constructor only initializes the Property Out of Range field with the localized content.
It does not set the IChartComponent reference since that will be set at a later time when the Appearance object is 'set' into the Chart.
This constructor initializes the Property Out of Range field with the localized content and sets the IChartComponent reference at the time the Appearance object is instantiated.
The specified IChartComponent will receive update notifications to repaint itself when UpdateAll is called unless the noUpdate flag has been set.
Often the represented IChartComponent cannot be ascertained at the time the ChartAppearance is first instantiated, so it may be set at a later time by means of this method.
Inheritors should override to fill in value in design time properties window.
If this property is set to Rectangle.Empty, then the entire Chart surface (100%) is used.
If the BoundsMeasureType property is set to Percentage, then this Rectangle will use percentage values instead of pixels.
This method is used by the chart infrastructure and is not intended for use at the application level.
Note: setting this property will cause a number of property settings to be reset, in order for the new ChartType to initialize.
This property is accessed by the chart core when determining whether or not to redraw the chart.
This interface member is used to get a value for one location on a scale.
This interface member is used to determine if an item can be plotted on a scale, given its available/visible range.
This interface member is used to locate, or change the location of, the minimum numeric value on a scale.
This interface member is used to locate, or change the location of, the maximum numeric value on a scale.
This interface member returns the range between the minimum and maximum locations on the owning scale.
IAdvanceAxis contains all the necessary members for working with an axis, whether it is Numeric, Set Label, or DateTime.
The Ruler Type will determine how values are plotted on the axis.
Zero or Zero equivalent. For linear numeric types, this would be Zero, for other types, this would be a center, neutral, or minimum value.
If True, a tickmark must be provided at zero, and tickmarks should deviate from zero at the appropriate interval.
If False, a tickmark should be provided at the set minimum, and tickmarks should increment at the appropriate interval.
This method is used to locate numeric points on the ruler.
This method is used to get a value for a known location on the ruler.
This is a calculated property. It does not return a stored value.
This is a calculated property. It does not return a stored value.
This is a calculated property. It does not return a stored value.
This is a calculated property. It does not return a stored value.
Because the Maximum property is subject to change by various layers and entities in the chart core, each ruler maintains its internal maximum for its own use.
This is a calculated property. It does not return a stored value.
Because the Minimum property is subject to change by various layers and entities in the chart core, each ruler maintains its internal minimum for its own use.
This is a calculated property. It does not return a stored value.
Because the Minimum and Maximum properties are subject to change by various layers and entities in the chart core, each ruler maintains its internal range for its own use.
This is a calculated property. It does not return a stored value.
Advanced developers may use this method from the application-level to access individual
After directly manipulating the Primitive objects returned by this method, the developer must call InvalidateLayers to refresh the chart image.
The 3-D Area Chart is rendered similarly to the
This method is typically used in the Chart Core to get properties that are set at the application levels.
Override this method in each layer and return the appearance object for that layer from IChartComponent using the ChartAppearanceTypes Enum.
Override this method to check that the data meets the needs of each chart type, some chart types may have stringent requirements.
The protected field,
Override this method to return the correct error message for the invalid state of the data. This message will be printed on the chart for the user.
This field can be used to toggle the visibility of different layers. For example, pie chart has no grid, so GridLayer's visible is set to false.
This method can be used to toggle the visibility of different layers. For example, pie chart has no grid, so GridLayer's Visible is set to false.
This property can be used to toggle the visibility of different layers. For example, pie chart has no grid, so GridLayer's Visible is set to false.
The reference returned will be to an
Function calculating the data value corresponding to the proverbial floor (or ground X-Y plane in 3-D charts) of the chart. Developers'
Calculation of the zero line is with regard to:
The color model set here is used throughout the layer for obtaining opacity (alpha), starting and ending color ranges.
Most subclasses overriding this method should call the base implementation of
Inheritors should call the base class implementation of this method and then provide any supplemental scene construction logic in their own Layer's overriden version of this method.
Override this method to check that the data meets the needs of each chart type, some chart types may have stringent requirements.
The protected field,
Inheritors should override this method to return the proper error message for any invalid state(s) of the chart's data in their custom
The reference returned will be to an
In 3-D chart types, the
The 3-D Area Chart is rendered similarly to the
It is possible, at times, for the WindowMinimum and WindowMaximum axis properties to return incorrect values. It may be necessary to use this method to recalculate them.
This method is used to locate numeric points on the axis.
This method is used to get a value for a known location on the axis.
This method is typically used in the Chart Core to get properties that are set at the application levels.
This method is typically used in the Chart Core to get properties that are set at the application levels.
The 3-D Column Chart is rendered with columns (vertically-oriented boxes) in a series progressing from along the horizontal axis, and with columns of separate series appearing at progressive depths.
Adds the data requirement that stacked 3-D column charts can't have both positive and negative data values.
This method is typically used in the Chart Core to get properties that are set at the application levels.
Pie3DLayer FillSceneGraph will draw Three-Dimensional Wedges, representing the chart data.
Doughnut3DLayer FillSceneGraph will draw Three-Dimensional Wedges, representing the chart data.
Inheritors should override this method to return the proper error message for any invalid state(s) of the chart's data in their custom
Hierarchical3DLayer FillSceneGraph will draw Funnel, Cone, or Pyramid bands, representing the chart data.
When a chart is a stacked bar chart, it cannot have both positive and negative data values. All data values must share the same sign. This does not apply to regular column charts, which can contain columns both left and right of the Y-Axis.
Subclass implementations should call the base class implementation, before adding additional data checks, and set
The same blended iso-color is always returned for a given data value, as long as the Color Model has remained constant.
Blending is performed through linear interpolation equally across the Red, Green and Blue portions of the spectrum. It is not possible for the color returned to vary in fewer than all three primary colors unless the value of the primary color is identical in startColor and endColor.
Any opacity (or alpha) value in the supplied colors is ignored. Instead, the
The color returned shall have the opacity (or alpha) value of color1.
Implementers should override this method (being sure to call the base class implementation, if any) and add additional validity constraints when the base class implementation indicates the data may be valid.
Heat Map chart types require at least 2 rows and 2 columns, since this is the minimum amount of data necessary to plot a four-corner surface (with each corner affixed to the X- and/or Z- axes).
This method is typically used in the Chart Core to get properties that are set at the application levels.
Override this method to return the correct error message for the invalid state of the data. This message will be printed on the chart for the user.
It is possible, at times, for the Scale and Scroll axis properties to return incorrect values. It may be necessary to use this method to recalculate them.
It is possible, at times, for the WindowMinimum and WindowMaximum axis properties to return incorrect values. It may be necessary to use this method to recalculate them.
This method is used to locate numeric points on the axis.
This method is used to get a value for a known location on the axis.
This method will return a value equivalent to the maximum data value
This method is typically used in the Chart Core to get properties that are set at the application levels.
Pie3DLayer FillSceneGraph will draw Three-Dimensional Wedges, representing the chart data.
Inheritors should override this method to return the proper error message for any invalid state(s) of the chart's data in their custom
It is possible, at times, for the Scale and Scroll axis properties to return incorrect values. It may be necessary to use this method to recalculate them.
It is possible, at times, for the WindowMinimum and WindowMaximum axis properties to return incorrect values. It may be necessary to use this method to recalculate them.
This method is used to locate numeric points on the axis.
This method is used to get a value for a known location on the axis.
This method is typically used in the Chart Core to get properties that are set at the application levels.
SetupDataFilter is not intended for use in ThreeDGridLayer; it is overridden to prevent calls to this method on the parent class.
This method is typically used in the Chart Core to get properties that are set at the application level.
A spline tension of 0.0 produces straight lines.
In SplineArea chart, setting this to true permits the chart to render without
Override this method to check that the data meets the needs of each chart type, some chart types may have stringent requirements.
The protected field,
It is possible, at times, for the WindowMinimum and WindowMaximum axis properties to return incorrect values. It may be necessary to use this method to recalculate them.
This method is used to locate numeric points on the axis.
This method is typically used in the Chart Core to get properties that are set at the application levels.
When a chart is a stacked bar chart, it cannot have both positive and negative data values. All data values must share the same sign. This does not apply to regular column charts, which can contain columns both left and right of the Y-Axis.
Subclass implementations should call the base class implementation, before adding additional data checks, and set
This method is typically used in the Chart Core to get properties that are set at the application levels.
BorderLayer FillSceneGraph will render the border, including border color and border effects, as well as a Background Image if necessary.
Besides the total chart area, factors that will affect the Inner Bounds Calculation for BorderLayer include border roundness, border thickness, or a raised border.
When a chart is a stacked column chart, it cannot have both positive and negative data values. All data values must share the same sign. This does not apply to regular column charts, which can contain columns both above and below the X-Axis.
Subclass implementations should call the base class implementation, before adding additional data checks, and set
This layer is instantiated by the chart infrastructure to process data. It adds
Implementers should override this method (being sure to call the base class implementation, if any) and add additional validity constraints when the base class implementation indicates the data may be valid.
X/Y charts require, at minimum, numeric columns for both the X and Y dimensions of the grid.
For charts that use the XYChartLayer, such as Scatter and Bubble charts, this method takes care of the settings for relevant columns, such as ColumnX and ColumnY properties.
All layers override this method to provide their own Appearance object that will govern the scene's presentation. When this method returns non-null, it is safe to cast the resulting
This method encapsulates the default logic of assuming the first three numeric columns encountered are the
Bubble Chart requires that there exist at least three numeric columns of data. The first two columns specify the X- and Y-coordinates at which to plot the bubble, while the third column, Z, specifies the radius of the bubble.
The effects of calling this method are internal to
Layers override this method to furnish the chart infrastructure with a localized text message to present the user when the data is invalid for this chart type.
All layers override this method to provide functionality specific to their presentation. This method should call its base class' FillSceneGraph method, and should then add graphical
The
This method is typically used in the Chart Core to get properties that are set at the application levels.
CandleLayer FillSceneGraph will render lines and boxes, representing the chart data in a candle chart.
CandleLayer FillSceneGraph will render lines and boxes, representing the chart data in a candle chart.
Some charts have stringent standards for data validity, others do not. The ValidateDataForChart method is used to pass or fail a given data source for this particular chart layer.
Inheritors should override this method to return the proper error message for any invalid state(s) of the chart's data in their custom
This class inherits from ChartLayer because it needs access to Color Model.
This method will be called when the Series collection is used for a non-composite chart.
CandleLegendLayer will render a special type of legend designed for candle charts.
If no match is found, this method will return null.
When a chart is a stacked column chart, it cannot have both positive and negative data values. All data values must share the same sign. This does not apply to regular column charts, which can contain columns both above and below the X-Axis.
Subclass implementations should call the base class implementation, before adding additional data checks, and set
In ColumnLayer, LayerID will vary depending on whether or not this layer is part of a combination chart, such as ColumnLineChart, or not.
CrossHairLayer FillSceneGraph will draw a CrossHair on the chart area.
DiscreteColorLegendLayer FillSceneGraph draws a legend, inside a rectangle, with boxes and labels to indicate the colors used in the chart as they correspond to different data items or series.
This method is typically used in the Chart Core to get properties that are set at the application levels.
DoughnutLayer FillSceneGraph will render a doughnut shape to the chart area, with sections corresponding to the chart data.
Override this method to return the correct error message for the invalid state of the data. This message will be printed on the chart for the user.
There is no initialization particular to the DrillLayer class. It would not, for instance, be useful to store the DrillDownAppearance settings of ShowButtons and Enabled here, since they can change at any time.
This initializes the DrillLayer's drill back button color. By default, the drill back button is always rendered at the top left of the Chart's grid region.
This initializes the DrillLayer's drill back button color, and it's position along the edge of the chart to one of eight possible alignments (the default is normally TopLeft.)
This implementation first calls the parent class implementation, if any, and then proceeds to render a drill back button box in the upper left corner of the chart's grid.
HierarchicalChartLayer FillSceneGraph will draw Funnel or Pyramid bands representing the chart data.
When a chart is a stacked bar chart, it cannot have both positive and negative data values. All data values must share the same sign. This does not apply to regular column charts, which can contain columns both left and right of the Y-Axis.
Subclass implementations should call the base class implementation, before adding additional data checks, and set
This method is typically used in the Chart Core to get properties that are set at the application level.
This method is typically used in the Chart Core to get properties that are set at the application level.
Override this method to return the correct error message for the invalid state of the data. This message will be printed on the chart for the user.
This method is typically used in the Chart Core to get properties that are set at the application levels.
This axis class can be used for uneven or jagged sets of data, where each series does not necessarily have an equal number of items.
In order to use this axis class, an object implementing IProvideGroupedLabels must be provided using the GroupedLabelProvider property.
The term BarHeight is used for clarity in terms of a vertical axis, as in a bar chart. If this axis is a horizontal axis, this property should return the width of each item. If data elements other than bars are being used, this property should still return the height (or width) of each item. This property is used for sizing and spacing the labels and gridlines.
HeatMapLayer FillSceneGraph uses the chart data to generate cells of various colors, each of which represents a value in the data.
Depending on the RenderQuality of the HeatMapAppearance, the cells may be divided evenly into multiple parts, which results in a "smoother" blending of colors. Separate primitives are used for each region of each cell in the Heat Map.
When a chart is a stacked column chart, it cannot have both positive and negative data values. All data values must share the same sign. This does not apply to regular column charts, which can contain columns both above and below the X-Axis.
Subclass implementations should call the base class implementation, before adding additional data checks, and set
This
Scatter charts require special icon handling because they may plot series characters or special symbols to the chart that need corresponding entries in the Legend.
Scatter charts require special icon handling because they may plot series characters or special symbols to the chart that need corresponding entries in the Legend.
Bubble charts require icons that display a descending scale of bubbles (by radius value) in the Legend for visual comparison to the chart.
Since estimating bubble radius by eye may not be optimal for all users, developers are encouraged to use an alternative means of conveying precise radius values to the user. The
Scatter chart requires at least one row and at least 2 columns, for ColumnX and ColumnY.
For a
Updates graphical elements on the skin marked skin-capable with a PaintElement from the appropriate
When a chart is a stacked column chart, it cannot have both positive and negative data values. All data values must share the same sign. This does not apply to regular column charts, which can contain columns both above and below the X-Axis.
Subclass implementations should call the base class implementation, before adding additional data checks, and set
Inheritors should override this method to return the proper error message for any invalid state(s) of the chart's data in their custom
This method is used to locate numeric points on the axis.
This method is typically used in the Chart Core to get properties that are set at the application levels.
Setting this property affects this layer as well as its contingent title panels.
The tool tip text is rendered in the font specified by the WinTooltipAppearance properties
When a non-null
The Primitive class is the base class of all other graphical chart elements. They make up the axes, labels, on-chart text, bars, columns and other entities that are presented to the user.
Each graphical chart is comprised of
Developers have considerable flexibility in accessing and manipulating Primitives, particularly in custom Layer implementations, to add powerful new visual functionality to their chart applications.
A Primitive created with this constructor belongs to no Layer.
Primitives support being associated with other Primitives in arbitrary relationships.
Subclasses must override this method and provide state management for storing a list of Primitives if any containment relationship or affiliation exists.
When implemented by a subclass, this method indicates that the specified point is within the confines of this Primitive.
Used for composite charts where a Primitive may not be visible because it is outside the bounds of its ChartArea.
This method requires that the Layer property of this Primitive is set, in order to reference the ChartComponent, ChartCore, and ChartType in context.
Highlighting is performed by creating another Primitive object of the same shape and size as the current Primitive, and placing it in the foreground at the Primitive's current location. The colors that should be used for the highlighting are set by the developer in the Properties Editor for the currently active chart appearance.
When implemented by a subclass, this method allows the Primitive to create another Primitive of the same shape and size, and the specified color style configured by the developer, that highlights it. The implementation should add the highlighting Primitive to the passed in SceneGraph object.
This auxillary method can be used for hit and edge detection.
This class property is read-only.
Primitives have varying degrees of support for the advanced painting features of the
Primitives have varying degrees of support for the advanced skinning feature. Please consult the documentation for
Primitives are initialized to the Row and
Primitives are initialized to the
This property can contain any object reference designating the source, target, or purpose of this Primitive. For example, the Value property can be used to hold an item being rendered. It can hold the value that should be displayed in a tooltip when a user hovers over the Primitive. It can supplemental information to construct an image map of the non-data elements of a chart.
The intent behind any data objects referenced by this property are dependent upon the
The default color is Black.
Primitives may become invalidated if the
Box is a rectangularly-shaped, 2-dimensional Primitive that is used to render bars, columns, and other rectangular adornments (tooltips, etc.)
Highlights the current Box by overlaying another Box of identical size, shape and location. The coloration parameters supplied to this method by the charting infrastructure correspond to the appropriate highlighting style established by the developer in the chart's appearance.
The fillColor specified may include an alpha (or transparent) component, allowing the original Box (and any adornments it may have, such as chart text) to be partially visible through the highlighting. When the fillColor is opaque, highlighting hides any adornments on the original graphical element.
Note: this is not the same as the Callout Annotation class.
The
Primitives may become invalidated if the ChartType of the control has changed.
Always call the
This Flag must be set to True if the Primitive is to participate in receiving mouse movement and click events.
Since events travel from the foreground of the scene into the background, the first Primitive signaled by hit detection as the recipient of an event is the only one to receive it. Primitives that were covered may not be notified of the event, even if their HitMe Flag was set to True.
To compare Primitives by their Value property, use the PrimitiveComparer class.
Whether or not this field is null determines much about a Text primitive, like how wrapping or clipping or rotation occurs.
In the absence of a bounding rectangle (if this field is empty), a center point will be used for placement of this Text primitive, and things like clipping and wrapping are not possible.
This
Wedge objects are the representation of 2-dimensional pie slices (RadiusInner equals 0) or doughnut sections (RadiusInner greater than 0) in pie and doughnut charts.
Developers should not modify this value when it has been calculated by the charting engine.
The arc is drawn from startingAngle to (startingAngle + sweepAngle). The startingAngle is measured clockwise from a 3 o'clock position.
To create a doughnut sector instead of a pie slice, set the
The arc is drawn from startingAngle to (startingAngle + sweepAngle). The startingAngle is measured clockwise from a 3 o'clock position.
To create a doughnut sector instead of a pie slice, set the
The rectangle returned has pie-relative coordinates. A control-relative rectangle will require translation.
For a pie slice the InnerRadius should always be 0, while for a doughnut sector it should be greater than 0 but less than
M = M*R
Unlike the GetStringSizePixels method, this method accounts for the Orientation property of the given LabelStyle object, which affects how high or wide a label will be.
For example, a string+font measured at 50x100 pixels (HxW), but oriented vertically, would yield a SizeF of 100x50 using this method.
Unlike the GetStringSizePixels method, this method accounts for the Orientation property of the given LabelStyle object, which affects how high or wide a label will be.
For example, a string+font measured at 50x100 pixels (HxW), but oriented vertically, would yield a SizeF of 100x50 using this method.
Unlike the GetStringSizePixels method, this method accounts for the Orientation property of the given LabelStyle object, which affects how high or wide a label will be.
For example, a string+font measured at 50x100 pixels (HxW), but oriented vertically, would yield a SizeF of 100x50 using this method.
A base class for adapters that provide alternative data sources used
by UltraChart. Provides a partial implementation of the most common functionality
defined by the
Please see the
An adapter can be automatically generated for an XML document represented in a string filename provided as the data argument. The following must be true:
This method can also furnish an adapter when data is a System.IO.StreamReader containing comma-separated values (CSV).
This is the preferred means for clients to access the
The calculateMinMax method is called by subclasses when
It additionally adjusts
Following a call to calculateMinMax, staleMinMax will be false.
This method re-calculates the maximum value(s) if necessary.
This method re-calculates the minimum value(s) if necessary.
This method re-calculates the maximum value(s) if necessary. There is no facility for providing which row in the data source contains the maximum value.
This method re-calculates the minimum value(s) if necessary. There is no facility for providing which row in the data source contains the minimum value.
This method re-calculates the maximum value(s) if necessary. There is no facility for providing which column in the data source contains the maximum value.
This method re-calculates the minimum value(s) if necessary. There is no facility for providing which column in the data source contains the minimum value.
Please see
It is the responsibility of the caller to know what the Type of the data for this column is within the data source.
When possible, the first non-charted column contain string labels should be used by default.
When possible, the name of the DataColumn should be used by default.
When binding to an XML document that doesn't furnish a strongly-typed schema, all data values are assumed to be xsd:string. Therefore this function may return false in those instances, even if text data values present could be parsed into numeric data.
Developers should call this method in conjunction with
If the value of column is outside of the range of included columns, then this method has no effect.
Developers should use this method in conjunction with
Subclasses are encouraged to override this method, adding text data for any additional state they define, appended after calling this base class implementation.
This value is undefined prior to calling calculateMinMax.
This value is undefined prior to calling calculateMinMax.
This value is undefined prior to calling calculateMinMax, since it is calculated while calculating
This value is undefined prior to calling calculateMinMax, since it is calculated while calculating
This value is undefined prior to calling calculateMinMax, since it is calculated while calculating
This value is undefined prior to calling calculateMinMax, since it is calculated while calculating
If
Note: this method uses nested loops and should be used sparingly. Repeated access to this method is costly in terms of performance.
Note: this method uses nested loops and should be sued sparingly. Repeated access to this method is costly in terms of performance.
The recommended pattern for derived classes is to create a Clone() method which returns a strongly-Typed DataPoint object, and have the OnClone() method return the value from the Clone() implementation.
This property is used to support the internal charting infrastructure and is not intended to be set from application code.
Derived classes can use this method to add a point to the collection. This method will be responsible for calling OnListChanged.
Derived classes should call this method after an item has been added or removed from the collection.
Derived classes should override this method if it is necessary to take any action after the collection is modified.
Derived classes should call this method after an item has been added or removed from the collection.
Derived classes should override this method if it is necessary to take any action after the collection is modified.
When overriding this method, derived classes should create a new DataPoint, add it to the Points collection, and return a reference to it.
This value should be unique for any SeriesCollection which this Series might be a member. The best practice is to make this value unique for all Series in an application.
Classes which derive from SeriesBase should return the appropriate DataPointCollection or IProvideDataPoints object used as their Points collection.
This key should be unique to the SeriesCollection in which this Series is placed.
This method exists so that IDataPoint objects can be returned by calling this method on the base class. To get a collection of GanttItems, simply use the Items collection.
Note: this method contains nested loops and should be used sparingly. Repeated access to this method is costly in terms of performance.
Note: this property accessor contains nested loops and should be used sparingly. Repeated access to this property is costly in terms of performance.
Note: this property accessor contains nested loops and should be used sparingly. Repeated access to this property is costly in terms of performance.
The X and Y values contained by an XYDataPoint may be cartesian or polar coordinates.
If no matching ISeries object is found, null will be returned.
IFGGraphics2D supports the UltraChart rendering engine. It is not advisable for developers to directly call these methods from an application.
This class cannot be inherited from.
Note: this function will return a positive or negative number, depending on the orientation of the polygon. It will return 0.0 if the polygon has neither width nor height.
IFGGraphicsPDF supports the UltraChart rendering engine. It is not advisable for developers to directly call these methods from an application.
This class cannot be inherited from.
Note: this function will return a positive or negative number, depending on the orientation of the polygon. It will return 0.0 if the polygon has neither width nor height.
The collection of annotations for this chart.
This base class defines the members for notification of parent Appearance objects about any changes in descendant Appearance objects.
AppearanceHelper should not be treated as a subclass of ChartAppearance because these types serve different purposes. AppearanceHelper does not know how to set properties in the associated chart layers. The Appearance objects derived from ChartAppearance contain this logic.
Developers should not find it necessary to use this class in their own applications.
Specifies a public property on an Appearance object. Indexed or parameterized properties are not supported.
Constructs a default AppearanceHelper object with empty parentAppearance and appearanceProperty. This object won't be able to do anything until the developer calls
Constructs an AppearanceHelper object with pre-initialized parentAppearance and appearanceProperty fields.
This initializes the AppearanceHelper's
Override this method to call the parent Property Set method with a new property class.
This constructor is used when the IChartComponent is known a priori.
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned.
Inheritors should override this member to fill in a reasonable text value in the design time Properties Window.
Returns True if the LineThickness property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the LineStartCapStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the LineStartCapStyle property to its default value.
Once this method is invoked, the
Returns True if the LineEndCapStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the LineEndCapStyle property to its default value.
Once this method is invoked, the
Returns True if the DrawStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the
Once this method is invoked, the
This method indicates whether the value of the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
This method returns a boolean value that indicates whether the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
This method returns a boolean value that indicates whether the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
This property determines how thick the lines are drawn.
This property determines the start cap style of each plotted line in the chart.
The
This property determines the end cap style of each plotted line in the chart.
The
This property determines the drawing style of each plotted line in the chart.
The
This property specifies whether to show the data points between line segements.
This property specifies whether null data encountered in the bound data source should be treated as having a zero value, or an average value of the adjacent data points.
See the
This property exposes an enumerable collection of
Returns True if the RangeType property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the RangeType property to its default value.
Once this method is invoked, the
Returns True if the RangeMin property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the RangeMin property to its default value.
Once this method is invoked, the
Returns True if the RangeMax property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the RangeMax property to its default value.
Once this method is invoked, the
Returns True if the LogBase property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the NumericAxisType property to its default value.
Once this method is invoked, the
Returns True if the LogBase property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Visible property to its default value.
Once this method is invoked, the
Returns True if the Visible property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Visible property to its default value.
Once this method is invoked, the
Returns True if the LineThickness property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the LineThickness property to its default value.
Once this method is invoked, the
Returns True if the LineEndCapStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the LineEndCapStyle property to its default value.
Once this method is invoked, the
Returns True if the LineDrawStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the LineDrawStyle property to its default value.
Once this method is invoked, the
Returns True if the TickStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the TickmarkStyle property to its default value.
Once this method is invoked, the
Returns True if the TickmarkPercentage property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the TickmarkPercentage property to its default value.
Once this method is invoked, the
Returns True if the TickmarkInterval property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the TickmarkInterval property to its default value.
Once this method is invoked, the
Returns True if the Extent property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Extent property to its default value.
Once this method is invoked, the
Returns True if the LineColor property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the LineColor property to its default value.
Once this method is invoked, the
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned.
This is an enumerated property that determines how the upper and lower bound of this Axis is calculated. See
For backward compatibility, this property defaults to AxisRangeType.Automatic.
For continuous axes this property allows a developer to specify the lower limit of this Axis' range. If the axis is discrete (dates, series-grouping, etc) then this allows the developer to specify the minimum row (or column, depending on chart type) index to plot.
The value for the lower limit of the axis must be a positive number when the
This property is ignored when
For continuous axes this property allows a developer to specify the upper limit of this Axis' range. If the axis is discrete (dates, series-grouping, etc) then this allows the developer to specify a maximum row (or column, depending on chart type) index to plot.
The value for the upper limit of the axis must be a positive number when the
This property is ignored when
This property determines how thick the axis line is drawn.
This property determines the end cap style of the axis line.
This property determines the drawing style of the axis line.
The
The
The StripLines property specifies the appearance of an axis' minor grid lines.
The
Extent may have a value between 0 and 500. It is not strictly a margin, since labels are rendered in area created by an Extent. Setting the Extent to too small a value will result in labels for that axis appearing clipped.
Extent is ignored for the axes of 3D charts, it applies to 2D charts only.
This property specifies the color with which to draw the axis line.
The axis label appearance characteristics are initialized to the default X-Axis label style.
Returns True if the Visible property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Visible property to its default value.
Once this method is invoked, the
Returns True if the Font property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Font property to its default value.
Once this method is invoked, the
Returns True if the FontColor property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the FontColor property to its default value.
Once this method is invoked, the
Returns True if the WrapText property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the WrapText property to its default value.
Once this method is invoked, the
Returns True if the HorizontalAlign property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the HorizontalAlign property to its default value.
Once this method is invoked, the
Returns True if the VerticalAlign property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the VerticalAlign property to its default value.
Once this method is invoked, the
Returns True if the ClipText property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ClipText property to its default value.
Once this method is invoked, the
Returns True if the Orientation property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Orientation property to its default value.
Once this method is invoked, the
Returns True if the FontSizeBestFit property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the FontSizeBestFit property to its default value.
Once this method is invoked, the
True to indicate label text flipped; otherwise, False.
Set properties under LabelStyle for an individual axis to control things like font, orientation, and visibility of the axis labels.
True to indicate label text is shown; otherwise, False.
The
The
The
True to indicate that label text that does not fit will be wrapped onto multiple lines; otherwise, False.
The
The
The
True to indicate that label text that does not fit is clipped; otherwise, False.
The
This property controls the direction of label text (horizontal or vertical, and if vertical, the facing of the text).
An orientation can only be applied to labels on 2-D chart types.
If this property is set to True, the font size of label text is calculated to best fit the alloted space; otherwise, the size specified by the
The
Returns True if the ItemFormat property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ItemFormat property to its default value.
Once this method is invoked, the
Returns True if the ItemFormatString property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ItemFormatString property to its default value.
Once this method is invoked, the
Returns True if the SeriesFormat property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the SeriesFormat property to its default value.
Once this method is invoked, the
Returns True if the SeriesFormatString property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the SeriesFormatString property to its default value.
Once this method is invoked, the
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned.
Returns True if the Orientation property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Orientation property to its default value.
Once this method is invoked, the
The
The
This property specifies a custom format for item labels. The
The
This property is ignored for 3D charts.
The
This property specifies a custom format for series labels.
The
Please see the "String Formats" topic of the UltraChart> help for the appropriate values of this property.
This property is ignored on 3D charts.
If this property is set to False, the Behavior will be applied regardless of whether or not collisions are detected.
This layout behavior is always considered succesful.
This layout behavior is considered succesful if all label text can be displayed within the range of MinimumSize to MaximumSize without any labels overlapping.
A value of -1 will ensure that this Behavior never scales a font to a smaller size.
A value of -1 will ensure that this Behavior never scales a font to a larger size.
This layout behavior is considered succesful if all label text can be displayed at the given rotation without any labels overlapping.
This layout behavior is considered succesful if all label text can be displayed staggered without any labels overlapping.
This layout behavior is considered succesful if all label text can be displayed without any labels overlapping.
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Invoke this method to reset the AxisMargin object to its default value.
Once this method is invoked, the
Please refer
Please refer
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Invoke this method to reset the AxisMargin object to its default value.
Once this method is invoked, the
Please refer
The size specified by this property is measured in units based on the setting of the
Please refer
Returns True if the Orientation property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Orientation property to its default value.
Once this method is invoked, the
Returns True if the BarSpacing property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the BarSpacing property to its default value.
Once this method is invoked, the
Returns True if the NullHandling property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the NullHandling property to its default value.
Once this method is invoked, the
This property is present for inheritance by the
BarSpacing determines how much space is placed between bars. The value is specified in whole bar width increments. The space will always by a multiple of the width of a bar.
This property specifies whether null data has to be handled as Zero or Average value
Returns True if the SeriesSpacing property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the SeriesSpacing property to its default value.
Once this method is invoked, the
Returns True if the NullHandling property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the NullHandling property to its default value.
Once this method is invoked, the
This property specifies whether null data has to be handled as Zero or Average value
The ChartText collection exposed by this property accepts
Returns True if the Color property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Color property to its default value.
Once this method is invoked, the
Returns True if the Thickness property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Thickness property to its default value.
Once this method is invoked, the
Returns True if the CornerRadius property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the CornerRadius property to its default value.
Once this method is invoked, the
Returns True if the Raised property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Raised property to its default value.
Once this method is invoked, the
Returns True if the DrawStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the DrawStyle property to its default value.
Once this method is invoked, the
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned.
Needed for ICloneable implementation. If desired, use the strongly-typed BorderApperance.Clone() method instead of this one.
This property specifies the color with which to draw the chart border.
This property determines how thick the chart border is drawn.
This property determines how round the chart border is drawn.
This property determines the drawing style of the chart border.
The
This property determines the drawing style of the chart border.
The
This property value is expressed as a fraction of the total space allocated for each box. Sensible values are between 0 and 1.
Returns True if the ColorCueColumn property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ColorCueColumn property to its default value.
Once this method is invoked, the
Returns True if the ColumnX property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ColumnX property to its default value.
Once this method is invoked, the
Returns True if the ColumnY property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ColumnY property to its default value.
Once this method is invoked, the
Returns True if the ColumnZ property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ColumnZ property to its default value.
Once this method is invoked, the
Returns True if the BubbleShape property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the BubbleShape property to its default value.
Once this method is invoked, the
Returns True if the NullHandling property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the NullHandling property to its default value.
Once this method is invoked, the
Invoke the
Invoke this method to reset the
Once this method has been invoked, the
Invoke the
Invoke this method to reset the
Once this method has been invoked, the
This property is zero based, meaning that the absolute index of the first column is 0.
The
This property is zero based, meaning that the absolute index of the first column is 0.
The
The
This property is zero based, meaning that the absolute index of the first column is 0.
The
The
This property is zero based, meaning that the absolute index of the first column is 0.
The
This property specifies whether null data has to be handled as Zero or Average value
This property provides developers an automatic option for controlling the foreground or background placement of bubbles within the scene graph rendered for Bubble Chart.
When large-radius bubbles tend to cover smaller-radius bubbles, then setting this property to Descending should alleviate that problem.
For backwards compatibility, the default value of this property is None. Developers can exercise control over the placement of bubbles within the chart by externally sorting it on any arbitrary criteria (including radius) such that data points that are desired in the foreground occur last in the data set.
This property exposes an enumerable collection of
Developers may have noticed that since each bubble on the Bubble Chart corresponds to exactly one row (with three columns making up the bubble's X, Y and radius), it is not necessary to specify a
Returns True if the PositiveRangeColor property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the PositiveRangeColor property to its default value.
Once this method is invoked, the
Returns True if the NegativeRangeColor property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the RangeColor property to its default value.
Once this method is invoked, the
Returns True if the WickColor property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the WickColor property to its default value.
Once this method is invoked, the
Returns True if the VolumeColor property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the VolumeColor property to its default value.
Once this method is invoked, the
Returns True if the WickThickness property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the WickThickness property to its default value.
Once this method is invoked, the
Returns True if the VolumeVisible property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the VolumeVisible property to its default value.
Once this method is invoked, the
Returns True if the HighLowVisible property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the HighLowVisible property to its default value.
Once this method is invoked, the
Returns True if the OpenCloseVisible property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the OpenCloseVisible property to its default value.
Once this method is invoked, the
Returns True if the SkipN property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the SkipN property to its default value.
Once this method is invoked, the
This property specifies the color with which to draw positive-range candles.
The
This property specifies the color with which to draw negative-range candles.
The
This property specifies the color of wicks in a Candle chart.
The
This property specifies the color with which to draw volumes in a Candle chart.
The
This property specifies how thick the wicks of the candles in a Candle Cart are drawn.
The
This property specifies whether or not to display volumes.
The
True if the high and low wicks are displayed; otherwise, False.
The
True if the open and close wicks are displayed; otherwise, False.
The number of days to skip between each label on the X axis. 0 means every day is labeled.
There are ChartAppearance subclasses corresponding to the ChartAppearanceType listed in this enumeration. Some ChartAppearanceTypes (for example, AxisX2 and AxisY2) may share the same ChartAppearance subclass.
This method is used to initialize the
This class contains the shared
In general, only hybrid charts make use of the
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned.
This method returns True when the background plane color property is not set to its default value and needs to be serialized; otherwise, it returns False.
Invoke this method to reset the BackColor property to its default value.
Once this method is invoked, the
In charts with both X and Y axes, the square area adjacent to where these axes meet is known as the "chart grid." In both composite and non-composite charts, a PaintElement object is provided to customize the appearance of this area. For non-composite charts, use the Axis.PE property. For composite charts, use the chartArea.GridPE property.
This property is ignored by charts that do not support an X-axis.
The
This property is ignored by charts that do not support a Y-axis.
The
This property is ignored by charts that do not support a second Y-axis (in general, non-hybrid charts).
The
This property is ignored by charts that do not support a second X-axis (it applies to hybrid charts only, in general).
The
This property is ignored by charts that do not support an Z-axis (2-D charts ignore this axis.)
The
This property is ignored by charts that do not support an Z2-axis (2-D charts ignore this axis.)
The
This property will be changed and reset each time the ChartType property is changed. The Type of this property value is dependent on the current ChartType.
This property is intended to support the charting infrastructure and ensure proper serialization of charts created using the collection editors, designers, and the chart wizard. Setting this property in code is not recommended.
This property is intended to support the charting infrastructure and ensure proper serialization of charts created using the collection editors, designers, and the chart wizard. Setting this property in code is not recommended.
This property is intended to support the charting infrastructure and ensure proper serialization of charts created using the collection editors, designers, and the chart wizard. Setting this property in code is not recommended.
This property is intended to support the charting infrastructure and ensure proper serialization of charts created using the collection editors, designers, and the chart wizard. Setting this property in code is not recommended.
This property is intended to support the charting infrastructure and ensure proper serialization of charts created using the collection editors, designers, and the chart wizard. Setting this property in code is not recommended.
When this property is set to true, the Series collection will be flipped "sideways." DataPoints at the same index in consecutive series will be treated as if they were in the same series.
These objects often appear collectively within the ChartText property of the
Use this constructor when instantiating chart text objects without values. Developers must set at least the following properties before this chart text appears on the chart:
See the
Use this constructor to initialize all chart text properties at once when the property values are known at the time the constructor is to be called.
The hash value calculated should be unique for ChartTextAppearance object(s) applying to a specific chart element.
If the ChartTextAppearance is assigned Item WildCards (ItemWildCard.Row or ItemWildCard.Column), then it will always match given data points at the wildcarded row or column (or both, if applicable).
This method implements to IComparable interface for
This method returns True when the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
This method returns True when the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
This method returns True when the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
This method returns Ture if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Use this method to determine whether the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the HorizontalAlign property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the HorizontalAlign property to its default value.
Once this method is invoked, the
Returns True if the VerticalAlign property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the VerticalAlign property to its default value.
Once this method is invoked, the
This method returns True when the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Each (row, column) tuple in the chart's data corresponds to a graphical chart element. Developers can specify the graphical chart element on which this ChartText appears by assigning a value to this property and
To match every row of data, set this property to -2. To match no rows of data, set this property to -1.
Each (row, column) tuple in the chart's data corresponds to a graphical chart element. Developers can specify the graphical chart element on which this ChartText appears by assigning a value to
To match every column of data, set this property to -2. To match no columns of data, set this property to -1.
Ensure this property has been set to True or this chart text label will not be displayed. Other reasons why chart text labels may not appear on a chart include:
Multiple ChartTextAppearance objects can apply to the same graphical chart element (identified by the same ( row, column)) and be alternated by toggling their Visible properties such that only one piece of chart text is displayed at once.
The
By default, a 10pt Arial font is used.
The
The
Please consult the documentation topics on Labeling Concepts and String Formats for more information on applicable keywords.
The HorizontalAlign property specifies specifies horizontal alignment of label text. See also the
Two or more
The VerticalAlign property specifies vertical alignment of label text. See also the
Two
This property retrieves the position from the radius of a chart text label. It can have a value of between 0 to 100, inclusive, and is initialized to 50 by default. This property only applies to chart text on pie-style chart types.
This class exposes methods that identify whether it is capable of helping to convert a
Please consult the documentation for the ExpandableObjectConverter class for more details on the usage of this helper class.
Developers should call this method prior to calling
This method converts objects of
Since types in .NET vary on culture, two types having the same name with different cultures are distinct types. Make sure that when converting types the culture argument to this method matches the culture of the Infragistics assemblies installed on the machine.
Additionally, the method requires that the chartText parameter be of type ChartTextAppearance. The destinationType must be of type InstanceDescriptor. If either of these criteria are not met, then this method falls back on the base class implementation, if any.
Please consult the documentation for the InstanceDescriptor for more details on the usage of this helper class.
This class is exposed as the ChartText property on the UltraChart control. It contains the
This means of construction is frequently called by the other chart type related appearances (AreaAppearance, ColumnAppearance, etc.)
This method throws an ArgumentNullException for several other methods in this class, so the resource lookup is performed from one central location instead of being spread out all over the place.
This method returns the index of a matching
IndexOf always returns -1 when
The
This method retrieves an IEnumerator that can be used for forward iteration through
This is a weakly-typed variation of
This is a weakly-typed variation of
This is a weakly-typed variation of
Developers can use this method to retrieve individual
Should the index supplied be outside the bounds contained inside the ChartTextCollection, then null is returned.
The
Returns True if the ColorModel property is not set to its default value; otherwise, it returns False.
Returns True if the Scaling property is not set to its default value; otherwise, it returns False.
Returns True if the ColorBegin property is not set to its default value; otherwise, it returns False.
Returns True if the ColorEnd property is not set to its default value; otherwise, it returns False.
Returns True if the Grayscale property is not set to its default value; otherwise, it returns False.
Returns True if the AlphaLevel property is not set to its default value; otherwise, it returns False.
Returns True if the CustomPalette property is not set to its default value; otherwise, it returns False.
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned.
ModelStyle determines how chart elements are colored (i.e. Linear or Random, Custom or Range). See
Scaling can be used to lighten or darken the colors that are used to render each series of data.
This property only applies when
This property only applies when
When True, the chart elements will be drawn in Grayscale. When False, the chart elements will be drawn in color.
AlphaLevel ranges from 0 (transparent) to 255 (opaque).
Note: This property can only be set at run-time.
Returns True if the ColumnSpacing property is not set to its default value; otherwise, it returns False.
Returns True if the NullHandling property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the NullHandling property to its default value.
Once this method is invoked, the
This property is present for inheritance by the
ColumnSpacing determines how much space is placed between columns. The value is specified in whole column width increments. The space will always by a multiple of the width of a column of data.
This property specifies whether null data has to be handled as Zero or Average value
This method returns a boolean value that indicates whether the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the SeriesSpacing property is not set to its default value; otherwise, it returns False.
This property specifies whether null data encountered in the bound data source should be treated as having a zero value, or an average value of the adjacent data points.
See the
This property determines how much space is placed between series. The value is specified in Column Width increments, so the space will always by a multiple of the width of a column of data.
The ChartText collection exposed by this property accepts
Column Charts normally render one row of data as a series, and each column of data as a column within the series. As an example, the
As with any hybrid chart appearance, instances of the ColumnLineAppearance class are dual-binding. This class exposes an Appearance and DataAppearance property of both the Column Chart (tied to the X- and Y- axes) and the Line Chart (tied to the secondary X2- and Y2- axes).
Returns True if the Line property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Line property to its default value.
Once this method is invoked, the
Returns True if the Column property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Column property to its default value.
Once this method is invoked, the
Returns True if the ColumnData property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ColumnData property to its default value.
Once this method is invoked, the
Returns True if the LineData property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Data property to its default value.
Once this method is invoked, the
If this property is set to Rectangle.Empty, then the entire chart surface will be used for the legend bounds.
Setting the BoundsMeasureType property will determine the unit of measurement to use for this rectangle.
This property is intended to support the charting infrastructure and ensure proper serialization of charts created using the collection editors, designers, and the chart wizard. Setting this property in code is not recommended.
Please see Labelling and Label Formats under the Key Features Overview for detailed information about Label formats.
The DataAppearance class manages the appearance of the data in the chart, including it's filtering (even if the application doesn't already take advantage of the filtering capabilities of the DataView class).
The primary purpose of this Appearance object that all developers need to be comfortable with is using the
Additional filter support in DataAppearance includes whether the chart should be Zero-aligned to a linear, numeric axis (see the
This creates a DataAppearance object with its default properties. This method is called by the UltraChart infrastructure, and it should not be necessary to call this constructor from application code.
This creates a DataAppearance object with its default properties and tied to a given IChartComponent reference. This method is called by the UltraChart infrastructure, and it should not be necessary to call this constructor from application code.
Following construction of the DataAppearance using this constructor, someone must call InitializeAppearance() at a point after the data is ready in order for the column list to be properly propagated.
This method is used to set the state of the "Has
Be sure to pass in an array of strings with a count equal to the number of rows of data.
Also set the UseRowLabelsColumn property to False to force the use of this array.
To get a reference to the array once it has been initialized, use the
Initialize this array by calling the
Be sure to pass in an array of strings with a count equal to the number of column of data.
If this is array is not null, the values will be use as labels for the Columns in the chart. If it is null, the chart will use the Column names from the DataSource as Column Labels.
To get the array, use
To set the array, use
An invalid column is ignored.
If the number of valid columns to chart that are left is too few for the chart type, an invalid data message will appear.
An invalid column is ignored.
If the number of valid columns to chart that are left is too few for the chart type, an invalid data message will appear.
Invalid column numbers are ignored.
If the number of valid columns to chart that are left is too few for the chart type, an invalid data message will appear.
When this method is called, DataAppearance properties are reset to the defaults. This includes clearing the RowLabels and ColumnLabels collections, resetting the SwapRowsAndColumns property, and re-including any columns which were exluded using the IncludeColumn method.
When first binding the chart control to a data source, it is necessary to assign a data source to the
Normally, the chart will automatically update it's display when it recieves a notification from the
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned.
The control supports a variety of data source types.
The most robust and extensible data source is the DataTable, which provides update notifications via the IBindingList interface. Use of these built-in ADO.NET data management types offers the greatest flexibility.
Many charts also support data-binding to ICollections (including simple arrays) provided the a single-typed, one-dimensional array can meet the chart type's Data Requirements. Chartable data sources include custom ICollections, and custom data objects that additionally support IBindingList may take advantage of live data-binding to the chart component.
Another data source that may be provided is the local filename of an XML or comma-delimited text file.
XML documents require an internal XML Schema document, and must be readily mappable to the Framework's DataSet (their msdata:IsDataSet attribute is set to true). The schema is also necessary since each XML element must be strongly-typed (otherwise their data type will be inferred as xsd:string and this will not translate readily into a DataSet, even though the data content of the element may be numeric.) Please see Generating DataSet Relational Structure from XML Schema in the .NET Framework documentation for more on the issues involved, and consult the samples included with this product for working schema.
Data may be unbound from a chart by calling the
Developers must set this property to true, and provide the zero-based index of the column containing series or row labels to the
Charts may extract the first string column present in a data set for use as row labels, if none are explicitly provided.
The column index specified by this property must be zero-based (ie, a column index of 2 corresponds to the third column in the data). The column's data type must be string, or it must be readily convertible to string. Values outside of the range of columns (below 0 or greater than the number of columns) will be ignored.
This mechanism for custom-supplying series or row labels from the data can be toggled on or off, see the
This property supports turning off the display of chart elements whose values exceed the specified Maximum data value. Chart elements falling within the range defined by this property, in concert with
This property supports turning off the display of chart elements whose values are below the specified Minimum data value. Chart elements falling within the range defined by this property, in concert with
This property is a flag that enabled the in-place filtering of chart elements shown. Please see the documentation for the
When this property is set (it is not set by default), the rows and columns in the DataSource will be transposed to render in the opposite way from which they are typically shown. Rows (series) become columns (items) and columns (items) will become rows (series).
This method can be used to alter a data source that doesn't initially conform to a chart's Data Requirements to become chartable. It can also invalidate a data source that previously met the requirements for a chart type, because the data will no longer do so (in its transposed state).
When zero alignment is in effect, the chart will be rendered with its primary, linear, numeric axis range starting at zero, as opposed to the minimum data value present in the DataSource.
This property does not apply to non-numeric (for instance, axes based on dates or discrete item labels) or non-continuous axes (for instance, logarithmic axes for which log 0 is mathematically undefined).
Developers can use this feature when they want their minimum data values to display and showing the axis at the origin is relevant. When there is little variation between data values (i.e., the difference between the maximum and minimum values being charted is small compared to the minimum value's difference from the zero-axis), it is a better choice to adjust the RangeAxisType to Custom on the
This Appearance extends upon the properties in
The hole in the middle of the Doughnut Chart is specified by the
Any sector whose percentage exceeds this value will be rendered as a full independent band. All sectors whose percentage is less than this value will be combined and displayed as one "Others" sector.
All items fitting into the Others Category will be associated with the label generated by this property setting.
The data column is identified by the zero-based index at which it appears in the data source.
Returns True if the Labels property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the ColumnIndex property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the StartAngle property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the BreakDistancePercentage property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the BreakAllSlices property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the BreakAlternatingSlices property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the BreakOthersSlice property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the OthersCategoryText property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the OthersCategoryPercent property is not set to its default value; otherwise, it returns False.
Invoke the
Developers should use either this method, or one of the breaking flags (see
The slice number can be thought of in correspondence to a data column representing the slice. Whereas additional data columns may appear before the column represented by the first slice, a slice number will always be zero-aligned. For example, if column indices 3, 4 and 5 are rendered in the pie chart, these columns correspond to slice numbers 0, 1, and 2, respectively.
This property returns an IList of only those slices which were explicitly broken individually using the
It does not include slices that were broken as a result of another property such as
This method affects only slices which were explicitly broken individually using the
It does not affect slices that were broken as a result of another property such as
Returns True if the PieThickness property is not set to its default value; otherwise, it returns False.
Invoke the
If any property of this Appearance object has a non-default value, then this Appearance object must be serialized in order to reconstitute itself at a future time.
This property is expressed as a fraction of the total space allocated for a pie. Valid values for this property are between 0 and 1.
This child appearance manages various aspects of the text labels appearing alongside the Pie Chart, such as their style, formatting, leader lines appearance, et al.
To add text within the slices of a Pie Chart, developers can add
This property determines which column in the Data Source is displayed in the Pie Chart as data. Column indices are zero-based.
If the specified column is non-numeric, the Chart will check each column after it, in order, until it finds a numeric column.
If the Pie Chart is scaled too large, leader lines and labels may be clipped at the edges of the control. Developers can avoid this by reducing the RadiusFactor, or through setting
The default value for RadiusFactor is 90. Values smaller than 90 reduce the amount of the chart area the Pie Chart consumes, values greater than 90 increase the area consumed by the Pie Chart.
The first pie slice (based on the first row of data) will be rendered at the given angle. Successive slices are then rendered clockwise from the first slice starting at the 3 o' clock orientation.
This value is specified as a percentage of the Pie Radius, so it ranges from 0 to 100.
This property will have no effect unless another breaking property such as
The size of the break is specified by the
The effect of setting this property and any of the other breaking flags (
The size of the break is specified by the
The effect of setting this property and any of the other breaking flags (
The size of the break is specified by the
The effect of setting this property and any of the other breaking flags (
Any slice whose percentage exceeds this value will be rendered as a full independent slice. All slices whose percentage is less than this value will be combined and displayed as one 'Other' slice.
All items fitting into the Others Category will be associated with the label generated by this property setting.
Thickness is only supported for 3-D Pie Chart. It does not apply to 2-D Charts because flat pies have no thickness.
The valid range of values for the thickness of the pie are from 0 to 40.
Chart Text and Pie Labels each have their own uses, and differ in two key respects. Whereas the
Pie Charts normally render one row of data, so the
Returns True if the InnerRadius property is not set to its default value; otherwise, it returns False.
Invoke the
If any property of this Appearance object has a non-default value, then this Appearance object must be serialized in order to reconstitute itself at a future time.
Percentage of the inner hole of the doughnut to it's outer radius. Valid values range from 25% to 75% of the doughnut's radius.
Developers can vary this percentage to achieve visual results that range from a ring chart to a tire chart.
DrillDownAppearance is an extension of ChartAppearance, and provides the properties necessary for developers to define a drill down hierarchy and manage the user's navigation of drillable charts at run-time.
Drill-enabling your chart is as easy as setting the DrillElement property to an array of one or more initialized DrillElement objects, and turning on the Enabled property. See the DrillElement class for more information on how to initialize a DrillElement object to represent a node in the drill down hierarchy.
Additional features exposed by DrillDownAppearance include the ability to show a drill back button on the chart grid, activated by the ShowButtons property.
The DrillDownAppearance property only supports UltraWinChart applications and not UltraWebChart. Due to the
disconnected nature of the Web, persisting information on the entire drill down hierarchy at once is not supported. UltraWebChart
developers should follow the approach of subscribing
This method executes a non operation (nop) which is faster than checking whether or not drill down applies to this chart. When drill down has been enabled (it's Enabled property is set to True), the Enabled property set routine is responsible for swapping the delegate returned by DrillDownHandler to the functional DrillDownEventHandler instead of this one. See the Enabled property for more details.
The existence of this method is only necessary to the WebChart implementation of Drill Down.
This method executes a non operation (nop) which is faster than checking whether or not drill down applies to this chart. When drill down has been enabled (it's Enabled property is set to True), the Enabled property set routine is responsible for swapping the delegate returned by DrillDownHandler to the functional DrillDownEventHandler instead of this one. See the Enabled property for more details.
The existence of this method is only necessary to the WebChart implementation of Drill Down.
This method allows application logic to drill back up the chart, refreshing the chart with the information and presentation of the parent chart. The effects of calling DrillBack() or using the
Developers may call DrillBack() repeatedly in a loop, until the method returns false, to quickly ascend to the topmost chart in the drill down hierarchy from any child chart. When doing so, it is advisable to first set UltraChart's Visible property to false to prevent screen flicker as chart type may change in the process of drilling back to the topmost chart from great depth.
Set the DrillElements property to a non-null, non-empty array to define the drill down hierarchy (the tree-like structure of parent and child charts descendant from one top-level chart). Each DrillElement object in this array should be initialized prior to the user interacting with the Chart, so it's advisable that this property be initialized in Form or Page load events.
The drill down hierarchy contains nodes describing the necessary properties of child charts descendent from one topmost chart (the chart appearing when UltraChart is first databound and displayed before any drill down has occured).
The consequences of changing DrillElement objects in this collection once the user has interacted with the drill down hierarchy are undefined. If you must make changes to the structure of the drill down hierarchy, return the user to the topmost chart.
Enables drill down functionality in UltraChart. Before drill down can be fully realized, the DrillElement property must be initialized with an array of DrillElements that describe the drill down hierarchy.
For all WebCharts and WinCharts with custom Drill Down (IDrillDown) implemented, this property will have no effect. To disable Drill Down in a custom IDrillDown implementation, avoid calling your custom Drill method in the ChartDataClicked event handler.
This property affects WinChart and not WebChart. The drill back button is not available in WebChart.
When active, a drill back button is automatically displayed at the top-left corner of the chart grid (it may appear outside of Pie and Doughnut charts since they have no upper-right corner). It appears behind graphed objects when those objects are highlighted. It isn't possible to relocate this button, and it is not shown by default.
As an alternative to using ShowButton, developers can provide their own Button or user interface experience to control drill back. The UltraChart class exposes a DrillBack() method that can be called by application logic (such as in an ClickEvent handler).
Whether the user navigates up the drill down hierarchy using the provided button or an application generated DrillBack() call, the effect of returning to the parent chart is the same. Since this button does not appear, it is incumbent upon developers to either turn on ShowButton or provide their own DrillBack() call to enable users to revisit parent charts.
This property returns the depth (or "drilled level") in the drill down hierarchy of the currently displayed child chart. Each time a user drills down, depth (their distance from the topmost chart) increases by one level. Calling the
Depth is read-only. It cannot be directly modified to skip several levels in the drill down hierarchy. It is possible to have multiple
For performance reasons, pixelwise effects are disabled by default. Set this property to True to enable Effects which are designed to be applied pixelwise to the chart image.
Any band whose percentage exceeds this value will be rendered as a full independent band. All bands whose percentage is less than this value will be combined and displayed as one 'Other' band.
All items fitting into the Others Category will be associated with the label generated by this property setting.
For detailed information on the possible FormatString, pelase refer to the documentation on Labelling and Label Formats.
Set this property to Color.Empty to use the color of each band as the color for leader lines.
This property determines how the leader lines are terminated (for example, with an arrowhead). The end of the leader lines is that end which points outward from the chart.
The leader lines can be drawn in a variety of styles such as Solid, Dot, Dash, et al. See the
The value of any leader line styling property is ignored if
Leader lines are lines that connect from the text label of a band to the band itself. Using leader lines makes it easier for end users to associate which label belongs with each band in the chart.
The border can be drawn in a variety of styles such as Solid, Dot, Dash, et al. Please see the
Any band whose percentage exceeds this value will be rendered as a full independent band. All bands whose percentage is less than this value will be combined and displayed as one 'Other' band.
All items fitting into the Others Category will be associated with the label generated by this property setting.
The ChartText collection exposed by this property accepts
For detailed information on the possible FormatString, pelase refer to the documentation on Labelling and Label Formats.
Set this property to Color.Empty to use the color of each band as the color for leader lines.
If a GanttDataSource is used instead of a DataTable, these settings are not needed and will be ignored.
Gridlines come in two types: major and minor. They appear alternating in two-dimensional chart grids by default, based on the major and minor tickmark intervals. Developers should design the style of minor gridlines to be more subtle than that applied to major gridlines, if minor gridlines are used at all. Each
Gridlines automatically scroll and scale in conjunction with the current scrollbar position, and usually have a fixed correspondence to axis labels, if labels appear. Labels may not always correspond to gridlines if custom keywords are used and some tickmarks are therefore not labeled by a charting application's design.
Gridlines are always rendered perpendicular to their parent axis.
This appearance object only supports the customizability of 2-D Charts' gridlines.
Returns True if the Visible property is not set to its default value; otherwise, it returns False.
Returns True if the DrawStyle property is not set to its default value; otherwise, it returns False.
Returns True if the Color property is not set to its default value; otherwise, it returns False.
Returns True if the Thickness property is not set to its default value; otherwise, it returns False.
Returns True if the AlphaLevel property is not set to its default value; otherwise, it returns False.
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned. This text representation is displayed at design-time in the Property Browser.
When true, the chart will display grid lines.
///Minor Gridlines apply only to 2D Charts. 3D Charts will show Major GridLines, but not Minor GridLines.
Determines how the gridlines will be rendered (e.g. Solid, Dash, Dotted, etc.). If Visible is False, this property is ignored and no Gridlines are dislayed.
Determines the line color of the gridlines. If Visible is set to False, this property is ignored and no GridLines are displayed.
The actual color rendered may change based on the AlphaLevel.
Determines the thickness of the GridLines. If Visible is False, this property is ignored and no Gridlines are dislayed.
AlphaLevel ranges from 0 (transparent) to 255 (opaque).
Heat maps are also sometimes referred to as surface maps.
This method returns a boolean value that indicates whether the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the RenderQuality property is not set to its default value; otherwise, it returns False.
This property specifies whether null data encountered in the bound data source should be treated as having a zero value, or an average value of the adjacent data points.
See the
Higher settings will result in better looking charts but will draw more slowly.
For HeatMap 3D charts, only Medium and Low settings are supported.
The ChartText collection exposed by this property accepts
Chart text applies to 2-D heat maps only.
When set to -1, all columns or series will be used to plot the histogram; otherwise only the ones specified by this property.
The chart legend box appears alongside the chart grid and one of the borders (top, left, bottom or right positioning only). Inside the chart legend there can appear a key that can aide end users in understanding some chart types. Many qualities of the legend are dependent upon ChartType.
Returns True if the Visible property is not not set to its default value; otherwise, it returns False.
Returns True if the Location property is not not set to its default value; otherwise, it returns False.
Returns True if the SpanPercentage property is not not set to its default value; otherwise, it returns False.
Returns True if the Font property is not set to its default value; otherwise, it returns False.
Returns True if the FontColor property is not set to its default value; otherwise, it returns False.
Returns True if the BackgroundColor property is not set to its default value; otherwise, it returns False.
Returns True if the BorderThickness property is not set to its default value; otherwise, it returns False.
Returns True if the BorderColor property is not set to its default value; otherwise, it returns False.
Returns True if the Margins property is not set to its default value; otherwise, it returns False.
Returns True if the DrawStyle property is not set to its default value; otherwise, it returns False.
Returns True if the AlphaLevel property is not set to its default value; otherwise, it returns False.
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned. This text representation is displayed in the Property Browser at design-time.
Returns True if the FormatString property is not set to its default value; otherwise, it returns False.
Returns True if the DataAssociation property is not not set to its default value; otherwise, it returns False.
Setting the Visible flag to True causes the Legend box to be displayed at the
Changing this value at run-time can cause the Chart grid to expand to take up the portion of space within the control that was previous reserved by
The legend may only be located along one of the borders of the chart, see the
Developers can cause a legend to appear in one of the corners of the chart (rather than take up the width or height of the chart control) by selectively adjusting the
This is a percentage value that must be between 0 and 100. The developer is responsible for setting a value appropriate to display a presentable chart. Large values for SpanPercentage tend to make the Legend box appear larger than the chart, and can make the chart unreadable. Very small values for SpanPercentage may make the Legend box unreadable.
The dimension spanned by the Legend box is the width of the chart control area (when
The effect of setting an alpha-component on the BackgroundColor while specifying a separate
The Margins can be specified on each of the four sides of the Legend box. Developers can employ the Margins property in concert with the
If values are given for the Margins that exceed the
AlphaLevel ranges from 0 (completely transparent) to 255 (opaque).
When the AlphaLevel has been set to completely transparent, the Legend box will not be filled unless it is a scale (which renders in the spectral scales own colors), however any icons and text are rendered as if appearing in mid-air.
The effect of specifying an AlphaLevel with this property, and a separate alpha-component on
Please see Labelling and Label Formats under the Key Features Overview for detailed information about Label formats.
If this property is set to an empty string, then the standard "more..." label will be used.
Returns True if the Thickness property is not set to its default value; otherwise, it returns False.
Returns True if the StartStyle property is not set to its default value; otherwise, it returns False.
Returns True if the EndStyle property is not set to its default value; otherwise, it returns False.
Returns True if the DrawStyle property is not set to its default value; otherwise, it returns False.
Returns True if the MidPointAnchors property is not set to its default value; otherwise, it returns False.
Returns True if the HighLightLines property is not set to its default value; otherwise, it returns False.
Returns True if the NullHandling property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the NullHandling property to its default value.
Once this method is invoked, the
If any property of this Appearance object has a non-default value, then this Appearance object must be serialized in order to reconstitute itself at a future time.
Determines the thickness of the lines drawn in the Line Chart.
This property determines what (if anything) is drawn at the beginning of a plotted line. The starting point of a line segment is the Point at which drawing starts (this is commonly from left-to-right, but lines can be drawn from any other direction).
This property determines what (if anything) is drawn at the end point of each plotted line.
Determines how the lines will be rendered (e.g. Solid, Dash, Dotted, etc.)
This flag determines whether midpoint anchors are displayed between each plotted line in the chart. Midpoint anchors may appear as rounded points, small squares, or other visual cues that a data point exists at that point on the line. If the data points form a nearly linear line, end users may have difficulty recognizing data points along the line unless they have been emphasized with a midpoint anchor.
Determines whether or not lines are entirely to be highlighted when any point is highlighted along that line (series) in the chart.
This property does not affect WebChart, since WebChart does not highlight primitives on the client.
This property specifies whether null data has to be handled as if it were a zero data point, or whether it should be treated as if it had the average value of the two most adjacent, non-null data points.
The ChartText collection exposed by this property accepts
Line Charts normally render one row of data to a line, so the
If this property is set to False, the column headers in the data source will be parsed as DateTime objects. Or, if SwapRowsAndColumns is set to True, a column containing DateTime values or values which can be parsed as DateTimes can be used.
The Margins are a child Appearance that exists on other Appearance objects, and that exposes properties permitting developers to specify the amount of space on each side (top, bottom, left and right) of text areas. The Margin is most often used on
It is the responsibility of developers to ensure that property values set on the MarginsAppearance object are presentable, as there are is no layout management afforded by MarginsAppearance to prevent poor choices in property values.
The
The MarginsAppearance is initially created with all margins set to 0 pixels.
Enabling parent Appearance notification requires developers to also call the
Returns True if the Top property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the Left property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the Right property is not set to its default value; otherwise, it returns False.
Returns True if the Bottom property is not set to its default value; otherwise, it returns False.
Invoke the
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned. This text representation is displayed in the Property Browser at design-time.
Determines the amount of whitespace above the top edge of the parent object.
Determines the amount of whitespace besides the left edge of the parent object.
Determines the amount of whitespace beside the right edge of the parent object.
Determines the amount of whitespace above the bottom edge of the parent object.
PaintElement objects are only applicable to objects that support all of the following sophisticated filling techniques:
Appearance objects that don't require PaintElement's broad support will only expose a fill or background color property (and possibly border color and thickness properties) for solid fills only.
This constructor can be used to create a single-color PaintElement object intended for solid fills.
This constructor can be used to create a bi-color PaintElement object intended for solid fills. It can also be used to create Paint Element objects for hatch-filling by assigning a
This constructor can be used to create a default PaintElement object intended for gradient fills.
This constructor can be used to create a default PaintElement object intended for texture fills. The
This constructor can be used to create a default PaintElement object intended for gradient fills.
The characteristics of the GDI+ Pen returned (its color, opacity, thickness) are based on the provided
The pen returned will produce a solid line.
This method is called to supply an appropriate GDI+ Brush object corresponding to the properties of a
When the shape of the area that requires filling is rectangular (or can be closely approximated by a rectangle without loss in a fill's fidelity), use the rect version of this method for better performance.
This method is called to supply an appropriate GDI+ Brush object corresponding to the properties of a
When the shape of the area that requires filling is not rectangular, use the path version of this method that for greater reliability in tiling and scaling resulting textures, gradients and/or hatches. On the other hand, this method should be preferred for all solid fills for better performance. In general solid fills do not depend on the shape of the graphics object.
Needed for ICloneable implementation. If desired, use the strongly-typed PaintElement.Clone() method instead of this one.
A
It is sometimes convenient for developers to pre-initialize several sets of paint properties (a texture, a gradient and a hatch for instance) and then switch between them by adjusting the
This property only applies to texture fills specified with the
Specifies the
Fill is used interchangeably as the solid fill color, the starting color for gradient fills (see also the
This property is intended for use by the UltraChart charting infrastructure, and should not be modified by application code.
This property value is only used when the
A value of 0 represents a transparent brush, whereas a value of 255 represents a completely opaque brush (items behind the filled area are not visible). Values between 0 and 255 represent varying degrees of translucency.
Although it is possible to assign a color with an alpha component to
A value of 0 represents a transparent brush, whereas a value of 255 represents a completely opaque brush (items behind the filled area are not visible). Values between 0 and 255 represent varying degrees of translucency.
Although it is possible to assign a color with an alpha component to
The gradient fill is a linear interpolation of colors starting from the
Use this property (and not
There are several methods to deactivate the pen used for outlining a
While colors with an alpha component may be assigned directly to Stroke, it is highly recommended that developers use the StrokeOpacity property instead.
A value of 0 represents a transparent pen, whereas a value of 255 represents a completely opaque pen. Values between 0 and 255 represent varying degrees of translucency.
This property value overrides any alpha component of the color defined by
This is not the Clone() method typically called by the chart core; it is only to implement ICloneable. This method will directly call the strongly-typed Clone() method of the PaintElementCollection.
This class exposes methods that identify whether it is capable of helping to convert a
Please consult the documentation for the ExpandableObjectConverter class for more details on the usage of this helper class.
Developers should call this method prior to calling
This method converts objects of
Since types in .NET vary on culture, two types having the same name with different cultures are distinct types. Make sure that when converting types the culture argument to this method matches the culture of the Infragistics assemblies installed on the machine.
Additionally, the method requires that the paintItem parameter be of type PaintElement. The destinationType must be of type InstanceDescriptor. If either of these criteria are not met, then this method falls back on the base class implementation, if any.
Please consult the documentation for InstanceDescriptor for more details on the usage of this helper class.
This property value is expressed as a fraction of the total space allocated for each column. Ideal values are between 0 and 1.
This object is used for both PieChart and PieChart 3D. Not all properties, however, apply to both types of charts. In particular, borders and backgrounds are not supported for text labels on 3-D Pie Charts.
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the Format property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the FormatString property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the LeaderLines property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the LeaderLineThickness property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the Font property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the FontColor property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the LeaderEndStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the LeaderDrawStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the BorderColor property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the FillColor property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the BorderThickness property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the BorderDrawStyle property is not set to its default value; otherwise, it returns False.
Invoke the
The string representation of this Appearance class is displayed in the Property Browser at design-time.
The Format can be used to diplay labels in a predefined format (most commonly used for item labeling or data value labeling), or in a custom format (specifying formatting of data values or through custom keywords). When Format is set to Custom, the
For detailed information on the possible format strings, please see the documentation on Labeling and Label Formats.
For detailed information on the possible format string see the documentation on Labeling and Label Formats.
Leader lines are lines that connect from the text label of a slice or sector to the slice or sector itself. Using leader lines makes it easier for end users to associate which label belongs with each slice or sector in the chart.
This property determines the thickness of the leader lines. If
All Pie Chart labels outside of the Pie are drawn using the Font specified by this property. Since .NET Framework fonts are read-only objects, changing one or two style characteristics (e.g., boldness) of the Font object requires creating a reference to a new Font object with those style characteristics.
Developers that need to associate supplemental text within the Pie Chart, potentially with a different font selection, may do so through the addition of
All pie labels will be rendered using this font color.
This property determines how the leader lines are terminated (for example, with an arrowhead). The end of the leader lines is that end which points outward from the pie slice or sector.
The leader lines can be drawn in a variety of styles such as Solid, Dot, Dash, et al. See the
The value of any leader line styling property is ignored if
Label borders are not supported by 3-D Pie Charts.
Developers can cause the Pie Chart labels to appear floating in mid-air by setting this property and
Label background fills are not supported by 3-D Pie Charts.
Label borders are not supported by 3-D Pie Charts.
The border can be drawn in a variety of styles such as Solid, Dot, Dash, et al. Please see the
Returns True if the Icon property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the IconSize property is not set to its default value; otherwise, it returns False.
Invoke the
The Icon property identifies an icon that is plotted by-series of scatter points. The icon can be one of several shapes.
If IconSize is set to Auto then UltraChart automatically chooses a size based on the number of points that are being plotted.
This property does not affect Icons which are set to IconStyle.Character. In that case, use the CharacterFont property to set a font size.
Scatter Charts plot scatter points at given X and Y coordinates that are based upon data tuples from the
A scatter chart is often a suitable substitute for a line chart where two numeric continuous axes are required. Developers should use the
There are a variety of symbols that can be used to plot scatter points, including shapes and Unicode glyphs. These symboles can be grouped by series when developers configure an additional data column in
Developers should use the property
Developers should use the property
This method returns a boolean value that indicates whether the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the ConnectWithLines property is not set to its default value; otherwise, it returns False.
Returns True if the Icon property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the IconSize property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the Character property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the CharacterFont property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the UseGroupByColumn property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the GroupByColumn property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the ColumnX property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the ColumnY property is not set to its default value; otherwise, it returns False.
Invoke the
By default, the
This property specifies whether null data encountered in the bound data source should be treated as having a zero value, or an average value of the adjacent data points.
See the
When set to true, lines connecting each scatter point are drawn in the order the scatter points appear in the data source. If the lines do not connect the scatter points in the way expected, confirm that the data points have been properly ordered before charting.
This property can be employed by developers that require ScatterChart to appear as a line-equivalent chart with two continuous axes (since LineChart by definition has a discrete X-Axis).
The Icon property identifies an icon that is plotted by-series of scatter points. The icon can be one of several shapes, or letters.
When this property is set to Character, each scatter point will be displayed as specified by the
If IconSize is set to Auto then UltraChart automatically chooses a size based on the number of points that are being plotted.
This property is only used when
If there is more than one series of data (see GroupByColumn) then the char used for each series of data will be incremented starting with this property value.
When the selected character is a Unicode glyph, it is the developer's responsibility to ensure that the character code is represented in the
This property only applies when
See the
This property is ignored when the
When using the Series collection, GroupByColumn is not used; instead, just add more than one XYSeries to the chart, and each XYSeries represents a grouped series of points.
The column specified must contain a set of repeating, numeric values that are used to group each set of data points into a series of related scatter points.
A different Character or SymbolIcon (based on the setting of
This property can be used to specify which column in the data will be rendered along the horizontal X-Axis of the Scatter Chart. The column index is zero-based (i.e., the first column is at index 0).
This property can be used to specify which column in the data will be rendered along the Y-Axis of the Scatter Chart. The column index is zero-based (i.e., the first column is at index 0).
Developers may apply smoothing to the connecting lines (when
Developers can
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Please refer
Please refer
Please refer
If using a GroupByColumn, multiple polar data groups will be created, and each one will be filled separately, with a different color.
Please refer
Returns True if the LineEndCapStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the LineEndCapStyle property to its default value.
Once this method is invoked, the
Returns True if the MidPointAnchors property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the MidPointAnchors property to its default value.
Once this method is invoked, the
Returns True if the LineDrawStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the LineDrawStyle property to its default value.
Once this method is invoked, the
Returns True if the LineThickness property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the LineThickness property to its default value.
Once this method is invoked, the
Invoke the
Returns True if the ColorFill property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ColorFill property to its default value.
Once this method is invoked, the
When any property has changed from its default value, then those properties of this Appearance object must be serialized to reconstitute this Appearance object in the future.
This property specifies the end cap style of the data line plotted on the Radar Chart (some examples of endcaps include arrowheads, bulbous endpoints, et al.)
This property specifies whether to show the data points between line segments. Normally line segments join each other smoothly to form a continuous, bent line. By setting this flag developers can specify an enlarged point (an anchor) be plotted at the junctions of adjacent line segments.
This property determines the drawing style of the radial axis lines.
The
This property specifies the thickness of data lines appearing on a Radar Chart.
The spline tension controls how tightly the curve bends to fit the data points. The spline value should be greater than 0.0 but less than 0.5, with higher values leading to more sweeping, smoothened curves.
As with any hybrid chart appearance, instances of the ScatterLineAppearance class are dual-binding. This class exposes an Appearance and DataAppearance property of both the Scatter Chart (tied to the X- and Y- axes) and the Line Chart (tied to the secondary X2- and Y2- axes).
Calling the default constructor of any hybrid chart's appearance object is not recommended from application code. If it is necessary to use this constructor from a custom layer implementation, it is incumbent on the developer to initialize the
Returns True if the Axis property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Line property to its default value.
Once this method is invoked, the
Returns True if the Scatter property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Scatter property to its default value.
Once this method is invoked, the
Returns True if the ScatterData property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ScatterData property to its default value.
Once this method is invoked, the
Returns True if the Data property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the LineData property to its default value.
Once this method is invoked, the
When any properties have changed from their default values, these properties need to have their non-default values persisted.
This property provides access to the chart's line appearance qualities.
This property provides access to the Scatter Chart's appearance properties, and should be used by developers when customizing the appearance of the Scatter Chart component of the hybrid chart.
This property exposes a distinct DataAppearance for the ScatterChart component of the present hybrid chart. Developers must set a
For more information, see the
This property exposes a distinct DataAppearance for the LineChart component of the present hybrid chart. Developers must set a
For more information, see the
This is a child appearance appearing on the
Scrolling and scaling can only be performed on two-dimensional axes. On hybrid charts (or custom layers where secondary axes are bound to separate data), X/X2 and Y/Y2 scrolling and scaling can be done independently of each other.
For backwards compatibility, scrollbars are not displayed by default.
This property is not used by WebChart. To enable the scrollbar in WebChart, set UltraChart.EnableScrollbar to True.
It is sometimes more convenient to think of the width of the scrollbar as its thickness. The scrollbar will always run the length spanned by the axis.
Width applies to the 2-D thickness of the flat scrollbar rendered; when appearing in 3-D charts a scrollbar should have both a Width and a
This property is not used by WebChart. To enable the scrollbar in WebChart, set UltraChart.EnableScrollbar to True.
This property will only apply to 3-D charts, and has been reserved for future use. It presently has no effect.
This property is not used by WebChart. To enable the scrollbar in WebChart, set UltraChart.EnableScrollbar to True.
For backwards compatibility, the scrollbars default to hidden.
This property is not used by WebChart. To enable the scrollbar in WebChart, set UltraChart.EnableScrollbar to True.
This property defines how the scrollbar is positioned when the chart is originally displayed to the end user. It may have values of between 0.0 and 1.0.
By default, there is no scroll position because the entire chart is in view. Scrolling is only effective when the end user has zoomed-in (
This property is not used by WebChart. To enable the scrollbar in WebChart, set UltraChart.EnableScrollbar to True.
This property defines how the present view is scaled when presented to the end user. It may have values of between 1.0 and 0.0. A value of 0.5 indicates that the end user can see 1/2 of the chart on the dimension of the current axis, and that any chart elements visible are scaled by a zoom-in factor of 2X.
By default, the end user view of the chart is fully scaled out such that the entire chart is visible.
This property is not used by WebChart. To enable the scrollbar in WebChart, set UltraChart.EnableScrollbar to True.
The main feature of SkinAppearance is the
Returns True if the ApplyRowWise property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ApplyRowWise property to its default value.
Once this method is invoked, the
Returns True if the PaintElement property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the PaintElement property to its default value.
Once this method is invoked, the
Returns True if the PaintElement property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the PaintElement property to its default value.
Once this method is invoked, the
Skinning chart elements row-wise applies one member of the
For best results, it is recommended there be at least as many (or more)
The default value for row-wise motif application is True.
Developers should assign an array of
It is not recommended to use
Whenever changing the values of PaintElements within this array dynamically within your application, the developer must call Invalidate on the control for the new motif to take effect.
This property can only be assigned and customized at run-time.
A spline is a curvilinear path that approximates data points (that may ordinarily be connected by line segments) using Bézier calculations that smoothen out "noisy" data points. For more information on controlling the smoothing factor employed by a spline, see the
The
Utilize this constructor when a default
Invoke the
Invoke the
Invoke the
When one or more properties change in value, it is necessary to serialize their new values. This state management is handled by the control.
Determines the thickness of the splines drawn in this SplineChart. The thickness, or spline width, is measured in pixels, and it can have values between 0 to 10. Setting a spline thickness of 0 allows developers to essentially set splines to an non-visible state.
Determines how the spline will be rendered (e.g. Solid, Dash, Dotted, etc.) Please consult the documentation for the
The spline tension controls how tightly the curve bends to fit the data points. The spline value should be greater than 0.0 but less than 0.5, with higher values leading to more sweeping, smoothened curves.
This class contains the properties that describe styles specific to Spline-Area hybrid charts (that is a chart where one Y-Axis serves as the axis for Spline chart data, while the other Y-Axis serves Area Chart data.) Each vertical axis may scale differently, and each chart may bind to separate data.
Invoke the
When one or more properties change in value, it is necessary to serialize their new values. This state management is handled by the designer.
The spline tension controls how tightly the curve bends to fit the data points. The spline value should be greater than 0.0 but less than 0.5, with higher values leading to more sweeping, smoothened curves.
UltraChart relies on Appearance objects to encapsulate its style and presentation information. This class contains the properties that describe styles specific to Spline Chart.
A spline chart is a two-dimensional graph similar to a
Invoke the
When one or more properties change in value, it is necessary to serialize their new values. This state management is handled by the designer.
The spline tension controls how tightly the curve bends to fit the data points. The spline value should be greater than 0.0 but less than 0.5, with higher values leading to more sweeping, smoothened curves.
This appearance object applies to charts of the following
Stacked charts add an implicit additional dimension to data in their rendition of 'piles', where each field of data is charted proportionately to others within its series. In addition to the properties of this class, some properties of
The default value of the
Piles may be compared to one another with either of the Normal stack style (the default), or the Complete stack style. In the Normal style, the length of each pile corresponds to the sum of its fields, and absolute comparisons of fields between piles can be made. When the Complete style is applied, each pile, regardless of the sum of its fields, has a constant length and judgements as to the proportionality of fields can more easily be made.
In 3-D charts, use of the Complete style is not recommended.
Striplines are narrow rectangular bands or "stripes" that appear at a periodic interval behind graphic chart elements. Strip lines can be used on any 2-D axis where grouping occurs, such as the X-axis of a column chart or the Y-axis of a bar or Gantt chart.
Developers can activate striplines on a single axis by retrieving the appropriate
Strip lines will be orthogonal to their parent axis, and appear behind every Nth data element as specified by the
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned.
When set to true, the chart will display strip lines in its background.
The value of this property is ignored if the active chart type is not supported (Strip lines apply only to 2D Charts).
This property allows customization of the frequency of strip lines appearing behind the chart. Please note that the count of items that determine whether a strip line should be drawn or not depends on the axis style (continuous, group by series, or chronological). The value for Interval must be a positive integer (greater than zero).
Developers control the color, gradient or hatch of the strip lines rendered using the properties of the
This appearance object applies to charts of the following
TimeAxis charts add an implicit additional dimension to data in their rendition of 'piles', where each field of data is charted proportionately to others within its series. In addition to the properties of this class, some properties of
The default value of the
UltraChart supports four titles per chart: one at the top, left, bottom and right. The presentation of each title can be controlled by an instance of the TitleAppearance class.
Horizontal orientations are not recommended for titles appearing along the right or left edge of the chart. Vertical orientations are not recommended for titles appearing at the top or bottom of the chart.
Specifies where title text should be placed. The results of specifying more than one
Returns True if the Extent property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Extent property to its default value.
Once this method is invoked, the
Returns True if the Visible property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Visible property to its default value.
Once this method is invoked, the
Returns True if the Text property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Text property to its default value.
Once this method is invoked, the
Returns True if the Font property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Font property to its default value.
Once this method is invoked, the
Returns True if the FontColor property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the FontColor property to its default value.
Once this method is invoked, the
Returns True if the WrapText property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the WrapText property to its default value.
Once this method is invoked, the
Returns True if the HorizontalAlign property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the HorizontalAlign property to its default value.
Once this method is invoked, the
Returns True if the VerticalAlign property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the VerticalAlign property to its default value.
Once this method is invoked, the
Returns True if the FontSizeBestFit property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the FontSizeBestFit property to its default value.
Once this method is invoked, the
This string value is used to fill in value in design-time Property Browser.
Returns True if the Location property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Location property to its default value.
Once this method is invoked, the
Returns True if the Orientation property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Orientation property to its default value.
Once this method is invoked, the
This value represents the width (for left and right) or height (for top and bottom) of the title. It includes both the size of any lines of text in the title, as well as margin space.
The Extent value is specified in pixels.
True to indicate a title is shown; otherwise, False.
Formatting strings can be specified. Please see the "String Formats" topic of the UltraChart help for the appropriate values of this property.
This property controls the margins of the chart's title.
The
The
The
True to indicate that title text that does not fit will be wrapped onto multiple lines; otherwise, False.
The
The
If this property is set to True, the font size of title text is calculated to best fit the alloted space; otherwise, the size specified by the
The
This property controls the location of title text. Title text can appear on the top or bottom or left or right side of the chart.
This collection holds
When index is out of the acceptable range (see
Developers must use the
Developers can set properties on this Appearance object at design-time or run-time to alter the vantage point a user has when examining a three-dimensional chart, including specifying the
Three-dimensional charts are displayed in a 3-D chart grid area, with XY, XZ and YZ backplanes and a clear frontal view. Using this class, developers may rotate a chart such that the user is looking at it through a backplane (ie, from behind or underneath the chart grid). The result of such viewing angles are undefined. Instead of rotating behind the chart grid, developers should re-orient the data plotted in the 3-D chart to bring background elements to the front for the user to examine.
End users may rotate and revolve charts (in UltraWinChart only) at run-time by holding down the ALT-key on the keyboard and dragging the mouse. Developers can disable this by intercepting and terminating mouse events when the ALT-key is depressed.
Returns True if the XRotation property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the XRotation property to its default value.
Once this method is invoked, the
Returns True if the YRotation property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the YRotation property to its default value.
Once this method is invoked, the
Returns True if the ZRotation property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ZRotation property to its default value.
Once this method is invoked, the
Returns True if the Scale property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Scale property to its default value.
Once this method is invoked, the
Returns True if the Perspective property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Perspective property to its default value.
Once this method is invoked, the
Returns True if the Light property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Light property to its default value.
Once this method is invoked, the
Returns True if the Outline property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Outline property to its default value.
Once this method is invoked, the
Returns True if the EdgeSize property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the EdgeSize property to its default value.
Once this method is invoked, the
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned.
The value specified is in terms of degrees. 0 represents no rotation, with each additional 90 degrees rotating the chart one quarter around the X-Axis. The X-Axis is the horizontal axis, it forms the XY ground plane with the Y-Axis.
The
The value specified is in terms of degrees. 0 represents no rotation, with each additional 90 degrees rotating the chart one quarter around the Y-Axis. The Y-Axis is the axis leading into the screen, because the ground plane of all 3-D charts is the XY plane.
The
The value specified is in terms of degrees. 0 represents no rotation, with each additional 90 degrees rotating the chart one quarter around the Z-Axis. The Z-Axis is the vertical axis.
The
A value of 100 represents 100%, meaning the chart is rendered at full scale. A setting of 50 would render the chart at half the size of full scale, while 200 would do so at twice the size of full scale. Scaling out to maximum (1/20th scale) may make the chart and its labels unreadable.
End users (in UltraWinChart only) can zoom-in or zoom-out of the chart at run-time by depressing the ALT key while rotating the mouse wheel. Developers can disable this functionality by intercepting and terminating the mouse wheel event themselves.
A value of 100 represents 100%, meaning the chart is rendered at full perspective.
Perspective is the way in which objects appear to the eye based on their dimensions and the position. For example, the parallel lines of a railway track are perceived as meeting at a distant point at the horizon. As objects become more distant, they begin to appear smaller.
The edge size is size of the 3d beveled edges of some 3D objects. It is floating point value and it represents a size in pixels.
There is no Visible property for WinTooltipAppearance. Developers wanting to hide tooltips should set the
Invoke the
Invoke this method to reset the
Once this method has been invoked, the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Invoke the
Since the value of the Format property is used to generate the
Invoke this method to reset the
Once this method is invoked, the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the Font property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Font property to its default value.
Once this method is invoked, the
Returns True if the FontColor property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the FontColor property to its default value.
Once this method is invoked, the
Returns True if the AlphaLevel property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the AlphaLevel property to its default value.
Once this method is invoked, the
Returns True if the BorderStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the BorderStyle property to its default value.
Once this method is invoked, the
Invoke this method to reset the Overflow property to its default value.
Once this method is invoked, the
Returns True if the Overflow property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the BorderThickness property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the BorderThickness property to its default value.
Once this method is invoked, the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the BackColor property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the BackColor property to its default value.
Once this method is invoked, the
Returns True if the HighlightFillColor property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the HighlightFillColor property to its default value.
Once this method is invoked, the
Returns True if the HighlightOutlineColor property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the HighlightOutlineColor property to its default value.
Once this method is invoked, the
This turns on highlighting of chart elements by rendering a slightly smaller version of an identical chart element on top of the existing chart element. If the underlying chart element has texturing or shading that should show through, then consider setting the
Highlighting added by this method can be removed by just calling
This method clears all highlighting of chart elements that were turned on by
The location is relative to the top left corner (0,0) of the UltraWinChart control. The returned ChartDataEventArgs object contains the same event arguments as would be returned from handling the ChartDataClicked event.
The string value of this
Returns True if the PE property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the PE property to its default value.
Once this method is invoked, the
Tooltips can be displayed on a developer-specified trigger, or not at all.
When this property is assigned the value MouseClick, a tooltip is displayed when the user clicks on a chart element. When the value MouseMove is assigned to this property, any mouse movement above a chart element causes the tooltip to appear.
Tooltips can be hidden by assigning the value Never to this property.
When chart elements are highlightable depends on the value of the
The
Use this property to select a pre-defined format for tooltip text. A custom format can be specified by setting the
This property specifies a custom format for tooltip text. The
Please see the "String Formats" topic of the UltraChart help for typical formatting keywords used by this property.
The
The
The valid range of values for this property are from 0 to 255, inclusive. A value of 0 indicates the tooltip is completely transparent; 255, completely opaque. Changing the
Developers should use the
This property indicates the style of tooltip borders.
The
The value specified is in pixels.
The
The
This property also affects the
Developers should use the
Data point highlights are only displayed when the
The
Data point highlights are only displayed when the
The
Developers control the color, gradient or hatch of the tooltip box rendered behind tooltip text using the properties of the
By default the font used on new instances of ChartTextAppearance objects is a 10pt Arial font.
DrillDownID is used by DrillElement and offers properties for identifying the data row and the data column underlying a rendered chart element in a parent chart. This is used to locate a matching DrillElement in the drill down implementation. It should not be necessary for developers to work directly with DrillDownID objects.
This is the preferred means of creating a DrillDownID object.
This method is a necessary override (always override GetHashCode() anytime you override Equals()) and useful to support a System.Collection.Hashtable's use in DrillElement. The hash function selected should not produce collisions for data sources with fewer than 256 columns.
Developers set the properties of DrillElement for the top most chart and each child chart that can be drilled to. The end result of successfully preparing a set of DrillElements will be a tree-like structure where the data elements rendered on the chart are drillable to different child charts depicting more detailed information (potentially presented in alternate chart types, i.e., drilling from a 3D Bar Chart to a Pie Chart).
For these purposes, developers will find it necessary to set (at minimum) the DrillElement's ID property (identifying what data element on a parent chart will be drillable), its Data source (identifying where information comes from to populate the child chart drilled to), and the chart type (of the child chart).
An additional property that may be of interest include setting an IDrillDown implementation that will be called-back when a drill down occurs to that child chart. Setting an IDrillDown implementation is optional, but provides an opportunity for the application to customize the presentation of the Chart's title, axes, et al.
Developers are encouraged to use one of the parameterized constructors for this class. Initializing DrillElement objects through this constructor still leaves the developer with the responsibility of setting the DrillElement's properties.
This constructor provides developers with a convenient means of initializing all mandatory properties of a DrillElement object. By default, DrillElement objects created by this constructor do not specify an
This constructor provides developers with a convenient means of initializing all commonly-used properties of a DrillElement object, including the optional
The ID property is a
During drill down processing, the chart control changes its
During drill down processing, the chart control is re-bound to the DataSource of this DrillElement. It is the responsibility of the developer that the DataSource be compatible with the child
Specifying an IDrillDown implementation for a DrillElemnt is optional, and if left unspecified no callback into application code occurs.
Developers are encouraged to supply an IDrillDown implementation on DrillElement to handle cases when drilling down changes chart type and/or appearance in the child chart. The callback method on this interface is invoked after the chart has changed type (to
This member supports the UltraWebChart control infrastructure and is not intended to be used directly from your code.
While this interface has two overloads of the Apply method; it may be appropriate only to implement one of them, depending on the Effect's behavior.
If this is the case, simply return without taking any action in the method overload that is not being used.
All Effects added to the Chart's Effects collection will have both of these methods called once during the chart's rendering process.
This method will only be called if the Effects.ApplyToChartImage property is set to true.
The base class implementation of this method is merely a placeholder; it does not have any effect on the SceneGraph.
The base class implementation of this method is merely a placeholder; it does not have any effect on the chart image.
If creating an effects collection in code, pass either a reference to an instance of an UltraChart component, or null. The component reference is actually not needed unless this collection is going to be viewed in a designer (like a properties grid) in conjunction with a particular UltraChart component.
This is not the Clone() method typically called by the chart core; it is only to implement ICloneable. This method will directly call the strongly-typed Clone() method of the EffectsCollection.
Applying to the ChartImage is only supported when the Effects.ApplyToChartImage property is set to True.
When programming the chart control's advanced features (e.g.,
This method resizes all drawing layers (a chart can be thought of as being composed of a number of transparent layers, each overlaying the other and contributing additional information to the presentation). It also updates the bounding boxes based on whether the layers have, in aggregate, grown or diminished.
Resize and refresh operations are initiated by the control automatically when a size-related property changes its value.
This method re-renders the chart image with all of its adornments (these are tooltips, highlights, etc) when an Appearance changes. It will additionally set a dirty flag dependent upon the
This method populates an informative object,
This method can be used to retrieve references of many of the Appearance-derived objects on a Chart component instance (for instance, axis or label appearances). It is exposed to support the development of custom
Developers are encouraged to use the public Appearance properties of the Chart whenever possible.
Design-mode refers to the design-time property browsing, prototyping, and manipulations of integrated development environments (IDEs). When the component is living in this environment it may behave differently than it would in run-time (as far as looking for live, dynamic data sources, for instance). This indicator facilitates identification of design-time from run-time environments.
The component includes some sample data compatible with its many chart types. It is this data that is rendered in the design-time environment to render prototypical charts that aid the developer in visualizing the final chart's appearance. Calling this method resets this sample data.
Retrieves an untyped property value by name from the chart component through reflection.
Updates an untyped property value by name from the chart component through reflection. Changing appearance properties will also refresh the control by repainting/invalidating it.
This method sets whether data is valid or not. It is called usuallly only for invalid data, so that an event can be fired from the IChartComponent.
Developers should always add and remove handlers from UltraChart using the published events on the control.
This property manages an array of strings where each string uniquely identifies a layer (these string identifies should correspond to the
Developers set a reference to an IDrillDown implementation on any or all DrillElement objects added to the
While the same IDrillDown implementation can be provided to handle all chart drill downs, it is recommended that one IDrillDown implementation be created for each child chart. This permits any data element rendered in the chart to be distinguishable by the IDrillDown implementation (in the supplied row and column arguments to the Drill() method).
This is a callback method from within the control's drill down processing that gives developers the opportunity to modify a chart's appearance and presentation when end users drill down into previously prepared drillable chart elements (see the
Developers set a reference to an IDrillDown implementation on any or all DrillElement objects added to the
While the same IDrillDown implementation can be provided to handle all chart drill downs, it is recommended that one IDrillDown implementation be created for each child chart. This permits any data element rendered in the chart to be distinguishable by the IDrillDown implementation (in the supplied row and column arguments to the Drill() method).
This is a callback method from within the control's drill down processing that gives developers the opportunity to modify a chart's appearance and presentation when end users drill down into previously prepared drillable chart elements (see the
Developers of custom layers may meet the requirements of this
interface by acquiring for themselves and using an
Values range between 0.0 and 1.0. Results of values outside this range are undefined.
Values range between 0.0 and 1.0. Results of values outside this range are undefined.
Scrolling with the scrollbars cannot be done by an interval smaller than the WindowInterval. It is possible to programmatically set the
This is generally defined as
This is generally defined as
The alpha component of the original color is preserved by this operation.
The alpha component of the original color is preserved by this operation.
The alpha component of the original color is preserved by this operation.
If creating an Override collection in code, pass either a reference to an instance of an UltraChart component, or null. The component reference is actually not needed unless this collection is going to be viewed in a designer (like a properties grid) in conjunction with a particular UltraChart component.
This is not the Clone() method typically called by the chart core; it is only to implement ICloneable. This method will directly call the strongly-typed Clone() method of the OverridesCollection.
Returns the new color chosen for the background of the chart.
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned.
Contains a reference to the new background image.
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned.
This property returns the Index of the DataRow which was clicked.
This property returns the Index of the DataColumn which was clicked.
This property returns the DataValue of the Data object which was clicked.
This property returns the text label of the DataRow which was clicked.
This property returns the text label of the DataColumn which was clicked.
This property returns the text
Developers can also subscribe to this event in order to develop Web drill-down charting applications.
Depending on the ChartType, this array varies in form.
In most cases, it will be a simple object array containing System.Double values and null/Nothing. In other cases, the Array might contain other types such as System.DateTime, or the array might be multi-dimensional.
Smart tickmarks are implemented for 2D charts only.
The lowest data values will be assigned the color at the beginning of the palette, whereas the highest data values will be assigned the color at the end of the palette.
When a DataValueLinearRange Color Model is used, the lowest values in the data will be colored at the low end of the color range, ColorBegin. The highest values in the data will be colored at the high end of the color range, ColorEnd. Values in between will be colored in a blend of these two colors. If the legend is visible, it will appear as a special type of legend which uses a gradient to illustrate what color will be used for numeric values within the range.
This enumeration lists all sub-Chart Types (applicable to hybrid Chart types) that are available for drawing upon as a Data Source.
Some objects do not have values that can be converted to a string. In these cases, an empty string is returned.
Needed for ICloneable implementation. If desired, use the strongly-typed LabelStyle.Clone() method instead of this one.
The
The
The
True to indicate that label text that does not fit will be wrapped onto multiple lines; otherwise, False.
The
The
The
True to indicate that label text that does not fit is clipped; otherwise, False.
The
This property controls the direction of label text.
This property is frequently set on labels by the chart core. When changing its value, be aware that it may already be storing a value for the chart core, and it might get changed again by the chart core. This is particularly true in the case of axis labels.
The best practice for changing this property's value in code is to increment or decrement its existing value, rather than changing it to a new value altogether.
This property is frequently set on labels by the chart core. When changing its value, be aware that it may already be storing a value for the chart core, and it might get changed again by the chart core. This is particularly true in the case of axis labels.
The best practice for changing this property's value in code is to increment or decrement its existing value, rather than changing it to a new value altogether.
Needed for ICloneable implementation. If desired, use the strongly-typed LineStyle.Clone() method instead of this one.
This property determines the drawing style of the start of the lines in a chart.
The
This property determines the drawing style of the end of the lines in a chart.
The
This property determines the drawing style of the lines in a chart.
The
True specifies the midpoints are shown; otherwise, False.
Whenever overriding
The value is specified in pixels.
The bottom, left, and right margins are specified by the
The value is specified in pixels.
The top, bottom, and right margins are specified by the
The value is specified in pixels.
The top, bottom, and left margins are specified by the
The value is specified in pixels.
The top, left, and right margins are specified by the
See the documentation for the
A gradient is a blend of color beginning at the principle color for this graphical object, specified by the
Bump and two-color gradients transition their color from the principle color (defined as the Fill color) at the center into the FillStopColor at the edge(s). Examples of gradients that use this approach include HorizontalBump, VerticalBump, Circular, Elliptical and Rectangular.
Where possible, developers should use None in lieu of Default. The definition of a Default gradient may change in the future.
Using None is preferred to using Default.
The mathematical definition of a vertical gradient is a linear change as one moves in a vertical direction. This is the definition exposed by the underlying framework, however developers should be conscious of the fact it may differ from the artistic perception of a gradient commonly employed by some end user applications and photo-editing software.
The mathematical definition of a horizontal gradient is a linear change as one moves in a horizontal direction. This is the definition exposed by the underlying framework, however developers should be conscious of the fact it may differ from the artistic perception of a horizontal gradient resembling a "horizon," commonly employed in some end user applications and photo-editing software.
Where possible, developers should use
A solid, textured or gradient background should be applied instead.
This hatch pattern is equivalent to the crossed lines hatch pattern, Cross.
This hatch pattern is equivalent to
The ratio of foreground color to background color is 1:20.
The ratio of foreground color to background color is 1:10.
The ratio of foreground color to background color is 1:5.
The ratio of foreground color to background color is 1:4.
The ratio of foreground color to background color is 3:10.
The ratio of foreground color to background color is 2:5.
The ratio of foreground color to background color is 1:2.
The ratio of foreground color to background color is 3:5.
The ratio of foreground color to background color is 7:10.
The ratio of foreground color to background color is 3:4.
The ratio of foreground color to background color is 4:5.
The ratio of foreground color to background color is 9:10.
To map on a natural logarithmic scale, set
Use this style when proportionality, not absolute values, is important to the semantic meaning of the chart.
This enumeration is used internally by the UltraChart charting infrastructure, and it should not be necessary to access it from application code.
Used internally.
Adornments are additional decorations on the chart such as tooltips, striplines and chart text labels.
Titles can be customized through the
This setting is the default and has been provided for backward compatibility.
Developers may continue to sort their data to any criteria desired, with rows appearing later in the data set producing chart elements that render in the foreground.
When bubbles are sorted by increasing radius, larger bubbles percolate into the foreground, in front of smaller bubbles.
When bubbles are sorted by decreasing radius, smaller bubbles percolate into the foreground, in front of larger bubbles.
Tooltips, scrollbars, and crosshairs are not available in Flash Rendering.
Developers should use the
This method is used at design-time and by samples. Developers should not need to invoke this method from their application code.
The calling process must have security permissions to create a new file at the destination filePath.
The calling process must have security permissions to read a file at the source filePath.
Developers can use this UnPersist overload to reconstitute UltraChart from NetworkStreams or MemoryStreams.
This control provides tool tips and support for WinTooltipAppearance.
Using IGWinTooltip is a two-step process:
Call this method to set the location of a tool tip. The contents must be separately assigned to IGWinTooltip as primitives added to the
Attaches IGWinTooltip to a parent control. IGWinTooltip needs to associate itself with controls above UltraWinChart so that the tool tip that renders is not clipped by the bounds of UltraWinChart.
Since the Location properties of parent controls are needed to translate mouse interaction coordinates to chart-relative coordinates, this method also registers this object to receive notifications of the
If IGWinTooltip has been attached to a containing top-level control using the
This method handles the LocationChanged event from any controls in the containment hierarchy above and including the chart control. Each time the Location property of any ancestor changes (for example, as the result of a programmatic property change or interactive movement of the container, control or form layout) this method updates the
Invoke this method to reset the Size property to its default value.
Returns True if the EmptyChartText property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the EmptyChartText property to its default value.
Once this method is invoked, the
The PageSettings object is used to specify the attributes of the print job, such as page size, orientation, margins, etc.
Returns True if the ChartType property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ChartType property to its default value.
Once this method is invoked, the
Returns True if the BackColor property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the BackColor property to its default value.
Once this method is invoked, the
Returns True if the Transform3D property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Transform3D property to its default value.
Once this method is invoked, the
Returns True if the BackgroundImage property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the BackgroundImage property to its default value.
Once this method is invoked, the
Returns True if the EnableCrossHair property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the EnableCrossHair property to its default value.
Once this method is invoked, the
Returns True if the BackgroundImageStyle property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the BackgroundImageStyle property to its default value.
Once this method is invoked, the
Invoke this method to reset the Border property to its default value.
Once this method is invoked, the
Returns True if the Border property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Legend property to its default value.
Once this method is invoked, the
Returns True if the Legend property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the Data property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Data property to its default value.
Once this method is invoked, the
Returns True if the DataMember property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the DataMember property to its default value.
Once this method is invoked, the
When first binding the chart control to a data source, it is necessary to assign a data source to the
Normally, the chart will automatically update it's display when it recieves a notification from the
Returns True if the TitleTop property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the TitleTop property to its default value.
Once this method is invoked, the
Returns True if the TitleLeft property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the TitleLeft property to its default value.
Once this method is invoked, the
Returns True if the TitleRight property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the TitleRight property to its default value.
Once this method is invoked, the
Returns True if the TitleBottom property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the TitleBottom property to its default value.
Once this method is invoked, the
Returns True if the ColorModel property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ColorModel property to its default value.
Once this method is invoked, the
Returns True if the Axis property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Axis property to its default value.
Once this method is invoked, the
Returns True if the LineChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the LineChart property to its default value.
Once this method is invoked, the
Returns True if the ProbabilityChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ProbabilityChart property to its default value.
Once this method is invoked, the
Returns True if the ScatterChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ScatterChart property to its default value.
Once this method is invoked, the
Returns True if the PieChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the PieChart property to its default value.
Once this method is invoked, the
Returns True if the DoughnutChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the DoughnutChart property to its default value.
Once this method is invoked, the
Returns True if the SplineChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the SplineChart property to its default value.
Once this method is invoked, the
Returns True if the SplineAreaChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the SplineAreaChart property to its default value.
Once this method is invoked, the
Returns True if the RadarChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the RadarChart property to its default value.
Once this method is invoked, the
Returns True if the PieChart3D property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the PieChart3D property to its default value.
Once this method is invoked, the
Returns True if the BarChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the BarChart property to its default value.
Once this method is invoked, the
Returns True if the BarChart3D property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the BarChart3D property to its default value.
Once this method is invoked, the
Returns True if the ColumnChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ColumnChart property to its default value.
Once this method is invoked, the
Returns True if the GanttChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the GanttChart property to its default value.
Once this method is invoked, the
Returns True if the ColumnChart3D property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ColumnChart3D property to its default value.
Once this method is invoked, the
Returns True if the AreaChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the AreaChart property to its default value.
Once this method is invoked, the
Returns True if the HeatMapChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the HeatMapChart property to its default value.
Once this method is invoked, the
Returns True if the ScatterLineChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ScatterLineChart property to its default value.
Once this method is invoked, the
Returns True if the ColumnLineChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ColumnLineChart property to its default value.
Once this method is invoked, the
Returns True if the HeatMapChart3D property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the HeatMapChart3D property to its default value.
Once this method is invoked, the
Returns True if the BubbleChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the BubbleChart property to its default value.
Once this method is invoked, the
Returns True if the CandleChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the CandleChart property to its default value.
Once this method is invoked, the
Returns True if the HistogramChart property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the HistogramChart property to its default value.
Once this method is invoked, the
Returns True if the Tooltips property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the Tooltips property to its default value.
Once this method is invoked, the
This method saves the current chart image to a local file on the server. When the file is saved, the filePath
Not intended for use at the application level.
Not intended for use at the application level.
This method saves the current chart image to a stream.
Returns True if the UserLayerIndex property is not set to its default value; otherwise, it returns False.
Invoke the
Returns True if the ScrollBarImage property is not set to its default value; otherwise, it returns False.
Invoke the
Invoke this method to reset the ColorModel property to its default value.
Once this method is invoked, the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
Returns True if the
Invoke the
Invoke this method to reset the
Once this method is invoked, the
This method is intended for QA purposes and is not intended for use at the application level.
This event is obsolete. Please use the InvalidDataReceived event instead.
Leaving this set to true allows for certain mouse interaction in 3D charts. However, problems can occur when another control requests that focus be sent back to the chart. In these cases, setting AcceptsFocus to False is recommended.
DefaultConstants.D_ChartSize.
To customize other chart error messages and the label style used, try handling the InvalidDataReceived event.
This property exposes the
Each request for this property will result in a new PrintDocument being created, so avoid repeated requests to this Property getter.
The PrintDocument given by this property is returned and no longer referenced by the chart component; therefore, it is the Application's responsibility to dispose of the PrintDocument when it is no longer in use.
3-D charts can be rotated around their X and Y axes, as well as scaled (moved along the Z axis). The Transform3D property gives you the ability to manipulate the orientation and scaling of the chart to achieve the best perspective on the 3-D data being displayed.
For most charts, there is an optimal range of rotation for X, Y, and Z. This range is as follows:
Specify the full path and filename of a valid image file that will be displayed in the chart's background. The selected image will be scaled to the dimemsions of the chart (the default setting) or tiled to fill the available space, depending on the value of
Use the
The control supports a variety of data source types.
The most robust and extensible data source is the DataTable, which provides update notifications via the IBindingList interface. Use of these built-in ADO.NET data management types offers the greatest flexibility.
Many charts also support data-binding to ICollections (including simple arrays) provided the a single-typed, one-dimensional array can meet the chart type's Data Requirements. Chartable data sources include custom ICollections, and custom data objects that additionally support IBindingList may take advantage of live data-binding to the chart component.
Another data source that may be provided is the local filename of an XML or comma-delimited text file.
XML documents require an internal XML Schema document, and must be readily mappable to the Framework's DataSet (their msdata:IsDataSet attribute is set to true). The schema is also necessary since each XML element must be strongly-typed (otherwise their data type will be inferred as xsd:string and this will not translate readily into a DataSet, even though the data content of the element may be numeric.) Please see the "Generating DataSet Relational Structure from XML Schema" document in the .NET Framework documentation for more on the issues involved, and consult the samples included with this product for working schema.
Data may be unbound from a chart by calling the
Exposed internally through
This property is overridden, but does nothing other than return the value from the base class.
This property is overridden, but does nothing other than return the value from the base class.
This property is overridden, but does nothing other than return the value from the base class. Autoscroll functionality is not implemented in UltraChart.
This property is overridden, but does nothing other than return the value from the base class. Autoscroll functionality is not implemented in UltraChart. To use a scrollbar in a chart, use the Axis.N.ScrollScale properties.
This property is overridden, but does nothing other than return the value from the base class. Autoscroll functionality is not implemented in UltraChart. To use a scrollbar in a chart, use the Axis.N.ScrollScale properties.
This property is overridden, but does nothing other than return the value from the base class. Autoscroll functionality is not implemented in UltraChart. To use a scrollbar in a chart, use the Axis.N.ScrollScale properties.
This property is overridden, but does nothing other than return the value from the base class. Autoscroll functionality is not implemented in UltraChart. To use a scrollbar in a chart, use the Axis.N.ScrollScale properties.
This event is not implemented; it is overridden simply to make this event unbrowsable.
This event is not implemented; it is overridden simply to make this event unbrowsable.
This event is not implemented; it is overridden simply to make this event unbrowsable.
This event is not implemented; it is overridden simply to make this event unbrowsable.
This event is not implemented; it is overridden simply to make this event unbrowsable.
This event is not implemented; it is overridden simply to make this event unbrowsable.
This event is not implemented; it is overridden simply to make this event unbrowsable.
This event is not implemented; it is overridden simply to make this event unbrowsable.
Developers can use this property to retrieve an
Please refer
Please refer
Please refer