Class Chart
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Kapslar objektet som representerar ett enskilt Excel-diagram.
public class ChartArv
Ärvt Medlemmar
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Exempel
Följande koder visar hur man skapar ett diagram med .Net-koder.
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
Cells cells = sheet.Cells;
cells[0,1].PutValue("Inkomst");
cells[1,0].PutValue("Företag A");
cells[2,0].PutValue("Företag B");
cells[3,0].PutValue("Företag C");
cells[1,1].PutValue(10000);
cells[2,1].PutValue(20000);
cells[3,1].PutValue(30000);
int chartIndex = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15);
Chart chart = sheet.Charts[chartIndex];
chart.SetChartDataRange("A1:B4", true);
chart.ShowLegend = true;
chart.Title.Text = "Inkomstanalys";Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)
Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("Inkomst")
cells(1,0).PutValue("Företag A")
cells(2,0).PutValue("Företag B")
cells(3,0).PutValue("Företag C")
cells(1,1).PutValue(10000)
cells(2,1).PutValue(20000)
cells(3,1).PutValue(30000)
Dim chartIndex as Integer = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15)
Dim chart as Chart = sheet.Charts(chartIndex)
chart.SetChartDataRange("A1:B4", True);
chart.ShowLegend = True
chart.Title.Text = "Inkomstanalys"Egenskaper
ActualChartSize
Hämtar den faktiska storleken på diagrammet i enhet av pixlar.
[Obsolete("Använd Chart.GetActualSize() metoden istället.")]
public Size ActualChartSize { get; }Egenskapsvärde
Anmärkningar
OBS: Denna medlem är nu föråldrad. Istället, vänligen använd Chart.GetActualSize() metoden. Denna egenskap kommer att tas bort 12 månader efter juli 2022. Aspose ber om ursäkt för eventuella besvär du kan ha upplevt.
AutoScaling
Sant om Microsoft Excel skalar ett 3-D-diagram så att det är närmare i storlek till det motsvarande 2-D-diagrammet. Egenskapen RightAngleAxes måste vara sann.
public bool AutoScaling { get; set; }Egenskapsvärde
BackWall
Returnerar ett Aspose.Cells.Charts.Chart.Walls-objekt som representerar bakväggen i ett 3-D-diagram.
public Walls BackWall { get; }Egenskapsvärde
CategoryAxis
Hämtar diagrammets X-axel.
public Axis CategoryAxis { get; }Egenskapsvärde
ChartArea
Hämtar diagramområdet i kalkylbladet.
public ChartArea ChartArea { get; }Egenskapsvärde
ChartDataTable
Representerar diagramdata tabellen.
public ChartDataTable ChartDataTable { get; }Egenskapsvärde
ChartObject
Representerar diagramformen;
public ChartShape ChartObject { get; }Egenskapsvärde
DepthPercent
Representerar djupet av ett 3-D-diagram som en procentandel av diagrammets bredd (mellan 20 och 2000 procent).
public int DepthPercent { get; set; }Egenskapsvärde
DisplayNaAsBlank
Anger om #N/A ska visas som ett tomt värde.
public bool DisplayNaAsBlank { get; set; }Egenskapsvärde
Elevation
Representerar höjden på 3-D-diagramvyn, i grader.
public int Elevation { get; set; }Egenskapsvärde
Anmärkningar
Diagrammets höjd är den höjd vid vilken du ser diagrammet, i grader. Standardvärdet är 15 för de flesta diagramtyper. Värdet för denna egenskap måste vara mellan -90 och 90, förutom för 3-D-stapeldiagram, där det måste vara mellan 0 och 44.
FilteredNSeries
Hämtar en Aspose.Cells.Charts.SeriesCollection-samling som representerar de dataserier som är filtrerade i diagrammet.
public SeriesCollection FilteredNSeries { get; }Egenskapsvärde
FirstSliceAngle
Hämtar eller ställer in vinkeln för den första tårt- eller donutdiagramskivan, i grader (medurs från vertikalt). Gäller endast för tårtor, 3-D-tårtor och donutdiagram, 0 till 360.
public int FirstSliceAngle { get; set; }Egenskapsvärde
Floor
Returnerar ett Aspose.Cells.Charts.Chart.Floor-objekt som representerar väggarna i ett 3-D-diagram.
public Floor Floor { get; }Egenskapsvärde
Anmärkningar
Denna egenskap gäller inte för 3-D-tårtdiagram.
GapDepth
Hämtar eller ställer in avståndet mellan dataserier i ett 3-D-diagram, som en procentandel av markörens bredd. Värdet för denna egenskap måste vara mellan 0 och 500.
public int GapDepth { get; set; }Egenskapsvärde
GapWidth
Returnerar eller ställer in utrymmet mellan stapel- eller kolumnkluster, som en procentandel av stapel- eller kolumnbredden. Värdet för denna egenskap måste vara mellan 0 och 500.
public int GapWidth { get; set; }Egenskapsvärde
HeightPercent
Returnerar eller ställer in höjden på ett 3-D-diagram som en procentandel av diagrammets bredd (mellan 5 och 500 procent).
public int HeightPercent { get; set; }Egenskapsvärde
HidePivotFieldButtons
Anger om pivotdiagramfältknapparna ska döljas endast när diagrammet är PivotChart.
public bool HidePivotFieldButtons { get; set; }Egenskapsvärde
Is3D
Anger om diagrammet är ett 3D-diagram.
public bool Is3D { get; }Egenskapsvärde
IsRectangularCornered
Hämtar eller ställer in ett värde som anger om diagramområdet är rektangulärt hörnat. Standard är sant.
public bool IsRectangularCornered { get; set; }Egenskapsvärde
Legend
Hämtar diagrammets legend.
public Legend Legend { get; }Egenskapsvärde
Line
Hämtar linjen.
public Line Line { get; }Egenskapsvärde
NSeries
Hämtar en Aspose.Cells.Charts.SeriesCollection-samling som representerar dataserierna i diagrammet.
public SeriesCollection NSeries { get; }Egenskapsvärde
Name
Hämtar och ställer in namnet på diagrammet.
public string Name { get; set; }Egenskapsvärde
PageSetup
Representerar sidinställningsbeskrivningen i detta diagram.
public PageSetup PageSetup { get; }Egenskapsvärde
Perspective
Returnerar eller ställer in perspektivet för 3-D-diagramvyn. Måste vara mellan 0 och 100. Denna egenskap ignoreras om egenskapen RightAngleAxes är sann.
public short Perspective { get; set; }Egenskapsvärde
PivotOptions
Specificerar pivotkontrollerna som visas på diagrammet.
public PivotOptions PivotOptions { get; }Egenskapsvärde
PivotSource
Källan är datan i pivotTabellen. Om PivotSource inte är tomt, är diagrammet ett PivotChart.
public string PivotSource { get; set; }Egenskapsvärde
Anmärkningar
Om pivottabellen “PivotTable1” i kalkylbladet “Sheet1” i filen “Book1.xls”.
PivotSource kan vara “[Book1.xls]Sheet1!PivotTable1” om diagrammet och pivottabellen inte är i samma arbetsbok.
Om du ställer in denna egenskap, kommer den tidigare datakällinställningen att gå förlorad.
Placement
Representerar hur diagrammet är fäst vid cellerna under det.
public PlacementType Placement { get; set; }Egenskapsvärde
PlotArea
Hämtar diagrammets plotområde som inkluderar axelticketiketter.
public PlotArea PlotArea { get; }Egenskapsvärde
PlotBy
Hämtar och ställer in om plotta efter rad eller kolumn.
public PlotDataByType PlotBy { get; }Egenskapsvärde
PlotEmptyCellsType
Hämtar och ställer in hur man plottar de tomma cellerna.
public PlotEmptyCellsType PlotEmptyCellsType { get; set; }Egenskapsvärde
PlotVisibleCellsOnly
Anger om endast synliga celler ska plottas.
public bool PlotVisibleCellsOnly { get; set; }Egenskapsvärde
PrintSize
Hämtar och ställer in den utskrivna diagramstorleken.
public PrintSizeType PrintSize { get; set; }Egenskapsvärde
RightAngleAxes
Sant om diagramaxlarna är i räta vinklar. Gäller endast för 3-D-diagram (utom Column3D och 3-D Pie-diagram).
public bool RightAngleAxes { get; set; }Egenskapsvärde
Anmärkningar
Om denna egenskap är sann, ignoreras egenskapen Perspective.
RotationAngle
Representerar rotationen av 3-D-diagramvyn (rotationen av plotområdet runt z-axeln, i grader).
public int RotationAngle { get; set; }Egenskapsvärde
Anmärkningar
Värdet för denna egenskap måste vara mellan 0 och 360, förutom för 3-D-stapeldiagram, där värdet måste vara mellan 0 och 44.
Standardvärdet är 20. Gäller endast för 3-D-diagram.
SecondCategoryAxis
Hämtar diagrammets andra X-axel.
public Axis SecondCategoryAxis { get; }Egenskapsvärde
SecondValueAxis
Hämtar diagrammets andra Y-axel.
public Axis SecondValueAxis { get; }Egenskapsvärde
SeriesAxis
Hämtar diagrammets serieaxel.
public Axis SeriesAxis { get; }Egenskapsvärde
Shapes
Returnerar alla ritformer i detta diagram.
public ShapeCollection Shapes { get; }Egenskapsvärde
ShowDataTable
Hämtar eller ställer in ett värde som anger om diagrammet visar en datatabell.
public bool ShowDataTable { get; set; }Egenskapsvärde
ShowLegend
Hämtar eller ställer in ett värde som anger om diagrammets legend kommer att visas. Standard är sant.
public bool ShowLegend { get; set; }Egenskapsvärde
SideWall
Returnerar ett Aspose.Cells.Charts.Chart.Walls-objekt som representerar sidoväggen i ett 3-D-diagram.
public Walls SideWall { get; }Egenskapsvärde
SizeWithWindow
Sant om Microsoft Excel ändrar storlek på diagrammet för att matcha storleken på diagrambladfönstret.
public bool SizeWithWindow { get; set; }Egenskapsvärde
Style
Hämtar och ställer in den inbyggda stilen.
public int Style { get; set; }Egenskapsvärde
Anmärkningar
Det bör vara mellan 1 och 48.
Returnera -1 om det inte har ställts in.
SubTitle
Hämtar diagrammets undertitel.
Endast för ODS-formatfil.
public Title SubTitle { get; }Egenskapsvärde
Title
Hämtar diagrammets titel.
public Title Title { get; }Egenskapsvärde
Type
Hämtar eller ställer in diagrammets typ.
public ChartType Type { get; set; }Egenskapsvärde
ValueAxis
Hämtar diagrammets Y-axel.
public Axis ValueAxis { get; }Egenskapsvärde
Walls
Returnerar ett Aspose.Cells.Charts.Chart.Walls-objekt som representerar väggarna i ett 3-D-diagram.
public Walls Walls { get; }Egenskapsvärde
Anmärkningar
Denna egenskap gäller inte för 3-D-tårtdiagram.
WallsAndGridlines2D
Sant om rutnätslinjer dras tvådimensionellt på ett 3-D-diagram.
public bool WallsAndGridlines2D { get; set; }Egenskapsvärde
Worksheet
Hämtar kalkylbladet som innehåller detta diagram.
public Worksheet Worksheet { get; }Egenskapsvärde
Metoder
Calculate()
Beräknar den anpassade positionen för plotområdet, axlar om deras position är automatiskt tilldelad.
public void Calculate()Calculate(ChartCalculateOptions)
Beräknar den anpassade positionen för plotområdet, axlar om deras position är automatiskt tilldelad, med diagramberäkningsalternativ.
public void Calculate(ChartCalculateOptions calculateOptions)Parametrar
calculateOptions ChartCalculateOptions
ChangeTemplate(byte[])
Ändrar diagramtyp med förinställd mall.
public void ChangeTemplate(byte[] data)Parametrar
data byte[]
Datan för diagrammallfilen (.crtx).
GetActualSize()
Hämtar den faktiska storleken på diagrammet i enhet av pixlar.
public int[] GetActualSize()Returnerar
int[]
Faktisk storlek i en array (bredd och höjd).
[0] är bredd; [1] är höjd.
GetChartDataRange()
Hämtar datakällområdet för diagrammet.
public string GetChartDataRange()Returnerar
Datakällan.
Anmärkningar
Stöder endast område.
HasAxis(AxisType, bool)
Returnerar vilka axlar som finns på diagrammet.
public bool HasAxis(AxisType aixsType, bool isPrimary)Parametrar
aixsType AxisType
isPrimary bool
Returnerar
Anmärkningar
Normalt har Pie, PieExploded, PiePie, PieBar, Pie3D, Pie3DExploded, Doughnut, DoughnutExploded ingen axel.
IsCellReferedByChart(int, int, int)
Returnerar om cellen refereras av diagrammet.
public bool IsCellReferedByChart(int sheetIndex, int rowIndex, int columnIndex)Parametrar
sheetIndex int
Index för kalkylbladet. -1 betyder kalkylbladet som innehåller det aktuella diagrammet.
rowIndex int
Radindex
columnIndex int
Kolumnindex
Returnerar
IsChartDataChanged()
Detekterar om datakällan för diagrammet har ändrats.
public bool IsChartDataChanged()Returnerar
Returnerar sant om diagrammet har ändrats, annars returnerar falskt.
Anmärkningar
Metoden detekterar ändringar i diagrammets datakälla innan diagrammet renderas till bildformat.
Vid första anropet av Chart.toImage kommer diagrammets källdata (t.ex. XValuesParseData, ValuesParseData) att registreras.
Innan du anropar metoden Chart.toImage igen, anropa metoden IsChartDataChanged för att kontrollera om diagrammet behöver renderas om.
Move(int, int, int, int)
Flyttar diagrammet till en angiven plats.
public void Move(int upperLeftRow, int upperLeftColumn, int lowerRightRow, int lowerRightColumn)Parametrar
upperLeftRow int
Övre vänstra radindex.
upperLeftColumn int
Övre vänstra kolumnindex.
lowerRightRow int
Nedre högra radindex
lowerRightColumn int
Nedre högra kolumnindex
RefreshPivotData()
Uppdaterar diagrammets data från pivottabellen.
public void RefreshPivotData()Anmärkningar
Vi kommer att samla data från pivottabellens datakälla till pivottabellsrapporten.
Denna metod används endast för att samla all data till ett pivottiagram.
SetChartDataRange(string, bool)
Specificerar datarange för ett diagram.
public void SetChartDataRange(string area, bool isVertical)Parametrar
area string
Specificerar värdena från vilka dataserierna ska plottas.
isVertical bool
Specificerar om serierna ska plottas från ett område av cellvärden efter rad eller efter kolumn.
SwitchRowColumn()
Byter rad/kolumn.
public bool SwitchRowColumn()Returnerar
Falskt betyder att bytet av rad/kolumn misslyckades.
ToImage(string)
Skapar diagrammet som en bild och sparar det till en fil.
Filnamnets tillägg bestämmer bildformatet.
public void ToImage(string imageFile)Parametrar
imageFile string
Filnamnet för bilden med fullständig sökväg.
Anmärkningar
Bildformatet specificeras genom att använda tillägget för filnamnet. Till exempel, om du specificerar "myfile.png", kommer bilden att sparas i PNG-format. Följande filändelser erkänns: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
Om bredden eller höjden är noll eller diagrammet inte stöds enligt listan över stödda diagram, kommer denna metod inte att göra något.ToImage(string, ImageType)
Skapar diagrammet som en bild och sparar det till en fil i den angivna bildtypen.
public void ToImage(string imageFile, ImageType imageType)Parametrar
imageFile string
Filnamnet för bilden med fullständig sökväg.
imageType ImageType
Den bildtyp i vilken bilden ska sparas.
Anmärkningar
Bildtypen specificeras genom att använda `imageType`. Följande typer stöds: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Om bredden eller höjden är noll eller diagrammet inte stöds enligt listan över stödda diagram, kommer denna metod inte att göra något.ToImage(string, long)
Skapar diagrammet som en bild och sparar det till en fil i Jpeg-format.
public void ToImage(string imageFile, long jpegQuality)Parametrar
imageFile string
Filnamnet för bilden med fullständig sökväg.
jpegQuality long
Jpeg-kvalitet.
Anmärkningar
Om bredden eller höjden är noll eller diagrammet inte stöds enligt listan över stödda diagram, kommer denna metod inte att göra något.
ToImage(Stream, long)
Skapar diagrammet som en bild och sparar det till en ström i Jpeg-format.
public void ToImage(Stream stream, long jpegQuality)Parametrar
stream Stream
Utdataströmmen.
jpegQuality long
Jpeg-kvalitet.
Anmärkningar
Om bredden eller höjden är noll eller diagrammet inte stöds enligt listan över stödda diagram, kommer denna metod inte att göra något.
ToImage(Stream, ImageType)
Skapar diagrammet som en bild och sparar det till en ström i det angivna formatet.
public void ToImage(Stream stream, ImageType imageType)Parametrar
stream Stream
Utdataströmmen.
imageType ImageType
Den bildtyp i vilken bilden ska sparas.
Anmärkningar
Bildtypen specificeras genom att använda `imageType`. Följande typer stöds: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Om bredden eller höjden är noll eller diagrammet inte stöds enligt listan över stödda diagram, kommer denna metod inte att göra något.ToImage(string, ImageOrPrintOptions)
Skapar diagrammet som en bild och sparar det till en fil.
Filnamnets tillägg bestämmer bildformatet.
public void ToImage(string imageFile, ImageOrPrintOptions options)Parametrar
imageFile string
Filnamnet för bilden med fullständig sökväg.
options ImageOrPrintOptions
Ytterligare alternativ för bildskapande.
Exempel
Sparar till Tiff med 300 dpi och CCITT4-kompression.
ImageOrPrintOptions options = new ImageOrPrintOptions();
options.HorizontalResolution = 300;
options.VerticalResolution = 300;
options.TiffCompression = TiffCompression.CompressionCCITT4;
Workbook book = new Workbook(@"test.xls");
book.Worksheets[0].Charts[0].ToImage(@"chart.Tiff", options);
[VB]
Dim options As ImageOrPrintOptions = New ImageOrPrintOptions()
options.HorizontalResolution = 300
options.VerticalResolution = 300
options.TiffCompression = TiffCompression.CompressionCCITT4
Dim book As Workbook = New Workbook("test.xls")
book.Worksheets(0).Charts(0).ToImage("chart.Tiff", options)Sparar till Jpeg med 300 dpi och 80 bildkvalitet.
ImageOrPrintOptions options = new ImageOrPrintOptions();
options.HorizontalResolution = 300;
options.VerticalResolution = 300;
options.Quality = 80;
Workbook book = new Workbook(@"test.xls");
book.Worksheets[0].Charts[0].ToImage(@"chart.Jpeg", options);
[VB]
Dim options As ImageOrPrintOptions = New ImageOrPrintOptions()
options.HorizontalResolution = 300
options.VerticalResolution = 300
options.Quality = 80
Dim book As Workbook = New Workbook("test.xls")
book.Worksheets(0).Charts(0).ToImage("chart.Jpeg", options)Anmärkningar
Bildformatet specificeras genom att använda tillägget för filnamnet. Till exempel, om du specificerar "myfile.png", kommer bilden att sparas i PNG-format. Följande filändelser erkänns: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
Om bredden eller höjden är noll eller diagrammet inte stöds enligt listan över stödda diagram, kommer denna metod inte att göra något. Vänligen se Listan över stödda diagram för mer information.ToImage(Stream, ImageOrPrintOptions)
Skapar diagrammet som en bild och sparar det till en ström i det angivna formatet.
public void ToImage(Stream stream, ImageOrPrintOptions options)Parametrar
stream Stream
Utdataströmmen.
options ImageOrPrintOptions
Ytterligare alternativ för bildskapande.
Anmärkningar
Bildtypen specificeras genom att använda `options.ImageType`. Följande format stöds: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Om bredden eller höjden är noll eller diagrammet inte stöds enligt listan över stödda diagram, kommer denna metod inte att göra något. Vänligen se Listan över stödda diagram för mer information.ToPdf(string)
Sparar diagrammet till en pdf-fil.
public void ToPdf(string fileName)Parametrar
fileName string
pdf-filnamnet med fullständig sökväg.
ToPdf(string, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)
Sparar diagrammet till en pdf-fil.
public void ToPdf(string fileName, float desiredPageWidth, float desiredPageHeight, PageLayoutAlignmentType hAlignmentType, PageLayoutAlignmentType vAlignmentType)Parametrar
fileName string
pdf-filnamnet med fullständig sökväg.
desiredPageWidth float
Den önskade sidbredden i tum.
desiredPageHeight float
Den önskade sidahöjden i tum.
hAlignmentType PageLayoutAlignmentType
Diagrammets horisontella justeringstyp i utdata.
vAlignmentType PageLayoutAlignmentType
Diagrammets vertikala justeringstyp i utdata.
ToPdf(Stream)
Skapar diagrammet som pdf och sparar det till en ström.
public void ToPdf(Stream stream)Parametrar
stream Stream
Utdataströmmen.
ToPdf(Stream, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)
Skapar diagrammet som pdf och sparar det till en ström.
public void ToPdf(Stream stream, float desiredPageWidth, float desiredPageHeight, PageLayoutAlignmentType hAlignmentType, PageLayoutAlignmentType vAlignmentType)Parametrar
stream Stream
Utdataströmmen.
desiredPageWidth float
Den önskade sidbredden i tum.
desiredPageHeight float
Den önskade sidahöjden i tum.
hAlignmentType PageLayoutAlignmentType
Diagrammets horisontella justeringstyp i utdata.
vAlignmentType PageLayoutAlignmentType
Diagrammets vertikala justeringstyp i utdata.
