Class Chart
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Mengenkapsulasi objek yang mewakili satu grafik Excel.
public class ChartPewarisan
Anggota yang Dwarisi
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Contoh
Kode berikut menunjukkan cara membuat grafik dengan kode .Net.
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
Cells cells = sheet.Cells;
cells[0,1].PutValue("Pendapatan");
cells[1,0].PutValue("Perusahaan A");
cells[2,0].PutValue("Perusahaan B");
cells[3,0].PutValue("Perusahaan 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 = "Analisis Pendapatan";Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)
Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("Pendapatan")
cells(1,0).PutValue("Perusahaan A")
cells(2,0).PutValue("Perusahaan B")
cells(3,0).PutValue("Perusahaan 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 = "Analisis Pendapatan"Properti
ActualChartSize
Mendapatkan ukuran aktual dari grafik dalam satuan piksel.
[Obsolete("Gunakan metode Chart.GetActualSize() sebagai gantinya.")]
public Size ActualChartSize { get; }Nilai Properti
Catatan
CATATAN: Anggota ini sekarang sudah usang. Sebagai gantinya, silakan gunakan metode Chart.GetActualSize(). Properti ini akan dihapus 12 bulan setelah Juli 2022. Aspose meminta maaf atas ketidaknyamanan yang mungkin Anda alami.
AutoScaling
Benar jika Microsoft Excel mengubah skala grafik 3-D sehingga lebih mendekati ukuran grafik 2-D yang setara. Properti RightAngleAxes harus Benar.
public bool AutoScaling { get; set; }Nilai Properti
BackWall
Mengembalikan objek Aspose.Cells.Charts.Chart.Walls yang mewakili dinding belakang dari grafik 3-D.
public Walls BackWall { get; }Nilai Properti
CategoryAxis
Mendapatkan sumbu X grafik.
public Axis CategoryAxis { get; }Nilai Properti
ChartArea
Mendapatkan area grafik di lembar kerja.
public ChartArea ChartArea { get; }Nilai Properti
ChartDataTable
Mewakili tabel data grafik.
public ChartDataTable ChartDataTable { get; }Nilai Properti
ChartObject
Mewakili ChartShape;
public ChartShape ChartObject { get; }Nilai Properti
DepthPercent
Mewakili kedalaman grafik 3-D sebagai persentase dari lebar grafik (antara 20 dan 2000 persen).
public int DepthPercent { get; set; }Nilai Properti
DisplayNaAsBlank
Menunjukkan apakah menampilkan #N/A sebagai nilai kosong.
public bool DisplayNaAsBlank { get; set; }Nilai Properti
Elevation
Mewakili elevasi tampilan grafik 3-D, dalam derajat.
public int Elevation { get; set; }Nilai Properti
Catatan
Elevasi grafik adalah tinggi di mana Anda melihat grafik, dalam derajat. Nilai default adalah 15 untuk sebagian besar jenis grafik. Nilai dari properti ini harus antara -90 dan 90, kecuali untuk grafik batang 3-D, di mana harus antara 0 dan 44.
FilteredNSeries
Mendapatkan koleksi Aspose.Cells.Charts.SeriesCollection yang mewakili seri data yang difilter dalam grafik.
public SeriesCollection FilteredNSeries { get; }Nilai Properti
FirstSliceAngle
Mendapatkan atau mengatur sudut dari irisan pertama grafik pie atau grafik donat, dalam derajat (searah jarum jam dari vertikal). Berlaku hanya untuk grafik pie, pie 3-D, dan grafik donat, 0 hingga 360.
public int FirstSliceAngle { get; set; }Nilai Properti
Floor
Mengembalikan objek Aspose.Cells.Charts.Chart.Floor yang mewakili dinding dari grafik 3-D.
public Floor Floor { get; }Nilai Properti
Catatan
Properti ini tidak berlaku untuk grafik pie 3-D.
GapDepth
Mendapatkan atau mengatur jarak antara seri data dalam grafik 3-D, sebagai persentase dari lebar penanda. Nilai dari properti ini harus antara 0 dan 500.
public int GapDepth { get; set; }Nilai Properti
GapWidth
Mengembalikan atau mengatur ruang antara kluster batang atau kolom, sebagai persentase dari lebar batang atau kolom. Nilai dari properti ini harus antara 0 dan 500.
public int GapWidth { get; set; }Nilai Properti
HeightPercent
Mengembalikan atau mengatur tinggi grafik 3-D sebagai persentase dari lebar grafik (antara 5 dan 500 persen).
public int HeightPercent { get; set; }Nilai Properti
HidePivotFieldButtons
Menunjukkan apakah menyembunyikan tombol bidang grafik pivot hanya ketika grafik adalah PivotChart.
public bool HidePivotFieldButtons { get; set; }Nilai Properti
Is3D
Menunjukkan apakah grafik adalah grafik 3D.
public bool Is3D { get; }Nilai Properti
IsRectangularCornered
Mendapatkan atau mengatur nilai yang menunjukkan apakah area grafik memiliki sudut persegi. Default adalah benar.
public bool IsRectangularCornered { get; set; }Nilai Properti
Legend
Mendapatkan legenda grafik.
public Legend Legend { get; }Nilai Properti
Line
Mendapatkan garis.
public Line Line { get; }Nilai Properti
NSeries
Mendapatkan koleksi Aspose.Cells.Charts.SeriesCollection yang mewakili seri data dalam grafik.
public SeriesCollection NSeries { get; }Nilai Properti
Name
Mendapatkan dan mengatur nama grafik.
public string Name { get; set; }Nilai Properti
PageSetup
Mewakili deskripsi pengaturan halaman dalam grafik ini.
public PageSetup PageSetup { get; }Nilai Properti
Perspective
Mengembalikan atau mengatur perspektif untuk tampilan grafik 3-D. Harus antara 0 dan 100. Properti ini diabaikan jika properti RightAngleAxes adalah Benar.
public short Perspective { get; set; }Nilai Properti
PivotOptions
Menentukan kontrol pivot yang muncul di grafik
public PivotOptions PivotOptions { get; }Nilai Properti
PivotSource
Sumber adalah data dari pivotTable. Jika PivotSource tidak kosong, grafik adalah PivotChart.
public string PivotSource { get; set; }Nilai Properti
Catatan
Jika tabel pivot “PivotTable1” ada di Worksheet “Sheet1” dalam file “Book1.xls”. PivotSource dapat berupa “[Book1.xls]Sheet1!PivotTable1” jika grafik dan PivotTable tidak berada di workbook yang sama. Jika Anda mengatur properti ini, pengaturan sumber data sebelumnya akan hilang.
Placement
Mewakili cara grafik terpasang pada sel di bawahnya.
public PlacementType Placement { get; set; }Nilai Properti
PlotArea
Mendapatkan area plot grafik yang mencakup label tick sumbu.
public PlotArea PlotArea { get; }Nilai Properti
PlotBy
Mendapatkan dan mengatur apakah plot berdasarkan baris atau kolom.
public PlotDataByType PlotBy { get; }Nilai Properti
PlotEmptyCellsType
Mendapatkan dan mengatur cara memplot sel kosong.
public PlotEmptyCellsType PlotEmptyCellsType { get; set; }Nilai Properti
PlotVisibleCellsOnly
Menunjukkan apakah hanya memplot sel yang terlihat.
public bool PlotVisibleCellsOnly { get; set; }Nilai Properti
PrintSize
Mendapatkan dan mengatur ukuran cetak grafik.
public PrintSizeType PrintSize { get; set; }Nilai Properti
RightAngleAxes
Benar jika sumbu grafik berada pada sudut kanan. Berlaku hanya untuk grafik 3-D (kecuali Grafik Kolom 3D dan Grafik Pie 3-D).
public bool RightAngleAxes { get; set; }Nilai Properti
Catatan
Jika properti ini adalah Benar, properti Perspective diabaikan.
RotationAngle
Mewakili rotasi tampilan grafik 3-D (rotasi area plot di sekitar sumbu z, dalam derajat).
public int RotationAngle { get; set; }Nilai Properti
Catatan
Nilai dari properti ini harus antara 0 hingga 360, kecuali untuk grafik batang 3-D, di mana nilainya harus antara 0 hingga 44. Nilai default adalah 20. Berlaku hanya untuk grafik 3-D.
SecondCategoryAxis
Mendapatkan sumbu X kedua grafik.
public Axis SecondCategoryAxis { get; }Nilai Properti
SecondValueAxis
Mendapatkan sumbu Y kedua grafik.
public Axis SecondValueAxis { get; }Nilai Properti
SeriesAxis
Mendapatkan sumbu seri grafik.
public Axis SeriesAxis { get; }Nilai Properti
Shapes
Mengembalikan semua bentuk gambar dalam grafik ini.
public ShapeCollection Shapes { get; }Nilai Properti
ShowDataTable
Mendapatkan atau mengatur nilai yang menunjukkan apakah grafik menampilkan tabel data.
public bool ShowDataTable { get; set; }Nilai Properti
ShowLegend
Mendapatkan atau mengatur nilai yang menunjukkan apakah legenda grafik akan ditampilkan. Default adalah benar.
public bool ShowLegend { get; set; }Nilai Properti
SideWall
Mengembalikan objek Aspose.Cells.Charts.Chart.Walls yang mewakili dinding samping dari grafik 3-D.
public Walls SideWall { get; }Nilai Properti
SizeWithWindow
Benar jika Microsoft Excel mengubah ukuran grafik untuk mencocokkan ukuran jendela lembar grafik.
public bool SizeWithWindow { get; set; }Nilai Properti
Style
Mendapatkan dan mengatur gaya bawaan.
public int Style { get; set; }Nilai Properti
Catatan
Nilai harus antara 1 dan 48. Kembalikan -1 jika tidak diatur.
SubTitle
Mendapatkan sub-judul grafik. Hanya untuk file format ODS.
public Title SubTitle { get; }Nilai Properti
Title
Mendapatkan judul grafik.
public Title Title { get; }Nilai Properti
Type
Mendapatkan atau mengatur tipe grafik.
public ChartType Type { get; set; }Nilai Properti
ValueAxis
Mendapatkan sumbu Y grafik.
public Axis ValueAxis { get; }Nilai Properti
Walls
Mengembalikan objek Aspose.Cells.Charts.Chart.Walls yang mewakili dinding dari grafik 3-D.
public Walls Walls { get; }Nilai Properti
Catatan
Properti ini tidak berlaku untuk grafik pie 3-D.
WallsAndGridlines2D
Benar jika garis kisi digambar secara dua dimensi pada grafik 3-D.
public bool WallsAndGridlines2D { get; set; }Nilai Properti
Worksheet
Mendapatkan lembar kerja yang berisi grafik ini.
public Worksheet Worksheet { get; }Nilai Properti
Metode
Calculate()
Menghitung posisi kustom area plot, sumbu jika posisi mereka ditetapkan secara otomatis.
public void Calculate()Calculate(ChartCalculateOptions)
Menghitung posisi kustom area plot, sumbu jika posisi mereka ditetapkan secara otomatis, dengan Opsi Hitung Grafik.
public void Calculate(ChartCalculateOptions calculateOptions)Parameter
calculateOptions ChartCalculateOptions
ChangeTemplate(byte[])
Mengubah tipe grafik dengan template yang telah ditentukan.
public void ChangeTemplate(byte[] data)Parameter
data byte[]
Data dari file template grafik (.crtx).
GetActualSize()
Mendapatkan ukuran aktual dari grafik dalam satuan piksel.
public int[] GetActualSize()Mengembalikan
int[]
Ukuran aktual dalam array (lebar dan tinggi). [0] adalah lebar; [1] adalah tinggi.
GetChartDataRange()
Mendapatkan rentang sumber data dari grafik.
public string GetChartDataRange()Mengembalikan
Sumber data.
Catatan
Hanya mendukung rentang.
HasAxis(AxisType, bool)
Mengembalikan sumbu mana yang ada pada grafik.
public bool HasAxis(AxisType aixsType, bool isPrimary)Parameter
aixsType AxisType
isPrimary bool
Mengembalikan
Catatan
Biasanya, Pie, PieExploded, PiePie, PieBar, Pie3D, Pie3DExploded, Doughnut, DoughnutExploded tidak memiliki sumbu.
IsCellReferedByChart(int, int, int)
Mengembalikan apakah sel yang dirujuk oleh grafik.
public bool IsCellReferedByChart(int sheetIndex, int rowIndex, int columnIndex)Parameter
sheetIndex int
Indeks lembar.-1 berarti lembar kerja yang berisi grafik saat ini.
rowIndex int
Indeks baris
columnIndex int
Indeks kolom
Mengembalikan
IsChartDataChanged()
Mendeteksi apakah sumber data grafik telah berubah.
public bool IsChartDataChanged()Mengembalikan
Mengembalikan true jika grafik telah berubah, jika tidak mengembalikan false
Catatan
Metode ini mendeteksi perubahan pada sumber data grafik sebelum merender grafik ke format gambar. Pada panggilan pertama Chart.toImage, data sumber grafik (misalnya XValuesParseData, ValuesParseData) akan dicatat. Sebelum memanggil metode Chart.toImage lagi, panggil metode IsChartDataChanged untuk memeriksa apakah Chart perlu dirender ulang.
Move(int, int, int, int)
Memindahkan grafik ke lokasi tertentu.
public void Move(int upperLeftRow, int upperLeftColumn, int lowerRightRow, int lowerRightColumn)Parameter
upperLeftRow int
Indeks baris kiri atas.
upperLeftColumn int
Indeks kolom kiri atas.
lowerRightRow int
Indeks baris kanan bawah
lowerRightColumn int
Indeks kolom kanan bawah
RefreshPivotData()
Menyegarkan data grafik dari tabel pivot.
public void RefreshPivotData()Catatan
Kami akan mengumpulkan data dari sumber data pivot ke laporan tabel pivot. Metode ini hanya digunakan untuk mengumpulkan semua data ke grafik pivot.
SetChartDataRange(string, bool)
Menentukan rentang data untuk grafik.
public void SetChartDataRange(string area, bool isVertical)Parameter
area string
Menentukan nilai dari mana untuk memplot seri data
isVertical bool
Menentukan apakah memplot seri dari rentang nilai sel berdasarkan baris atau kolom.
SwitchRowColumn()
Mengalihkan baris/kolom.
public bool SwitchRowColumn()Mengembalikan
False berarti pengalihan baris/kolom gagal.
ToImage(string)
Membuat gambar grafik dan menyimpannya ke file. Ekstensi nama file menentukan format gambar.
public void ToImage(string imageFile)Parameter
imageFile string
Nama file gambar dengan path lengkap.
Catatan
Format gambar ditentukan dengan menggunakan ekstensi nama file. Misalnya, jika Anda menentukan "myfile.png", maka gambar akan disimpan dalam format PNG. Ekstensi file berikut dikenali: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
Jika lebar atau tinggi nol atau grafik tidak didukung sesuai dengan Daftar Grafik yang Didukung, metode ini tidak akan melakukan apa-apa.ToImage(string, ImageType)
Membuat gambar grafik dan menyimpannya ke file dalam tipe gambar yang ditentukan.
public void ToImage(string imageFile, ImageType imageType)Parameter
imageFile string
Nama file gambar dengan path lengkap.
imageType ImageType
Tipe gambar di mana untuk menyimpan gambar.
Catatan
Tipe gambar ditentukan dengan menggunakan `imageType`. Tipe berikut didukung: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Jika lebar atau tinggi nol atau grafik tidak didukung sesuai dengan Daftar Grafik yang Didukung, metode ini tidak akan melakukan apa-apa.ToImage(string, long)
Membuat gambar grafik dan menyimpannya ke file dalam format Jpeg.
public void ToImage(string imageFile, long jpegQuality)Parameter
imageFile string
Nama file gambar dengan path lengkap.
jpegQuality long
Kualitas Jpeg.
Catatan
Jika lebar atau tinggi nol atau grafik tidak didukung sesuai dengan Daftar Grafik yang Didukung, metode ini tidak akan melakukan apa-apa.
ToImage(Stream, long)
Membuat gambar grafik dan menyimpannya ke stream dalam format Jpeg.
public void ToImage(Stream stream, long jpegQuality)Parameter
stream Stream
Stream output.
jpegQuality long
Kualitas Jpeg.
Catatan
Jika lebar atau tinggi nol atau grafik tidak didukung sesuai dengan Daftar Grafik yang Didukung, metode ini tidak akan melakukan apa-apa.
ToImage(Stream, ImageType)
Membuat gambar grafik dan menyimpannya ke stream dalam format yang ditentukan.
public void ToImage(Stream stream, ImageType imageType)Parameter
stream Stream
Stream output.
imageType ImageType
Tipe gambar di mana untuk menyimpan gambar.
Catatan
Tipe gambar ditentukan dengan menggunakan `imageType`. Tipe berikut didukung: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Jika lebar atau tinggi nol atau grafik tidak didukung sesuai dengan Daftar Grafik yang Didukung, metode ini tidak akan melakukan apa-apa.ToImage(string, ImageOrPrintOptions)
Membuat gambar grafik dan menyimpannya ke file. Ekstensi nama file menentukan format gambar.
public void ToImage(string imageFile, ImageOrPrintOptions options)Parameter
imageFile string
Nama file gambar dengan path lengkap.
options ImageOrPrintOptions
Opsi tambahan untuk pembuatan gambar
Contoh
Menyimpan ke Tiff dengan 300 dpi dan kompresi CCITT4.
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)Menyimpan ke Jpeg dengan 300 dpi dan kualitas gambar 80.
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)Catatan
Format gambar ditentukan dengan menggunakan ekstensi nama file. Misalnya, jika Anda menentukan "myfile.png", maka gambar akan disimpan dalam format PNG. Ekstensi file berikut dikenali: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
Jika lebar atau tinggi nol atau grafik tidak didukung sesuai dengan Daftar Grafik yang Didukung, metode ini tidak akan melakukan apa-apa. Silakan merujuk ke Daftar Grafik yang Didukung untuk informasi lebih lanjut.ToImage(Stream, ImageOrPrintOptions)
Membuat gambar grafik dan menyimpannya ke stream dalam format yang ditentukan.
public void ToImage(Stream stream, ImageOrPrintOptions options)Parameter
stream Stream
Stream output.
options ImageOrPrintOptions
Opsi tambahan untuk pembuatan gambar
Catatan
Tipe gambar ditentukan dengan menggunakan `options.ImageType`. Format berikut didukung: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Jika lebar atau tinggi nol atau grafik tidak didukung sesuai dengan Daftar Grafik yang Didukung, metode ini tidak akan melakukan apa-apa. Silakan merujuk ke Daftar Grafik yang Didukung untuk informasi lebih lanjut.ToPdf(string)
Menyimpan grafik ke file pdf.
public void ToPdf(string fileName)Parameter
fileName string
nama file pdf dengan path lengkap
ToPdf(string, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)
Menyimpan grafik ke file pdf.
public void ToPdf(string fileName, float desiredPageWidth, float desiredPageHeight, PageLayoutAlignmentType hAlignmentType, PageLayoutAlignmentType vAlignmentType)Parameter
fileName string
nama file pdf dengan path lengkap
desiredPageWidth float
Lebar halaman yang diinginkan dalam inci.
desiredPageHeight float
Tinggi halaman yang diinginkan dalam inci.
hAlignmentType PageLayoutAlignmentType
Tipe perataan horizontal grafik dalam halaman output.
vAlignmentType PageLayoutAlignmentType
Tipe perataan vertikal grafik dalam halaman output.
ToPdf(Stream)
Membuat pdf grafik dan menyimpannya ke stream.
public void ToPdf(Stream stream)Parameter
stream Stream
Stream output.
ToPdf(Stream, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)
Membuat pdf grafik dan menyimpannya ke stream.
public void ToPdf(Stream stream, float desiredPageWidth, float desiredPageHeight, PageLayoutAlignmentType hAlignmentType, PageLayoutAlignmentType vAlignmentType)Parameter
stream Stream
Stream output.
desiredPageWidth float
Lebar halaman yang diinginkan dalam inci.
desiredPageHeight float
Tinggi halaman yang diinginkan dalam inci.
hAlignmentType PageLayoutAlignmentType
Tipe perataan horizontal grafik dalam halaman output.
vAlignmentType PageLayoutAlignmentType
Tipe perataan vertikal grafik dalam halaman output.
