Anpassa diagram

Skapa diagram

Det är möjligt att lägga till en mängd olika diagram till kalkylblad med Aspose.Cells. Aspose.Cells tillhandahåller många flexibla diagramobjekt. Det här ämnet diskuterar Aspose.Cells' diagramobjekt.

Skapa helt enkelt ett diagram

Det är enkelt att skapa ett diagram med Aspose.Cells med följande exempelkoder:

Saker att veta för att skapa ett diagram

Innan du skapar diagram är det viktigt att förstå några grundläggande begrepp som är användbara när du skapar diagram med Aspose.Cells.

Kartlägga objekt

Aspose.Cells tillhandahåller en speciell uppsättning klasser som används för att skapa alla typer av diagram. Dessa klasser används för att skapa kartläggningsobjekt*, som fungerar som diagrammets byggstenar. Kartobjekten listas nedan:

• Axel, ett diagrams axel.
• Diagram, ett enda Excel-diagram.
• ChartArea, diagramområdet i kalkylbladet.
• ChartDataTable, en diagramdatatabell.
• ChartFrame, ramobjektet i ett diagram.
• ChartPoint, en enda punkt i en serie i ett diagram.
• ChartPointCollection, en samling som innehåller alla punkter i en serie.
• ChartCollection , en samling avDiagramföremål.
• DataLabels, DataLabels för den angivnaSerier, ChartPoint, Trendlinje, etc.
• FillFormat, fyllningsformat för en form.
• Golv, golvet i ett 3D-diagram.
• Legend, sjökortsförklaringen.
• Linje, diagramlinjen.
• Seriekollektion , en samling avSerierföremål.
• Serier, representerar en enskild dataserie i ett diagram.
• TickLabelsbockmarkeringsetiketterna som är associerade med bockmarkeringar på en diagramaxel.
• Titel, titeln på ett diagram eller en axel.
• Trendlinje, en trendlinje i ett diagram.
• TrendlineCollection, en samling av alla Trendline-objekt för den angivna dataserien.
• Väggar, väggarna i ett 3D-diagram.

Använda diagramobjekt

Som nämnts ovan är alla diagramobjekt instanser av sina respektive klasser och tillhandahåller specifika egenskaper och metoder för att utföra specifika uppgifter. Använd diagramobjekt för att skapa diagram.

Lägg till vilken typ av diagram som helst i ett kalkylblad med hjälp avChartCollection samling. Varje objekt iChartCollection samlingen representerar enDiagram objekt. ADiagramobjekt kapslar in alla diagramobjekt som krävs för att anpassa diagrammets utseende. Nästa avsnitt visar hur du använder några grundläggande diagramobjekt för att skapa ett enkelt diagram.

Skapa ett enkelt diagram

Det är möjligt att skapa många olika typer av sjökort med Aspose.Cells. Alla standarddiagram som stöds av Aspose.Cells är fördefinierade i en uppräkning med namnetChartType. De fördefinierade diagramtyperna är:

Diagramtyper	Beskrivning
Kolumn	Representerar det klustrade kolumndiagrammet
KolumnStackad	Representerar staplade kolumndiagram
Kolumn100ProcentStackad	Representerar 100 % staplat kolumndiagram
Kolumn3DClustrerad	Representerar 3D-klustrade kolumndiagram
Kolumn3DStackad	Representerar 3D staplade kolumndiagram
Kolumn3D100PercentStacked	Representerar 3D 100 % staplade kolumndiagram
Kolumn 3D	Representerar 3D-kolumndiagram
Bar	Representerar klustrade stapeldiagram
BarStacked	Representerar staplade stapeldiagram
Bar100PercentStacked	Representerar 100 % staplat stapeldiagram
Bar3DClustered	Representerar 3D-klustrade stapeldiagram
Bar3DStacked	Representerar 3D staplade stapeldiagram
Bar3D100PercentStacked	Representerar 3D 100 % staplat stapeldiagram
Linje	Representerar linjediagram
LineStacked	Representerar staplade linjediagram
Line100PercentStacked	Representerar 100 % staplade linjediagram
LineWithDataMarkers	Representerar linjediagram med datamarkörer
LineStackedWithDataMarkers	Representerar staplade linjediagram med datamarkörer
Line100PercentStackedWithDataMarkers	Representerar 100 % staplade linjediagram med datamarkörer
Line3D	Representerar 3D-linjediagram
Paj	Representerar cirkeldiagram
Pie3D	Representerar 3D-cirkeldiagram
PiePie	Representerar cirkeldiagram
PieExploderade	Representerar exploderat cirkeldiagram
Pie3DE exploderade	Representerar 3D-exploderat cirkeldiagram
PieBar	Representerar Bar of Pie Chart
Sprida ut	Representerar spridningsdiagrammet
ScatterConnectedByCurvesWithDataMarker	Representerar spridningsdiagrammet kopplat av kurvor, med datamarkörer
ScatterConnectedByCurvesWithoutDataMarker	Representerar spridningsdiagrammet kopplat med kurvor, utan datamarkörer
ScatterConnectedByLinesWithDataMarker	Representerar spridningsdiagrammet kopplat med linjer, med datamarkörer
ScatterConnectedByLinesWithoutDataMarker	Representerar spridningsdiagrammet kopplat med linjer, utan datamarkörer
Område	Representerar områdesdiagram
AreaStacked	Representerar staplade ytdiagram
Area100PercentStacked	Representerar 100 % staplade ytdiagram
Area3D	Representerar 3D-områdesdiagram
Area3DStacked	Representerar 3D Stacked Area Chart
Area3D100PercentStacked	Representerar 3D 100 % staplade ytdiagram
Munk	Representerar munkdiagram
Doughnut Exploderade	Representerar Exploded Donut Chart
Radar	Representerar radardiagrammet
RadarWithDataMarkers	Representerar radardiagrammet med datamarkörer
Radarfylld	Representerar fyllt radardiagram
Surface3D	Representerar 3D-ytdiagram
SurfaceWireframe3D	Representerar Wireframe 3D-ytdiagrammet
Ytkontur	Representerar konturdiagram
SurfaceContourWireframe	Representerar Wireframe Contour Chart
Bubbla	Representerar bubbeldiagram
Bubble3D	Representerar 3D Bubble Chart
Cylinder	Representerar cylinderdiagram
CylinderStacked	Representerar diagram över staplade cylindrar
Cylinder100PercentStacked	Representerar 100 % staplade cylinderdiagram
Cylindrical Bar	Representerar cylindriskt stapeldiagram.
CylindricalBarStacked	Representerar staplade cylindriska stapeldiagram
CylindricalBar100PercentStacked	Representerar 100 % staplade cylindriska stapeldiagram
CylindricalColumn3D	Representerar 3D Cylindrical Column Chart
Kon	Representerar kondiagram
ConeStacked	Representerar Stacked Cone Chart
Cone100PercentStacked	Representerar 100 % staplade kondiagram
ConicalBar	Representerar koniskt stapeldiagram
ConicalBarStacked	Representerar staplade koniska stapeldiagram
ConicalBar100PercentStacked	Representerar 100 % staplade koniska stapeldiagram
Konisk kolumn3D	Representerar 3D koniskt kolumndiagram
Pyramid	Representerar pyramiddiagram
PyramidStackad	Representerar staplade pyramiddiagram
Pyramid100ProcentStacked	Representerar 100 % staplade pyramiddiagram
PyramidBar	Representerar pyramidstapeldiagrammet
PyramidBarStacked	Representerar staplad pyramidstapeldiagram
PyramidBar100PercentStacked	Representerar 100 % staplad pyramidstapeldiagram
PyramidColumn3D	Representerar 3D Pyramid Column Chart
Så här skapar du ett diagram med Aspose.Cells:

1. Lägg till några data till kalkylbladsceller medCell föremålsatt värdemetod. Detta kommer att användas som datakälla för diagrammet.
2. Lägg till ett diagram i kalkylbladet genom att anropaChartCollection samlingensLägg till metod, inkapslad iArbetsbladobjekt.
3. Ange typen av diagram medChartTypeuppräkning. Till exempel använder exempletChartType.PYRAMIDvärde som diagramtyp.
4. Få tillgång till det nyaDiagram objekt frånChartCollectionsamling genom att passera dess index.
5. Använd något av kartobjekten som är inkapslade iDiagramobjekt för att hantera diagrammet. I exemplet nedan användsSeriekollektiondiagramobjekt för att ange diagrammets datakälla.

När du lägger till källdata till diagrammet kan datakällan vara ett cellintervall (som “A1:C3”) eller en sekvens av icke-sammanhängande celler (som “A1, A3, A5”), eller en sekvens av värden (som “1,2,3”).

När du tilldelar ett cellintervall som en datakälla kan du bara ställa in intervallet från övre vänster till nedre höger. Till exempel är “A1:C3” giltigt medan “C3:A1” är ogiltigt.

Dessa allmänna steg låter dig skapa vilken typ av diagram som helst. Använd olika diagramobjekt för att skapa olika diagram.

När exempelkoden exekveras läggs ett pyramiddiagram till i kalkylbladet som visas nedan.

Pyramiddiagram med dess datakälla

För att skapa ett bubbeldiagram,ChartTypemåste ställas in påChartType.BUBBLEoch några extra egenskaper som BubbleSizes, Values & XValues måste ställas in därefter. När följande kod körs läggs ett bubbeldiagram till i kalkylbladet som visas nedan.

Bubbeldiagram med dess datakälla

Linje med datamarkördiagram

För att skapa en linje med ett datamarkeringsdiagram,ChartTypemåste ställas in påChartType.LINE_WITH_DATA_MARKERS och några extra egenskaper som bakgrundsområde, seriemarkörer , värden & XValues måste ställas in i enlighet därmed. När följande kod körs läggs en rad med ett datamarkeringsdiagram till i kalkylbladet.

Skapa anpassade diagram

Hittills, när vi har diskuterat diagram, har vi tittat på standarddiagram som har sina standardformateringsinställningar. Vi definierar bara datakällan, ställer in några få egenskaper och diagrammet skapas med dess standardformatinställningar. Men Aspose.Cells stöder också att skapa anpassade diagram som gör det möjligt för utvecklare att skapa diagram med sina egna formatinställningar.

Skapa anpassade diagram

Utvecklare kan skapa anpassade diagram vid körning med Aspose.Cells enkel API.

Ett diagram är sammansatt av en dataserie. Varje dataserie i Aspose.Cells representeras av enSerier objekt medanSeriekollektion objekt fungerar som en samling avSerierföremål. När du skapar ett anpassat diagram har utvecklare friheten att använda olika typer av diagram för olika dataserier (samlade i enSeriekollektionobjekt).

För närvarande stöder Aspose.Cells endast anpassade diagram som kombinerar cirkel-, linje-, kolumn- och kolumndiagram men fler diagram kommer att stödjas i framtida utgåvor. För en fullständig lista över standarddiagram som Aspose.Cells stöder, läsDiagramtyper artikel.

Exempelkoden nedan visar hur man skapar anpassade diagram. I det här exemplet kommer vi att använda ett kolumndiagram för den första dataserien och ett linjediagram för den andra serien. Resultatet är att vi lägger till ett kolumndiagram, kombinerat med ett linjediagram, till kalkylbladet.

Anpassat diagram som kombinerar kolumn- och linjediagram

Programmeringsexempel

För att se en lista över diagramtyper som stöds, läsDiagramtyper artikel.