Grafiklerdeki Kontroller

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.

buŞekil Koleksiyonu sınıf adlı bir yöntem sağlaraddLabelInChart, bir grafiğe bir etiket kontrolü 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 birimlerinde etiketin genişliği.

Yöntem, bir nesne döndürürEtiket sınıf, neredeEtiketclass grafikte bir etiketi temsil eder. Aşağıda ayrıntıları verilen bazı önemli üyeleri vardır:

• Metinözelliği, bir etiketin başlık dizesini belirtir.
• Doldurmak özelliği, dolgu rengi niteliklerini belirtir.

Aşağıdaki örnek, grafiğe nasıl etiket ekleneceğini gösterir. Örnek, içinde grafik bulunan bir tasarımcı dosyası kullanır. Grafiğe bir etiket eklemek için bu dosyayı kullanıyoruz.

Aşağıda, tasarımcı dosyasının bir ekran görüntüsü bulunmaktadır.

tasarımcı grafiği

Grafiğe etiket eklemek için orijinal kod aşağıdadır. Kod yürütülürken aşağıdaki çıktı oluşturulur.

Grafiğe bir etiket eklendi

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingLabelControl.class) + "charts/";

String filePath = dataDir + "chart.xls";

Workbook workbook = new Workbook(filePath);

Worksheet worksheet = workbook.getWorksheets().get(0);

// Load the chart from source worksheet
Chart chart = worksheet.getCharts().get(0);

Label label = chart.getShapes().addLabelInChart(100, 100, 350, 900);
label.setText("Write Label here");
label.setPlacement(PlacementType.FREE_FLOATING);
label.getFill().getSolidFill().setColor(Color.getChocolate());

// Output the file
workbook.save(dataDir + "ALControl_out.xls");

// Print message
System.out.println("Label added to chart successfully.");

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. buŞekil Koleksiyonu sınıf adlı bir yöntem sağlaraddTextBoxInChart, bir 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, bir nesne döndürürMetin kutusu sınıf neredeMetin kutusuclass, grafikte bir metin kutusunu temsil eder.

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

Grafiğe bir metin kutusu eklemek için orijinal kod aşağıdadır. Kod yürütülürken aşağıdaki çıktı oluşturulur.

Grafiğe bir metin kutusu eklenir

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingTextBoxControl.class) + "charts/";
String filePath = dataDir + "chart.xls";

// Create a new Workbook.
// Open the existing file.
Workbook workbook = new Workbook(filePath);
Worksheet worksheet = workbook.getWorksheets().get(0);

// Load the chart from source worksheet
Chart chart = worksheet.getCharts().get(0);

// Add a new textbox to the chart.
TextBox txt = chart.getShapes().addTextBoxInChart(100, 100, 850, 2500);
txt.setText("Aspose");
txt.getFont().setItalic(true);
txt.getFont().setSize(20);
txt.getFont().setBold(true);

// Get the filformat of the textbox.
FillFormat fillformat = txt.getFill();
fillformat.setFillType(FillType.SOLID);
fillformat.getSolidFill().setColor(Color.getSilver());

// Get the lineformat type of the textbox.
LineFormat lineformat = txt.getLine();
lineformat.setWeight(2);
lineformat.setDashStyle(MsoLineDashStyle.SOLID);

// Output the file
workbook.save(dataDir + "ATBoxControl_out.xls");

// Print message
System.out.println("TextBox added to chart successfully.");

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.

buŞekil Koleksiyonu sınıf adlı bir yöntem sağlarResimInChart’a ekle, grafiğ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 nesne döndürürResim sınıf neredeResimclass, grafikteki bir resim nesnesini temsil eder.

Aşağıdaki örnek, grafiğe nasıl resim ekleneceğini gösterir. Örnek, içinde bir grafik bulunan önceki tasarımcı dosyasını kullanır. Bu dosyayı grafiğe bir resim eklemek için kullanıyoruz.

Grafiğe resim eklemek için orijinal kod aşağıdadır. Kod yürütülürken aşağıdaki çıktı üretilir

Grafiğe bir resim eklenir

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingPictureToChart.class) + "charts/";

String filePath = dataDir + "chart.xls";

FileInputStream stream = new FileInputStream(dataDir + "logo.jpg");

Workbook workbook = new Workbook(filePath);

Worksheet worksheet = workbook.getWorksheets().get(0);

// Load the chart from source worksheet
Chart chart = worksheet.getCharts().get(0);

Picture pic = chart.getShapes().addPictureInChart(50, 50, stream, 40, 40);
LineFormat lineformat = pic.getLine();

lineformat.setFillType(FillType.SOLID);
lineformat.getSolidFill().setColor(Color.getBlue());
lineformat.setDashStyle(MsoLineDashStyle.DASH_DOT_DOT);
// Output the file
workbook.save(dataDir + "APToChart_out.xls");

// Print message
System.out.println("Picture added to chart successfully.");

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-Java
// directories
String outputDir = Utils.Get_OutputDirectory();

// Instantiating a Workbook object
Workbook workbook = new Workbook();

// Adding a chart to the worksheet
int index = workbook.getWorksheets().add(SheetType.CHART);

Worksheet sheet = workbook.getWorksheets().get(index);
sheet.getCharts().addFloatingChart(ChartType.COLUMN, 0, 0, 1024, 960);
sheet.getCharts().get(0).getNSeries().add("{1,2,3}", false);

// Add checkbox to the chart.
sheet.getCharts().get(0).getShapes().addShapeInChart(MsoDrawingType.CHECK_BOX, PlacementType.MOVE, 400, 400, 1000, 600);
sheet.getCharts().get(0).getShapes().get(0).setText("CheckBox 1");

// Convert chart to image with additional settings
workbook.save(outputDir + "InsertCheckboxInChartSheet_out.xlsx");