Class ChartArea

ChartArea class

Encapsulates the object that represents the chart area in the worksheet.

public class ChartArea : ChartFrame

Properties

NameDescription
virtual Area { get; }Gets the area.(Inherited from ChartFrame.)
virtual AutoScaleFont { get; set; }True if the text in the object changes font size when the object size changes. The default value is True.(Inherited from ChartFrame.)
Background { get; set; }(Obsolete.) Gets and sets the display mode of the background(Inherited from ChartFrame.)
BackgroundMode { get; set; }Gets and sets the display mode of the background(Inherited from ChartFrame.)
virtual Border { get; }Gets the border.(Inherited from ChartFrame.)
DefaultHeight { get; }(Obsolete.) Represents height of default position in units of 1/4000 of the chart area.(Inherited from ChartFrame.)
DefaultHeightRatioToChart { get; }Represents height of default position in units of Fraction of the chart area.(Inherited from ChartFrame.)
DefaultWidth { get; }(Obsolete.) Represents width of default position in units of 1/4000 of the chart area.(Inherited from ChartFrame.)
DefaultWidthRatioToChart { get; }Represents width of default position in units of Fraction of the chart area.(Inherited from ChartFrame.)
DefaultX { get; }(Obsolete.) Represents x of default position in units of 1/4000 of the chart area.(Inherited from ChartFrame.)
DefaultXRatioToChart { get; }Represents x of default position in units of Fraction of the chart area.(Inherited from ChartFrame.)
DefaultY { get; }(Obsolete.) Represents y of default position in units of 1/4000 of the chart area.(Inherited from ChartFrame.)
DefaultYRatioToChart { get; }Represents y of default position in units of Fraction of the chart area.(Inherited from ChartFrame.)
override Font { get; }Gets a Font object of the specified chartarea object.
override Height { get; set; }(Obsolete.) Gets or sets the vertical offset from its lower right corner row, in units of 1/4000 of the chart area.
virtual HeightPixel { get; set; }Gets or sets the height of frame in units of Pixel.(Inherited from ChartFrame.)
override HeightRatioToChart { get; set; }Gets or sets the vertical offset from its lower right corner row, in units of ratio of the chart area.
virtual IsAutomaticSize { get; set; }Indicates whether the chart frame is automatic sized.(Inherited from ChartFrame.)
IsDefaultPosBeSet { get; }Indicates whether default position(DefaultX, DefaultY, DefaultWidth and DefaultHeight) are set.(Inherited from ChartFrame.)
IsInnerMode { get; set; }Indicates whether the size of the plot area size includes the tick marks, and the axis labels. False specifies that the size shall determine the size of the plot area, the tick marks, and the axis labels.(Inherited from ChartFrame.)
Shadow { get; set; }True if the frame has a shadow.(Inherited from ChartFrame.)
ShapeProperties { get; }Gets the ShapeProperties object.(Inherited from ChartFrame.)
virtual TextFont { get; }(Obsolete.) Gets a Font object of the specified ChartFrame object.(Inherited from ChartFrame.)
virtual TextOptions { get; }Gets and sets the options of the text.(Inherited from ChartFrame.)
override Width { get; set; }(Obsolete.) Gets or sets the horizontal offset from its lower right corner column, in units of 1/4000 of the chart area.
virtual WidthPixel { get; set; }Gets or sets the width of frame in units of Pixel.(Inherited from ChartFrame.)
override WidthRatioToChart { get; set; }Gets or sets the horizontal offset from its lower right corner column, in units of ratio of the chart area.
override X { get; set; }(Obsolete.) Gets or gets the horizontal offset from its upper left corner column, in units of 1/4000 of the chart area.
virtual XPixel { get; set; }Gets or sets the x coordinate of the upper left corner in units of Pixel.(Inherited from ChartFrame.)
override XRatioToChart { get; set; }Gets or gets the horizontal offset from its upper left corner column, in units of ratio of the chart area.
override Y { get; set; }(Obsolete.) Gets or gets the vertical offset from its upper left corner row, in units of 1/4000 of the chart area.
virtual YPixel { get; set; }Gets or sets the y coordinate of the upper left corner in units of Pixel.(Inherited from ChartFrame.)
override YRatioToChart { get; set; }Gets or gets the vertical offset from its upper left corner row, in units of ratio of the chart area.

Methods

NameDescription
virtual SetPositionAuto()Set position of the frame to automatic(Inherited from ChartFrame.)

Examples

namespace AsposeCellsExamples
{
    using Aspose.Cells;
    using Aspose.Cells.Charts;
    using System;
    using System.Drawing;

    public class ChartAreaDemo
    {
        public static void ChartAreaExample()
        {
            // Instantiating a Workbook object
            Workbook workbook = new Workbook();

            // Obtaining the reference of the first worksheet
            Worksheet worksheet = workbook.Worksheets[0];

            // Adding a sample value to "A1" cell
            worksheet.Cells["A1"].PutValue(50);

            // Adding a sample value to "A2" cell
            worksheet.Cells["A2"].PutValue(100);

            // Adding a sample value to "A3" cell
            worksheet.Cells["A3"].PutValue(150);

            // Adding a sample value to "B1" cell
            worksheet.Cells["B1"].PutValue(60);

            // Adding a sample value to "B2" cell
            worksheet.Cells["B2"].PutValue(32);

            // Adding a sample value to "B3" cell
            worksheet.Cells["B3"].PutValue(50);

            // Adding a chart to the worksheet
            int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);

            // Accessing the instance of the newly added chart
            Chart chart = worksheet.Charts[chartIndex];

            // Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B3"
            chart.NSeries.Add("A1:B3", true);

            // Getting Chart Area
            ChartArea chartArea = chart.ChartArea;

            // Setting properties of ChartArea
            chartArea.X = 10;
            chartArea.Y = 10;
            chartArea.Width = 400;
            chartArea.Height = 300;
            chartArea.IsInnerMode = false;
            chartArea.AutoScaleFont = true;
            chartArea.BackgroundMode = BackgroundMode.Transparent;
            chartArea.IsAutomaticSize = true;
            chartArea.Shadow = true;

            // Setting the foreground color of the chart area
            chartArea.Area.ForegroundColor = Color.Yellow;

            // Saving the Excel file
            workbook.Save("ChartAreaExample.xlsx");
            workbook.Save("ChartAreaExample.pdf");
        }
    }
}

See Also