Class SeriesCollection
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Zahrnuje kolekci objektů Aspose.Cells.Charts.Series.
public class SeriesCollection : CollectionBase<series>, IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerable
Dědění
object ← CollectionBase<series> ← SeriesCollection
Implementuje
IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerable
Děděné členy
CollectionBase<series>.BinarySearch(Series), CollectionBase<series>.BinarySearch(Series, IComparer<series>), CollectionBase<series>.BinarySearch(int, int, Series, IComparer<series>), CollectionBase<series>.Contains(Series), CollectionBase<series>.CopyTo(Series[]), CollectionBase<series>.CopyTo(Series[], int), CollectionBase<series>.CopyTo(int, Series[], int, int), CollectionBase<series>.Exists(Predicate<series>), CollectionBase<series>.Find(Predicate<series>), CollectionBase<series>.FindAll(Predicate<series>), CollectionBase<series>.FindIndex(Predicate<series>), CollectionBase<series>.FindIndex(int, Predicate<series>), CollectionBase<series>.FindIndex(int, int, Predicate<series>), CollectionBase<series>.FindLast(Predicate<series>), CollectionBase<series>.FindLastIndex(Predicate<series>), CollectionBase<series>.FindLastIndex(int, Predicate<series>), CollectionBase<series>.FindLastIndex(int, int, Predicate<series>), CollectionBase<series>.IndexOf(Series), CollectionBase<series>.IndexOf(Series, int), CollectionBase<series>.IndexOf(Series, int, int), CollectionBase<series>.LastIndexOf(Series), CollectionBase<series>.LastIndexOf(Series, int), CollectionBase<series>.LastIndexOf(Series, int, int), CollectionBase<series>.GetEnumerator(), CollectionBase<series>.Clear(), CollectionBase<series>.RemoveAt(int), CollectionBase<series>.OnClearComplete(), CollectionBase<series>.OnClear(), CollectionBase<series>.Capacity, CollectionBase<series>.Count, CollectionBase<series>.InnerList, CollectionBase<series>.this[int], 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 objektu Excel
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í vzorové hodnoty do buňky "A1"
worksheet.Cells["A1"].PutValue(50);
//Přidání vzorové hodnoty do buňky "A2"
worksheet.Cells["A2"].PutValue(100);
//Přidání vzorové hodnoty do buňky "A3"
worksheet.Cells["A3"].PutValue(150);
//Přidání vzorové hodnoty do buňky "A4"
worksheet.Cells["A4"].PutValue(200);
//Přidání vzorové hodnoty do buňky "B1"
worksheet.Cells["B1"].PutValue(60);
//Přidání vzorové hodnoty do buňky "B2"
worksheet.Cells["B2"].PutValue(32);
//Přidání vzorové hodnoty do buňky "B3"
worksheet.Cells["B3"].PutValue(50);
//Přidání vzorové hodnoty do buňky "B4"
worksheet.Cells["B4"].PutValue(40);
//Přidání vzorové hodnoty do buňky "C1" jako kategorie dat
worksheet.Cells["C1"].PutValue("Q1");
//Přidání vzorové hodnoty do buňky "C2" jako kategorie dat
worksheet.Cells["C2"].PutValue("Q2");
//Přidání vzorové hodnoty do buňky "C3" jako kategorie dat
worksheet.Cells["C3"].PutValue("Y1");
//Přidání vzorové hodnoty do buňky "C4" jako kategorie dat
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"
chart.NSeries.Add("A1:B4", true);
//Nastavení datového zdroje pro kategorie dat NSeries
chart.NSeries.CategoryData = "C1:C4";
//Uložení Excel souboru
workbook.Save("book1.xls");
'Instanciace objektu Workbook
Dim workbook As Workbook = New Workbook()
'Přidání nového listu do objektu Excel
Dim sheetIndex As Integer = 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í vzorové hodnoty do buňky "A1"
worksheet.Cells("A1").PutValue(50)
'Přidání vzorové hodnoty do buňky "A2"
worksheet.Cells("A2").PutValue(100)
'Přidání vzorové hodnoty do buňky "A3"
worksheet.Cells("A3").PutValue(150)
'Přidání vzorové hodnoty do buňky "A4"
worksheet.Cells("A4").PutValue(200)
'Přidání vzorové hodnoty do buňky "B1"
worksheet.Cells("B1").PutValue(60)
'Přidání vzorové hodnoty do buňky "B2"
worksheet.Cells("B2").PutValue(32)
'Přidání vzorové hodnoty do buňky "B3"
worksheet.Cells("B3").PutValue(50)
'Přidání vzorové hodnoty do buňky "B4"
worksheet.Cells("B4").PutValue(40)
'Přidání vzorové hodnoty do buňky "C1" jako kategorie dat
worksheet.Cells("C1").PutValue("Q1")
'Přidání vzorové hodnoty do buňky "C2" jako kategorie dat
worksheet.Cells("C2").PutValue("Q2")
'Přidání vzorové hodnoty do buňky "C3" jako kategorie dat
worksheet.Cells("C3").PutValue("Y1")
'Přidání vzorové hodnoty do buňky "C4" jako kategorie dat
worksheet.Cells("C4").PutValue("Y2")
'Přidání grafu do listu
Dim chartIndex As Integer = 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"
chart.NSeries.Add("A1:B4", True)
'Nastavení datového zdroje pro kategorie dat NSeries
chart.NSeries.CategoryData = "C1:C4"
'Uložení Excel souboru
workbook.Save("book1.xls")
Vlastnosti
CategoryData
Získá nebo nastaví rozsah hodnot osy kategorie. Může to být rozsah buněk (např. “d1:e10”), nebo sekvence hodnot (např. “{2,6,8,10}”).
public string CategoryData { get; set; }
Hodnota vlastnosti
IsColorVaried
Označuje, zda je barva bodů různá.
public bool IsColorVaried { get; set; }
Hodnota vlastnosti
SecondCategoryData
Získá nebo nastaví rozsah hodnot druhé osy kategorie. Může to být rozsah buněk (např. “d1:e10”), nebo sekvence hodnot (např. “{2,6,8,10}”). Pouze ovlivňuje, když některé ASeries jsou vykresleny na druhé ose.
public string SecondCategoryData { get; set; }
Hodnota vlastnosti
this[int]
Získá prvek Aspose.Cells.Charts.Series na specifikovaném indexu.
public Series this[int index] { get; }
Hodnota vlastnosti
Metody
Add(string, bool)
Přidá kolekci Aspose.Cells.Charts.Series do grafu.
public int Add(string area, bool isVertical)
Parametry
area
string
Specifikuje hodnoty, ze kterých se vykreslí datová série
isVertical
bool
Specifikuje, zda se má série vykreslit z rozsahu hodnot buněk po řádcích nebo po sloupcích.
Návratová hodnota
Vrátí první index přidané ASeries v NSeries.
Poznámky
Pokud nastavíte data na sousedních buňkách, použijte dvojtečku k oddělení. Například, $C$2:$C$5.
Pokud nastavíte data na nesousedních buňkách, použijte čárku k oddělení. Například: ($C$2,$D$5).
Add(string, bool, bool)
Přidá kolekci Aspose.Cells.Charts.Series do grafu.
public int Add(string area, bool isVertical, bool checkLabels)
Parametry
area
string
Specifikuje hodnoty, ze kterých se vykreslí datová série
isVertical
bool
Specifikuje, zda se má série vykreslit z rozsahu hodnot buněk po řádcích nebo po sloupcích.
checkLabels
bool
Indikuje, zda rozsah obsahuje názvy sérií
Návratová hodnota
Vrátí první index přidané ASeries v NSeries.
Poznámky
Pokud nastavíte data na sousedních buňkách, použijte dvojtečku k oddělení. Například, $C$2:$C$5.
Pokud nastavíte data na nesousedních buňkách, použijte čárku k oddělení. Například: ($C$2,$D$5).
AddR1C1(string, bool)
Přidá kolekci Aspose.Cells.Charts.Series do grafu.
public int AddR1C1(string area, bool isVertical)
Parametry
area
string
Specifikuje hodnoty, ze kterých se vykreslí datová série
isVertical
bool
Specifikuje, zda se má série vykreslit z rozsahu hodnot buněk po řádcích nebo po sloupcích.
Návratová hodnota
Vrátí první index přidané ASeries v NSeries.
Poznámky
Pokud nastavíte data na sousedních buňkách, použijte dvojtečku k oddělení. Například, R[1]C[1]:R[3]C[2].
Pokud nastavíte data na nesousedních buňkách, použijte čárku k oddělení. Například: (R[1]C[1],R[3]C[2]).
Clear()
Vyčistí kolekci.
public void Clear()
GetSeriesByOrder(int)
Získá prvek Aspose.Cells.Charts.Series podle pořadí.
public Series GetSeriesByOrder(int order)
Parametry
order
int
Pořadí série.
Návratová hodnota
Prvek série.
RemoveAt(int)
Odstraní sérii na specifikovaném indexu.
public void RemoveAt(int index)
Parametry
index
int
Index.
SetSeriesNames(int, string, bool)
Nastaví název všech sérií v grafu.
public void SetSeriesNames(int startIndex, string area, bool isVertical)
Parametry
startIndex
int
Index první série, které chcete nastavit název.
area
string
Specifikuje oblast pro název série.
isVertical
bool
Specifikuje, zda se má série vykreslit z rozsahu hodnot buněk po řádcích nebo po sloupcích.
Poznámky
Pokud je počáteční index větší než počet sérií, vrátí a nic neudělá.
Pokud nastavíte data na sousedních buňkách, použijte dvojtečku k oddělení. Například, $C$2:$C$5.
Pokud nastavíte data na nesousedních buňkách, použijte čárku k oddělení. Například: ($C$2,$D$5).
SwapSeries(int, int)
Přímo změní pořadí dvou sérií.
public void SwapSeries(int sourceIndex, int destIndex)
Parametry
sourceIndex
int
Aktuální index.
destIndex
int
Cílový index.