Class Series
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Zahrnuje objekt, který představuje jednotlivou datovou řadu v grafu.
public class Series
Dědičnost
Děděné členy
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Příklady
//Instanciace objektu Workbook
Workbook workbook = new Workbook();
//Přidání nového listu do Excel objektu
int sheetIndex = workbook.Worksheets.Add();
//Získání reference na nově přidaný list předáním jeho indexu
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Přidání ukázkové hodnoty do buňky "A1"
worksheet.Cells["A1"].PutValue(50);
//Přidání ukázkové hodnoty do buňky "A2"
worksheet.Cells["A2"].PutValue(100);
//Přidání ukázkové hodnoty do buňky "A3"
worksheet.Cells["A3"].PutValue(150);
//Přidání ukázkové hodnoty do buňky "A4"
worksheet.Cells["A4"].PutValue(200);
//Přidání ukázkové hodnoty do buňky "B1"
worksheet.Cells["B1"].PutValue(60);
//Přidání ukázkové hodnoty do buňky "B2"
worksheet.Cells["B2"].PutValue(32);
//Přidání ukázkové hodnoty do buňky "B3"
worksheet.Cells["B3"].PutValue(50);
//Přidání ukázkové hodnoty do buňky "B4"
worksheet.Cells["B4"].PutValue(40);
//Přidání ukázkové hodnoty do buňky "C1" jako kategorie
worksheet.Cells["C1"].PutValue("Q1");
//Přidání ukázkové hodnoty do buňky "C2" jako kategorie
worksheet.Cells["C2"].PutValue("Q2");
//Přidání ukázkové hodnoty do buňky "C3" jako kategorie
worksheet.Cells["C3"].PutValue("Y1");
//Přidání ukázkové hodnoty do buňky "C4" jako kategorie
worksheet.Cells["C4"].PutValue("Y2");
//Přidání grafu do listu
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Přístup k instanci nově přidaného grafu
Chart chart = worksheet.Charts[chartIndex];
//Přidání NSeries (datový zdroj grafu) do grafu od buňky "A1" do "B4"
int seriesIndex = chart.NSeries.Add("A1:B4", true);
//Nastavení datového zdroje pro kategorie NSeries
chart.NSeries.CategoryData = "C1:C4";
Series series = chart.NSeries[seriesIndex];
//Nastavení hodnot série.
series.Values = "=B1:B4";
//Změna typu grafu série.
series.Type = ChartType.Line;
//Nastavení vlastností markeru.
series.Marker.MarkerStyle = ChartMarkerType.Circle;
series.Marker.ForegroundColorSetType = FormattingType.Automatic;
series.Marker.ForegroundColor = System.Drawing.Color.Black;
series.Marker.BackgroundColorSetType = FormattingType.Automatic;
//proveďte svou práci
//Uložení Excel souboru
workbook.Save("book1.xls");
'Instanciace objektu Workbook
Dim workbook As Workbook = New Workbook()
'Přidání nového listu do Excel objektu
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Získání reference na nově přidaný list předáním jeho indexu
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Přidání ukázkové hodnoty do buňky "A1"
worksheet.Cells("A1").PutValue(50)
'Přidání ukázkové hodnoty do buňky "A2"
worksheet.Cells("A2").PutValue(100)
'Přidání ukázkové hodnoty do buňky "A3"
worksheet.Cells("A3").PutValue(150)
'Přidání ukázkové hodnoty do buňky "A4"
worksheet.Cells("A4").PutValue(200)
'Přidání ukázkové hodnoty do buňky "B1"
worksheet.Cells("B1").PutValue(60)
'Přidání ukázkové hodnoty do buňky "B2"
worksheet.Cells("B2").PutValue(32)
'Přidání ukázkové hodnoty do buňky "B3"
worksheet.Cells("B3").PutValue(50)
'Přidání ukázkové hodnoty do buňky "B4"
worksheet.Cells("B4").PutValue(40)
'Přidání ukázkové hodnoty do buňky "C1" jako kategorie
worksheet.Cells("C1").PutValue("Q1")
'Přidání ukázkové hodnoty do buňky "C2" jako kategorie
worksheet.Cells("C2").PutValue("Q2")
'Přidání ukázkové hodnoty do buňky "C3" jako kategorie
worksheet.Cells("C3").PutValue("Y1")
'Přidání ukázkové hodnoty do buňky "C4" jako kategorie
worksheet.Cells("C4").PutValue("Y2")
'Přidání grafu do listu
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Přístup k instanci nově přidaného grafu
Dim chart As Chart = worksheet.Charts(chartIndex)
'Přidání NSeries (datový zdroj grafu) do grafu od buňky "A1" do "B4"
Dim seriesIndex As Int32 = chart.NSeries.Add("A1:B4", True)
'Nastavení datového zdroje pro kategorie NSeries
chart.NSeries.CategoryData = "C1:C4"
Dim series As Series = chart.NSeries(seriesIndex)
'Nastavení hodnot série.
series.Values = "=B1:B4"
'Změna typu grafu série.
series.Type = ChartType.Line
'Nastavení vlastností markeru.
series.Marker.MarkerStyle = ChartMarkerType.Circle
series.Marker.ForegroundColorSetType = FormattingType.Automatic
series.Marker.ForegroundColor = System.Drawing.Color.Black
series.Marker.BackgroundColorSetType = FormattingType.Automatic
'Uložení Excel souboru
workbook.Save("book1.xls")
Vlastnosti
Area
Představuje pozadí objektu Series.
public Area Area { get; }
Hodnota vlastnosti
Bar3DShapeType
Získá nebo nastaví typ 3D tvaru používaného s 3-D sloupcovým nebo sloupcovým grafem.
public Bar3DShapeType Bar3DShapeType { get; set; }
Hodnota vlastnosti
Border
Představuje okraj objektu Series.
public Line Border { get; }
Hodnota vlastnosti
BubbleScale
Získá nebo nastaví měřítko pro bubliny ve specifikované skupině grafů. Může to být celé číslo od 0 (nula) do 300, odpovídající procentu výchozí velikosti. Používá se pouze pro bublinové grafy.
public int BubbleScale { get; set; }
Hodnota vlastnosti
BubbleSizes
Získá nebo nastaví hodnoty velikostí bublin grafové série.
public string BubbleSizes { get; set; }
Hodnota vlastnosti
CountOfDataValues
Získá počet datových hodnot.
public int CountOfDataValues { get; }
Hodnota vlastnosti
DataLabels
Představuje objekt DataLabels pro specifikovanou ASeries.
public DataLabels DataLabels { get; }
Hodnota vlastnosti
DisplayName
Získá název série, který se zobrazuje na grafu.
public string DisplayName { get; }
Hodnota vlastnosti
DoughnutHoleSize
Vrátí nebo nastaví velikost otvoru v skupině donutového grafu. Velikost otvoru je vyjádřena jako procento velikosti grafu, mezi 10 a 90 procenty.
public int DoughnutHoleSize { get; set; }
Hodnota vlastnosti
DownBars
Vrátí objekt Aspose.Cells.Charts.DropBars, který představuje dolní pruhy na čárovém grafu. Používá se pouze pro čárové grafy.
public DropBars DownBars { get; }
Hodnota vlastnosti
DropLines
Vrátí objekt Aspose.Cells.Drawing.Line, který představuje drop lines pro sérii na čárovém grafu nebo oblastním grafu. Používá se pouze pro čárové nebo oblastní grafy.
public Line DropLines { get; }
Hodnota vlastnosti
Explosion
Vzdálenost otevřeného plátku z centra koláčového grafu je vyjádřena jako procento průměru koláče.
public int Explosion { get; set; }
Hodnota vlastnosti
FirstSliceAngle
Získá nebo nastaví úhel prvního plátku koláčového nebo donutového grafu, ve stupních (ve směru hodinových ručiček od vertikálního směru). Používá se pouze pro koláčové, 3-D koláčové a donutové grafy, 0 až 360.
public short FirstSliceAngle { get; set; }
Hodnota vlastnosti
GapWidth
Vrátí nebo nastaví prostor mezi skupinami pruhů nebo sloupců, jako procento šířky pruhu nebo sloupce. Hodnota této vlastnosti musí být mezi 0 a 500.
public short GapWidth { get; set; }
Hodnota vlastnosti
Has3DEffect
True, pokud má série třírozměrný vzhled. Používá se pouze pro bublinové grafy.
public bool Has3DEffect { get; set; }
Hodnota vlastnosti
HasDropLines
True, pokud má graf drop lines. Používá se pouze pro čárové nebo oblastní grafy.
public bool HasDropLines { get; set; }
Hodnota vlastnosti
HasHiLoLines
True, pokud má čárový graf vysoké a nízké čáry. Používá se pouze pro čárové grafy.
public bool HasHiLoLines { get; set; }
Hodnota vlastnosti
HasLeaderLines
True, pokud má série vedení.
public bool HasLeaderLines { get; set; }
Hodnota vlastnosti
HasRadarAxisLabels
True, pokud má radarový graf popisky osy kategorií. Používá se pouze pro radarové grafy.
public bool HasRadarAxisLabels { get; set; }
Hodnota vlastnosti
HasSeriesLines
True, pokud má sloupcový nebo pruhový graf sériové čáry nebo pokud má koláčový graf nebo pruhový graf spojovací čáry mezi dvěma sekcemi. Používá se pouze pro sloupcové, pruhové, koláčové nebo pruhové grafy.
public bool HasSeriesLines { get; set; }
Hodnota vlastnosti
HasUpDownBars
True, pokud má čárový graf vzestupné a sestupné pruhy. Používá se pouze pro čárové grafy.
public bool HasUpDownBars { get; set; }
Hodnota vlastnosti
HiLoLines
Vrátí objekt HiLoLines, který představuje vysoké a nízké čáry pro sérii na čárovém grafu. Používá se pouze pro čárové grafy.
public Line HiLoLines { get; }
Hodnota vlastnosti
IsAutoSplit
Indikuje, zda je prahová hodnota automatická.
public bool IsAutoSplit { get; }
Hodnota vlastnosti
IsColorVaried
Představuje, zda se barva bodů liší. Graf musí obsahovat pouze jednu sérii.
public bool IsColorVaried { get; set; }
Hodnota vlastnosti
IsFiltered
Indikuje, zda je série vybrána nebo filtrována. True znamená, že tato série je filtrována a nebude zobrazena na grafu.
public bool IsFiltered { get; set; }
Hodnota vlastnosti
IsVerticalValues
Indikuje, zda je datový zdroj vertikální.
public bool IsVerticalValues { get; }
Hodnota vlastnosti
LayoutProperties
Představuje vlastnosti rozložení.
public SeriesLayoutProperties LayoutProperties { get; }
Hodnota vlastnosti
LeaderLines
Představuje vedení na grafu. Vedení spojuje popisky dat s datovými body. Tento objekt není kolekcí; neexistuje objekt, který by představoval jednotlivé vedení.
public Line LeaderLines { get; }
Hodnota vlastnosti
LegendEntry
Získá položku legendy podle této série.
public LegendEntry LegendEntry { get; }
Hodnota vlastnosti
Marker
Získá Aspose.Cells.Charts.Series.Marker?text=marker.
public Marker Marker { get; }
Hodnota vlastnosti
Name
Získá nebo nastaví název datové série.
public string Name { get; set; }
Hodnota vlastnosti
Příklady
//Reference name to a cell
chart.NSeries[0].Name = "=A1";
//Set a string to name
chart.NSeries[0].Name = "First Series";
'Reference name to a cell
chart.NSeries[0].Name = "=A1"
'Set a string to name
chart.NSeries[0].Name = "First Series"
Overlap
Specifikuje, jak jsou pruhy a sloupce umístěny. Může to být hodnota mezi – 100 a 100. Používá se pouze pro 2-D pruhové a 2-D sloupcové grafy.
public short Overlap { get; set; }
Hodnota vlastnosti
PlotOnSecondAxis
Indikuje, zda je tato série vykreslena na druhé hodnotové ose.
public bool PlotOnSecondAxis { get; set; }
Hodnota vlastnosti
Points
Získá kolekci bodů v sérii v grafu.
public ChartPointCollection Points { get; }
Hodnota vlastnosti
Poznámky
Když je graf koláčový nebo pruhový, poslední bod je jiný bod v prvním koláči.
SecondPlotSize
Vrátí nebo nastaví velikost sekundární sekce buď koláčového grafu nebo pruhového grafu, jako procento velikosti primárního koláče. Může to být hodnota od 5 do 200.
public short SecondPlotSize { get; set; }
Hodnota vlastnosti
SeriesLines
Vrátí objekt SeriesLines, který představuje sériové čáry pro sloupcový nebo pruhový graf. Používá se pouze pro sloupcové a pruhové grafy.
public Line SeriesLines { get; }
Hodnota vlastnosti
Shadow
True, pokud má série stín.
public bool Shadow { get; set; }
Hodnota vlastnosti
ShapeProperties
Získá objekt Aspose.Cells.Drawing.ShapePropertyCollection, který uchovává vizuální vlastnosti tvaru série.
public ShapePropertyCollection ShapeProperties { get; }
Hodnota vlastnosti
ShowNegativeBubbles
True, pokud jsou negativní bubliny zobrazeny pro skupinu grafů. Platí pouze pro bublinové grafy.
public bool ShowNegativeBubbles { get; set; }
Hodnota vlastnosti
SizeRepresents
Získá nebo nastaví, co velikost bubliny představuje na bublinovém grafu.
public BubbleSizeRepresents SizeRepresents { get; set; }
Hodnota vlastnosti
Poznámky
BubbleSizeRepresents.SizeIsArea znamená, že hodnota Aspose.Cells.Charts.Series.BubbleSizes je plocha bubliny. BubbleSizeRepresents.SizeIsWidth znamená, že hodnota Aspose.Cells.Charts.Series.BubbleSizes je šířka bubliny.
Smooth
Představuje hladkost křivky. True, pokud je hladkost křivky zapnuta pro čárový graf nebo graf rozptýlení. Používá se pouze pro čárové a rozptýlené grafy připojené čarami.
public bool Smooth { get; set; }
Hodnota vlastnosti
SplitType
Vrátí nebo nastaví hodnotu, jak určit, které datové body jsou ve druhém koláči nebo pruhu na koláčovém nebo pruhovém grafu.
public ChartSplitType SplitType { get; set; }
Hodnota vlastnosti
SplitValue
Vrátí nebo nastaví hodnotu, která se má použít k určení, které datové body jsou ve druhém koláči nebo pruhu na koláčovém nebo pruhovém grafu.
public double SplitValue { get; set; }
Hodnota vlastnosti
TrendLines
Vrátí všechny trendové čáry této série.
public TrendlineCollection TrendLines { get; }
Hodnota vlastnosti
Type
Získá nebo nastaví typ datové série.
public ChartType Type { get; set; }
Hodnota vlastnosti
UpBars
Vrátí objekt DropBars, který představuje vzestupné pruhy na čárovém grafu. Používá se pouze pro čárové grafy.
public DropBars UpBars { get; }
Hodnota vlastnosti
Values
Představuje Y hodnoty této grafové série.
public string Values { get; set; }
Hodnota vlastnosti
ValuesFormatCode
Představuje formátovací kód číselního seznamu hodnot.
public string ValuesFormatCode { get; set; }
Hodnota vlastnosti
XErrorBar
Představuje chybovou čáru v X směru série.
public ErrorBar XErrorBar { get; }
Hodnota vlastnosti
XValues
Představuje X hodnoty grafové série.
public string XValues { get; set; }
Hodnota vlastnosti
XValuesFormatCode
Představuje formátovací kód číselního seznamu X hodnot.
public string XValuesFormatCode { get; set; }
Hodnota vlastnosti
YErrorBar
Představuje chybovou čáru v Y směru série.
public ErrorBar YErrorBar { get; }
Hodnota vlastnosti
Metody
Move(int)
Posune sérii nahoru nebo dolů.
public void Move(int count)
Parametry
count
int
Počet posunutí nahoru nebo dolů. Posuňte sérii nahoru, pokud je toto menší než nula; Posuňte sérii dolů, pokud je toto větší než nula.