Class Chart
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Tek bir Excel grafiğini temsil eden nesneyi kapsar.
public class ChartKalıtım
Kalıtılan Üyeler
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Örnekler
Aşağıdaki kodlar .Net kodları ile bir grafik oluşturmayı göstermektedir.
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
Cells cells = sheet.Cells;
cells[0,1].PutValue("Gelir");
cells[1,0].PutValue("Şirket A");
cells[2,0].PutValue("Şirket B");
cells[3,0].PutValue("Şirket 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 = "Gelir Analizi";Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)
Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("Gelir")
cells(1,0).PutValue("Şirket A")
cells(2,0).PutValue("Şirket B")
cells(3,0).PutValue("Şirket 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 = "Gelir Analizi"Özellikler
ActualChartSize
Grafiğin gerçek boyutunu piksel cinsinden alır.
[Obsolete("Chart.GetActualSize() metodunu kullanın.")]
public Size ActualChartSize { get; }Özellik Değeri
Açıklamalar
NOT: Bu üye artık kullanımdan kaldırılmıştır. Bunun yerine, lütfen Chart.GetActualSize() metodunu kullanın. Bu özellik Temmuz 2022’den itibaren 12 ay sonra kaldırılacaktır. Aspose, yaşadığınız rahatsızlık için özür diler.
AutoScaling
Microsoft Excel’in 3-D grafiği, eşdeğer 2-D grafiğe daha yakın boyutta ölçeklendirmesi durumunda True döner. RightAngleAxes özelliği True olmalıdır.
public bool AutoScaling { get; set; }Özellik Değeri
BackWall
3-D grafiğin arka duvarını temsil eden Aspose.Cells.Charts.Chart.Walls nesnesini döner.
public Walls BackWall { get; }Özellik Değeri
CategoryAxis
Grafiğin X eksenini alır.
public Axis CategoryAxis { get; }Özellik Değeri
ChartArea
Çalışma sayfasındaki grafik alanını alır.
public ChartArea ChartArea { get; }Özellik Değeri
ChartDataTable
Grafik veri tablosunu temsil eder.
public ChartDataTable ChartDataTable { get; }Özellik Değeri
ChartObject
Grafik şekli temsil eder;
public ChartShape ChartObject { get; }Özellik Değeri
DepthPercent
3-D grafiğin derinliğini, grafik genişliğinin yüzdesi olarak temsil eder (20 ile 2000 yüzde arasında).
public int DepthPercent { get; set; }Özellik Değeri
DisplayNaAsBlank
#N/A’nın boş değer olarak görüntülenip görüntülenmeyeceğini gösterir.
public bool DisplayNaAsBlank { get; set; }Özellik Değeri
Elevation
3-D grafik görünümünün yüksekliğini, derece cinsinden temsil eder.
public int Elevation { get; set; }Özellik Değeri
Açıklamalar
Grafik yüksekliği, grafiği hangi yükseklikten görüntülediğinizdir, derece cinsindendir. Çoğu grafik türü için varsayılan 15’tir. Bu özelliğin değeri -90 ile 90 arasında olmalıdır, 3-D çubuk grafikler için ise 0 ile 44 arasında olmalıdır.
FilteredNSeries
Grafikte filtrelenmiş veri serilerini temsil eden Aspose.Cells.Charts.SeriesCollection koleksiyonunu alır.
public SeriesCollection FilteredNSeries { get; }Özellik Değeri
FirstSliceAngle
İlk pasta grafiği veya halka grafiği diliminin açısını, derece cinsinden alır veya ayarlar (dikeyden saat yönünde). Yalnızca pasta, 3-D pasta ve halka grafikler için geçerlidir, 0 ile 360 arasında.
public int FirstSliceAngle { get; set; }Özellik Değeri
Floor
3-D grafiğin duvarlarını temsil eden Aspose.Cells.Charts.Chart.Floor nesnesini döner.
public Floor Floor { get; }Özellik Değeri
Açıklamalar
Bu özellik 3-D pasta grafikler için geçerli değildir.
GapDepth
3-D grafikte veri serileri arasındaki mesafeyi, işaretçi genişliğinin yüzdesi olarak alır veya ayarlar. Bu özelliğin değeri 0 ile 500 arasında olmalıdır.
public int GapDepth { get; set; }Özellik Değeri
GapWidth
Çubuk veya sütun kümeleri arasındaki boşluğu, çubuk veya sütun genişliğinin yüzdesi olarak döner veya ayarlar. Bu özelliğin değeri 0 ile 500 arasında olmalıdır.
public int GapWidth { get; set; }Özellik Değeri
HeightPercent
3-D grafiğin yüksekliğini, grafik genişliğinin yüzdesi olarak döner veya ayarlar (5 ile 500 yüzde arasında).
public int HeightPercent { get; set; }Özellik Değeri
HidePivotFieldButtons
Grafik PivotChart olduğunda yalnızca pivot grafik alan düğmelerini gizleyip gizlemeyeceğini gösterir.
public bool HidePivotFieldButtons { get; set; }Özellik Değeri
Is3D
Grafiğin 3D grafiği olup olmadığını gösterir.
public bool Is3D { get; }Özellik Değeri
IsRectangularCornered
Grafik alanının dikdörtgen köşeli olup olmadığını gösteren bir değer alır veya ayarlar. Varsayılan değer doğrudur.
public bool IsRectangularCornered { get; set; }Özellik Değeri
Legend
Grafik efsanesini alır.
public Legend Legend { get; }Özellik Değeri
Line
Çizgiyi alır.
public Line Line { get; }Özellik Değeri
NSeries
Grafikteki veri serilerini temsil eden Aspose.Cells.Charts.SeriesCollection koleksiyonunu alır.
public SeriesCollection NSeries { get; }Özellik Değeri
Name
Grafiğin adını alır ve ayarlar.
public string Name { get; set; }Özellik Değeri
PageSetup
Bu grafikteki sayfa ayarlarının tanımını temsil eder.
public PageSetup PageSetup { get; }Özellik Değeri
Perspective
3-D grafik görünümü için perspektifi döner veya ayarlar. 0 ile 100 arasında olmalıdır. RightAngleAxes özelliği True ise bu özellik göz ardı edilir.
public short Perspective { get; set; }Özellik Değeri
PivotOptions
Grafikte görünen pivot kontrollerini belirtir.
public PivotOptions PivotOptions { get; }Özellik Değeri
PivotSource
Kaynak, pivotTablosunun verisidir. PivotSource boş değilse, grafik PivotChart’tır.
public string PivotSource { get; set; }Özellik Değeri
Açıklamalar
Eğer pivot tablo “PivotTable1” ise “Sheet1” çalışma sayfasında “Book1.xls” dosyasında. PivotSource, grafik ve PivotTable aynı çalışma kitabında değilse “[Book1.xls]Sheet1!PivotTable1” olabilir. Bu özelliği ayarlarsanız, önceki veri kaynağı ayarı kaybolacaktır.
Placement
Grafiğin altında bulunan hücrelere nasıl bağlandığını temsil eder.
public PlacementType Placement { get; set; }Özellik Değeri
PlotArea
Grafiğin eksen tik etiketlerini içeren çizim alanını alır.
public PlotArea PlotArea { get; }Özellik Değeri
PlotBy
Satır veya sütun bazında çizim yapılıp yapılmadığını alır ve ayarlar.
public PlotDataByType PlotBy { get; }Özellik Değeri
PlotEmptyCellsType
Boş hücrelerin nasıl çizileceğini alır ve ayarlar.
public PlotEmptyCellsType PlotEmptyCellsType { get; set; }Özellik Değeri
PlotVisibleCellsOnly
Yalnızca görünür hücrelerin çizilip çizilmeyeceğini gösterir.
public bool PlotVisibleCellsOnly { get; set; }Özellik Değeri
PrintSize
Yazdırılan grafik boyutunu alır ve ayarlar.
public PrintSizeType PrintSize { get; set; }Özellik Değeri
RightAngleAxes
Grafik eksenlerinin dik açılarda olup olmadığını gösterir. Sadece 3-D grafikler için geçerlidir (Sütun3D ve 3-D Pasta Grafikler hariç).
public bool RightAngleAxes { get; set; }Özellik Değeri
Açıklamalar
Bu özellik True ise, Perspective özelliği göz ardı edilir.
RotationAngle
3-D grafik görünümünün dönüşünü (çizim alanının z ekseni etrafındaki dönüşü, derece cinsinden) temsil eder.
public int RotationAngle { get; set; }Özellik Değeri
Açıklamalar
Bu özelliğin değeri 0 ile 360 arasında olmalıdır, 3-D çubuk grafikler için ise değer 0 ile 44 arasında olmalıdır. Varsayılan değer 20’dir. Sadece 3-D grafikler için geçerlidir.
SecondCategoryAxis
Grafiğin ikinci X eksenini alır.
public Axis SecondCategoryAxis { get; }Özellik Değeri
SecondValueAxis
Grafiğin ikinci Y eksenini alır.
public Axis SecondValueAxis { get; }Özellik Değeri
SeriesAxis
Grafiğin seri eksenini alır.
public Axis SeriesAxis { get; }Özellik Değeri
Shapes
Bu grafikteki tüm çizim şekillerini döner.
public ShapeCollection Shapes { get; }Özellik Değeri
ShowDataTable
Grafiğin bir veri tablosu gösterip göstermeyeceğini belirten bir değeri alır veya ayarlar.
public bool ShowDataTable { get; set; }Özellik Değeri
ShowLegend
Grafik efsanesinin görüntülenip görüntülenmeyeceğini belirten bir değeri alır veya ayarlar. Varsayılan değer doğrudur.
public bool ShowLegend { get; set; }Özellik Değeri
SideWall
3-D grafiğin yan duvarını temsil eden Aspose.Cells.Charts.Chart.Walls nesnesini döner.
public Walls SideWall { get; }Özellik Değeri
SizeWithWindow
Microsoft Excel’in grafiği grafik sayfası penceresinin boyutuna göre yeniden boyutlandırıp boyutlandırmayacağını gösterir.
public bool SizeWithWindow { get; set; }Özellik Değeri
Style
Yerleşik stili alır ve ayarlar.
public int Style { get; set; }Özellik Değeri
Açıklamalar
1 ile 48 arasında olmalıdır. Ayarlanmadıysa -1 döner.
SubTitle
Grafiğin alt başlığını alır. Yalnızca ODS formatındaki dosyalar için geçerlidir.
public Title SubTitle { get; }Özellik Değeri
Title
Grafiğin başlığını alır.
public Title Title { get; }Özellik Değeri
Type
Bir grafiğin türünü alır veya ayarlar.
public ChartType Type { get; set; }Özellik Değeri
ValueAxis
Grafiğin Y eksenini alır.
public Axis ValueAxis { get; }Özellik Değeri
Walls
3-D grafiğin duvarlarını temsil eden Aspose.Cells.Charts.Chart.Walls nesnesini döner.
public Walls Walls { get; }Özellik Değeri
Açıklamalar
Bu özellik 3-D pasta grafikler için geçerli değildir.
WallsAndGridlines2D
3-D grafikte ızgara çizgilerinin iki boyutlu olarak çizilip çizilmeyeceğini gösterir.
public bool WallsAndGridlines2D { get; set; }Özellik Değeri
Worksheet
Bu grafiği içeren çalışma sayfasını alır.
public Worksheet Worksheet { get; }Özellik Değeri
Metodlar
Calculate()
Otomatik olarak atanan konumda ise çizim alanının, eksenlerin özel konumunu hesaplar.
public void Calculate()Calculate(ChartCalculateOptions)
Otomatik olarak atanan konumda ise çizim alanının, eksenlerin özel konumunu hesaplar, Grafik Hesaplama Seçenekleri ile birlikte.
public void Calculate(ChartCalculateOptions calculateOptions)Parametreler
calculateOptions ChartCalculateOptions
ChangeTemplate(byte[])
Önceden ayarlanmış şablon ile grafik türünü değiştirir.
public void ChangeTemplate(byte[] data)Parametreler
data byte[]
Grafik şablon dosyasının verisi (.crtx).
GetActualSize()
Grafiğin gerçek boyutunu piksel cinsinden alır.
public int[] GetActualSize()Döner
int[]
Bir dizideki gerçek boyut (genişlik ve yükseklik). [0] genişliktir; [1] yüksekliktir.
GetChartDataRange()
Grafiğin veri kaynağı aralığını alır.
public string GetChartDataRange()Döner
Veri kaynağı.
Açıklamalar
Yalnızca aralığı destekler.
HasAxis(AxisType, bool)
Grafikte hangi eksenlerin bulunduğunu döner.
public bool HasAxis(AxisType aixsType, bool isPrimary)Parametreler
aixsType AxisType
isPrimary bool
Döner
Açıklamalar
Normalde, Pasta, Patlayan Pasta, PastaPasta, PastaÇubuk, 3D Pasta, Patlayan 3D Pasta, Halka, Patlayan Halka eksen yoktur.
IsCellReferedByChart(int, int, int)
Grafik tarafından referans verilen hücrenin olup olmadığını döner.
public bool IsCellReferedByChart(int sheetIndex, int rowIndex, int columnIndex)Parametreler
sheetIndex int
Sayfa İndeksi.-1, mevcut grafiği içeren çalışma sayfasını ifade eder.
rowIndex int
Satır indeksi
columnIndex int
Sütun indeksi
Döner
IsChartDataChanged()
Bir grafiğin veri kaynağının değişip değişmediğini tespit eder.
public bool IsChartDataChanged()Döner
Grafik değiştiyse true döner, aksi takdirde false döner.
Açıklamalar
Bu yöntem, grafiği görüntülemeden önce grafiğin veri kaynağındaki değişiklikleri tespit eder. İlk Chart.toImage çağrısında, grafik kaynak verileri (örneğin XValuesParseData, ValuesParseData) kaydedilecektir. Chart.toImage yöntemini tekrar çağırmadan önce, Chart’ın yeniden işlenmesi gerekip gerekmediğini kontrol etmek için IsChartDataChanged yöntemini çağırın.
Move(int, int, int, int)
Grafiği belirli bir konuma taşır.
public void Move(int upperLeftRow, int upperLeftColumn, int lowerRightRow, int lowerRightColumn)Parametreler
upperLeftRow int
Üst sol satır indeksi.
upperLeftColumn int
Üst sol sütun indeksi.
lowerRightRow int
Alt sağ satır indeksi
lowerRightColumn int
Alt sağ sütun indeksi
RefreshPivotData()
Grafiğin verilerini pivot tablosundan yeniler.
public void RefreshPivotData()Açıklamalar
Pivot tablo raporuna veri toplamak için pivot veri kaynağından veri toplayacağız. Bu yöntem yalnızca tüm verileri bir pivot grafiğine toplamak için kullanılır.
SetChartDataRange(string, bool)
Bir grafik için veri aralığını belirtir.
public void SetChartDataRange(string area, bool isVertical)Parametreler
area string
Veri serisini çizmek için kullanılacak değerleri belirtir.
isVertical bool
Serinin bir hücre değerleri aralığından satır veya sütun bazında çizilip çizilmeyeceğini belirtir.
SwitchRowColumn()
Satır/sütunu değiştirir.
public bool SwitchRowColumn()Döner
False, satır/sütun değiştirmenin başarısız olduğunu gösterir.
ToImage(string)
Grafik görüntüsünü oluşturur ve bir dosyaya kaydeder. Dosya adının uzantısı, görüntü formatını belirler.
public void ToImage(string imageFile)Parametreler
imageFile string
Tam yol ile görüntü dosya adı.
Açıklamalar
Görüntü formatı, dosya adının uzantısını kullanarak belirlenir. Örneğin, "myfile.png" belirtirseniz, görüntü PNG formatında kaydedilecektir. Aşağıdaki dosya uzantıları tanınmaktadır: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
Genişlik veya yükseklik sıfırsa veya grafik, Desteklenen Grafikler Listesi'ne göre desteklenmiyorsa, bu yöntem hiçbir şey yapmayacaktır.ToImage(string, ImageType)
Grafik görüntüsünü oluşturur ve belirtilen görüntü türünde bir dosyaya kaydeder.
public void ToImage(string imageFile, ImageType imageType)Parametreler
imageFile string
Tam yol ile görüntü dosya adı.
imageType ImageType
Görüntünün kaydedileceği görüntü türü.
Açıklamalar
Görüntü türü, `imageType` kullanılarak belirtilir. Aşağıdaki türler desteklenmektedir: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Genişlik veya yükseklik sıfırsa veya grafik, Desteklenen Grafikler Listesi'ne göre desteklenmiyorsa, bu yöntem hiçbir şey yapmayacaktır.ToImage(string, long)
Grafik görüntüsünü oluşturur ve Jpeg formatında bir dosyaya kaydeder.
public void ToImage(string imageFile, long jpegQuality)Parametreler
imageFile string
Tam yol ile görüntü dosya adı.
jpegQuality long
Jpeg kalitesi.
Açıklamalar
Genişlik veya yükseklik sıfırsa veya grafik, Desteklenen Grafikler Listesi’ne göre desteklenmiyorsa, bu yöntem hiçbir şey yapmayacaktır.
ToImage(Stream, long)
Grafik görüntüsünü oluşturur ve Jpeg formatında bir akıma kaydeder.
public void ToImage(Stream stream, long jpegQuality)Parametreler
stream Stream
Çıktı akımı.
jpegQuality long
Jpeg kalitesi.
Açıklamalar
Genişlik veya yükseklik sıfırsa veya grafik, Desteklenen Grafikler Listesi’ne göre desteklenmiyorsa, bu yöntem hiçbir şey yapmayacaktır.
ToImage(Stream, ImageType)
Grafik görüntüsünü oluşturur ve belirtilen formatta bir akıma kaydeder.
public void ToImage(Stream stream, ImageType imageType)Parametreler
stream Stream
Çıktı akımı.
imageType ImageType
Görüntünün kaydedileceği görüntü türü.
Açıklamalar
Görüntü türü, `imageType` kullanılarak belirtilir. Aşağıdaki türler desteklenmektedir: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Genişlik veya yükseklik sıfırsa veya grafik, Desteklenen Grafikler Listesi'ne göre desteklenmiyorsa, bu yöntem hiçbir şey yapmayacaktır.ToImage(string, ImageOrPrintOptions)
Grafik görüntüsünü oluşturur ve bir dosyaya kaydeder. Dosya adının uzantısı, görüntü formatını belirler.
public void ToImage(string imageFile, ImageOrPrintOptions options)Parametreler
imageFile string
Tam yol ile görüntü dosya adı.
options ImageOrPrintOptions
Ek görüntü oluşturma seçenekleri
Örnekler
300 dpi ve CCITT4 sıkıştırması ile Tiff olarak kaydeder.
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)300 dpi ve 80 görüntü kalitesi ile Jpeg olarak kaydeder.
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)Açıklamalar
Görüntü formatı, dosya adının uzantısını kullanarak belirlenir. Örneğin, "myfile.png" belirtirseniz, görüntü PNG formatında kaydedilecektir. Aşağıdaki dosya uzantıları tanınmaktadır: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
Genişlik veya yükseklik sıfırsa veya grafik, Desteklenen Grafikler Listesi'ne göre desteklenmiyorsa, bu yöntem hiçbir şey yapmayacaktır. Daha fazla bilgi için lütfen Desteklenen Grafikler Listesi'ne başvurun.ToImage(Stream, ImageOrPrintOptions)
Grafik pdf’sini oluşturur ve belirtilen formatta bir akıma kaydeder.
public void ToPdf(Stream stream)Parametreler
stream Stream
Çıktı akımı.
