Grafiklerdeki Şekiller

Bazen bir grafiğe etiketler, metin kutuları, resimler vb. gibi çizim nesneleri eklemeniz gerekir. Aspose.Cells, kontrolleri çalışma zamanında bir grafiğe ekleyebilir.

Grafiğe Etiket Kontrolü Ekleme

Etiketler, kullanıcılara elektronik tablonun içeriği hakkında bilgi vermek için bir araç sağlar. Aspose.Cells, grafiklere bile etiket eklemenize ve değiştirmenize olanak tanır.

buAspose.Cells.Drawing.ShapeCollection sınıf adlı bir yöntem sağlarAddLabelInChart, bir grafiğe etiket denetimi eklemek için kullanılır. Yöntem için kullanılan parametrelerin listesi aşağıdadır:

• tepe – grafik alanının 1/4000’lik birimlerinde sol üst köşeden etiketin dikey ofseti.
• sol – grafik alanının 1/4000’lik birimlerinde sol üst köşeden etiketin dikey ofseti.
• boy uzunluğu – grafik alanının 1/4000 birimi cinsinden etiketin yüksekliği.
• Genişlik – grafik alanının 1/4000’lik birimleri cinsinden etiket genişliği.

Yöntem döndürürAspose.Cells.Drawing.Labelnesne. buEtiket class grafikte bir etiketi temsil eder. Bazı önemli üyeleri vardır:

• Metin(özellik) – bir etiketin başlık dizesini belirtir.
• Doldurmak (özellik) – dolgu rengi niteliklerini belirtir.

Aşağıdaki örnek, grafiğe nasıl etiket ekleneceğini gösterir. Örnek bir tasarımcı dosyası kullanır (exp_piecart.xls) içinde bir grafik var. Grafiğe bir etiket eklemek için bu dosyayı kullanıyoruz. Grafiğe etiket eklemek için orijinal kod aşağıdadır. Kod yürütülürken aşağıdaki çıktı oluşturulur.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Open the existing file.
Workbook workbook = new Workbook(dataDir + "chart.xls");

// Get the designer chart in the second sheet.
Worksheet sheet = workbook.Worksheets[1];
Aspose.Cells.Charts.Chart chart = sheet.Charts[0];

// Add a new label to the chart.
Aspose.Cells.Drawing.Label label = chart.Shapes.AddLabelInChart(100, 100, 350, 900);

// Set the caption of the label.
label.Text = "A Label In Chart";

// Set the Placement Type, the way the
// Label is attached to the cells.
label.Placement = Aspose.Cells.Drawing.PlacementType.FreeFloating;

// Save the excel file.
workbook.Save(dataDir + "chart.out.xls");

Grafiğe Metin Kutusu Denetimi Ekleme

Bir rapordaki önemli bilgileri vurgulamanın bir yolu, bir metin kutusu kullanmaktır. Örneğin, şirket adını vurgulamak veya en yüksek satışa sahip coğrafi bölgeyi belirtmek için metin girin. buAspose.Cells.Drawing.ShapeCollection sınıf adlı bir yöntem sağlarAddTextBoxInChartbir grafiğe bir metin kutusu denetimi eklemek için kullanılır. Yöntem için kullanılan parametre listesi aşağıdadır:

• tepe – grafik alanının 1/4000 biriminde metin kutusunun sol üst köşeden dikey uzaklığı.
• sol – grafik alanının 1/4000 biriminde metin kutusunun sol üst köşeden dikey uzaklığı.
• boy uzunluğu– grafik alanının 1/4000’lik birimlerinde metin kutusunun yüksekliği.
• Genişlik – grafik alanının 1/4000’lik birimleri cinsinden metin kutusunun genişliği.

Yöntem döndürürAspose.Cells.Drawing.TextBox nesne. buMetin kutusuclass, grafikte bir metin kutusunu temsil eder.

Aşağıdaki örnek, bir grafiğe nasıl metin kutusu ekleneceğini gösterir. Örnek, önceki tasarımcı dosyasını kullanır (exp_piecart.xls) içinde bir grafik var. Grafik başlığını göstermek için grafiğe bir metin kutusu eklemek için bu dosyayı kullanıyoruz. Grafiğe metin kutusu eklemek için orijinal kod aşağıdadır.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Open the existing file.
Workbook workbook = new Workbook(dataDir + "chart.xls");
 
// Get the designer chart in the second sheet.
Worksheet sheet = workbook.Worksheets[1];
Aspose.Cells.Charts.Chart chart = sheet.Charts[0];

// Add a new textbox to the chart.
Aspose.Cells.Drawing.TextBox textbox0 = chart.Shapes.AddTextBoxInChart(100, 1100, 350, 2550);

// Fill the text.
textbox0.Text = "Sales By Region";

// Get the textbox text frame.
// Aspose.Cells.Drawing.MsoTextFrame textframe0 = textbox0.TextFrame;

// Set the textbox to adjust it according to its contents.
// textframe0.AutoSize = true;

// Set the font color.
textbox0.Font.Color = Color.Maroon;

// Set the font to bold.
textbox0.Font.IsBold = true;

// Set the font size.
textbox0.Font.Size = 14;

// Set font attribute to italic.
textbox0.Font.IsItalic = true;

// Get the filformat of the textbox.
Aspose.Cells.Drawing.FillFormat fillformat = textbox0.Fill;

// Get the lineformat type of the textbox.
Aspose.Cells.Drawing.LineFormat lineformat = textbox0.Line;
     
// Set the line weight.
lineformat.Weight = 2;

// Set the dash style to solid.
lineformat.DashStyle = Aspose.Cells.Drawing.MsoLineDashStyle.Solid;

// Save the excel file.
workbook.Save(dataDir + "chart.out.xls");

Grafiğe Resim Ekleme

Aspose.Cells, bir grafiğe resim eklemenizi sağlar. Örneğin, bir grafiği veya içeriğini vurgulamak veya daha fazla anlam vermek için bir resim ekleyin veya bir marka görsel dosyası ekleyin.

buAspose.Cells.Drawing.ShapeCollection sınıf adlı bir yöntem sağlarGrafikte Resim Eklegrafiğe bir resim nesnesi eklemek için kullanılır. Yöntem için kullanılan parametre listesi aşağıdadır:

• tepe– tablo alanının 1/4000 biriminde resmin sol üst köşeden dikey kayması.
• sol– tablo alanının 1/4000 biriminde resmin sol üst köşeden dikey kayması.
• aktarım – görüntü verilerini içeren bir akış nesnesi.
• genişlikÖlçeği – görüntü genişliği ölçeği, bir yüzde değeri.
• yükseklikÖlçek – görüntü yüksekliği ölçeği, bir yüzde değeri.

Yöntem bir döndürürAspose.Cells.Drawing.Picture nesne. buResimclass, grafikteki bir resim nesnesini temsil eder.

Aşağıdaki örnek, grafiğe nasıl resim ekleneceğini gösterir. Örnek, önceki tasarımcı dosyasını kullanır (exp_piecart.xls) içinde bir grafik var. Bu dosyayı grafiğe bir resim eklemek için kullanıyoruz. Grafiğe resim eklemek için orijinal kod aşağıdadır.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Open the existing file.
Workbook workbook = new Workbook(dataDir + "chart.xls");

// Get an image file to the stream.
FileStream stream = new FileStream(dataDir + "logo.jpg", FileMode.Open, FileAccess.Read);

// Get the designer chart in the second sheet.
Worksheet sheet = workbook.Worksheets[0];
Aspose.Cells.Charts.Chart chart = sheet.Charts[0];

// Add a new picture to the chart.
Aspose.Cells.Drawing.Picture pic0 = chart.Shapes.AddPictureInChart(50, 50, stream, 40, 40);

// Get the lineformat type of the picture.
Aspose.Cells.Drawing.LineFormat lineformat = pic0.Line;          

// Set the dash style.
lineformat.DashStyle = Aspose.Cells.Drawing.MsoLineDashStyle.Solid;

// Set the line weight.
lineformat.Weight = 4;    

// Save the excel file.
workbook.Save(dataDir + "chart.out.xls");

Grafiğe Onay Kutusu Ekleme

Aspose.Cells kullanarak bir grafik sayfasına onay kutuları eklemenizi sağlar.MsoDrawingType numaralandırma. Aşağıdaki örnek, bir grafik sayfasına bir onay kutusu eklemeyi gösterir.

Aşağıdaki resimde, çıktı dosyasında onay kutusu bulunan grafik sayfası gösterilmektedir.

buçıktı dosyasıaşağıdaki kod parçacığı tarafından oluşturulan referans için eklenmiştir.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Adding a chart to the worksheet
int index = workbook.Worksheets.Add(SheetType.Chart);

Worksheet sheet = workbook.Worksheets[index];
sheet.Charts.AddFloatingChart(ChartType.Column, 0, 0, 1024, 960);
sheet.Charts[0].NSeries.Add("{1,2,3}", false);

// Add checkbox to the chart.
sheet.Charts[0].Shapes.AddShapeInChart(MsoDrawingType.CheckBox, PlacementType.Move, 400, 400, 1000, 600);
sheet.Charts[0].Shapes[0].Text = "CheckBox 1";

// Save the excel file.
workbook.Save(outputDir + "InsertCheckboxInChartSheet_out.xlsx");

ileri konular

• Grafiğe WordArt Filigranı Ekleme