Grafiklerde Kontroller

Grafiğe Etiket Denetimi Ekleme

Etiketler, bir elektronik tablonun içeriği hakkında kullanıcılara bilgi vermenin bir yolunu sağlar. Aspose.Cells, etiketleri hatta grafiklere bile eklemenize ve bunları manipüle etmenize olanak sağlar.

ShapeCollection sınıfı, bir etiket kontrolü eklemek için kullanılan addLabelInChart adında bir yöntem sağlar. Aşağıda bu yöntem için kullanılan parametrelerin bir listesi bulunmaktadır:

  • üst – etiketin sol üst köşesinden dikey ofset (1/4000 biriminde grafik alanı).
  • sol – etiketin sol üst köşesinden yatay ofset (1/4000 biriminde grafik alanı).
  • yükseklik – etiketin yüksekliği, grafik alanının 1/4000 biriminde.
  • Genişlik – etiketin genişliği, birim olarak 1/4000’lik chart alanının birimleri.

Yöntem, Label sınıfının bir nesnesini döndürür, burada Label sınıfı, tabloda bir etiketi temsil eder. Aşağıda bununla ilgili bazı önemli üyeler bulunmaktadır:

  • Text özelliği bir etiketin başlık dizesini belirtir.
  • Fill özelliği doldurma renk özelliklerini belirtir.

Aşağıdaki örnek, bir etiketi tabloya eklemenin nasıl yapıldığını göstermektedir. Örnek, bir grafik içeren bir tasarımcı dosyasını kullanır. Bu dosyayı bir etiketi grifiğe eklemek için kullanırız.

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

Tasarımcı grafik

todo:image_alt_text

Aşağıda, grafik üzerine bir etiket eklemek için orijinal kod bulunmaktadır. Kodu çalıştırdığınızda aşağıdaki çıktı oluşturulur.

Bir etiket grafik üzerine eklenir

todo:image_alt_text

// 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 TextBox Kontrolü Ekleme

Bir raporda önemli bilgileri vurgulamanın bir yolu, bir metin kutusu kullanmaktır. Örneğin, şirket adını vurgulamak veya en yüksek satış yapılan coğrafi bölgeyi belirtmek için metin girin. ShapeCollection sınıfı, grafiğe bir metin kutusu denetimi eklemek için kullanılan addTextBoxInChart adında bir yöntem sağlar. Aşağıdaki parametre listesi, yöntem için kullanılan parametreleri gösterir:

  • top – metin kutusunun grafik alanının sol üst köşesinden dikey ofseti, 1/4000 birimde.
  • sol – metin kutusunun grafik alanının sol üst köşesinden yatay ofseti, 1/4000 birim olarak.
  • height – metin kutusunun yüksekliği, grafik alanının 1/4000 biriminde.
  • width – metin kutusunun genişliği, grafik alanının 1/4000 biriminde.

Yöntem, bir TextBox sınıfının nesnesini döndürür. TextBox sınıfı, grafikte bir metin kutusunu temsil eder.

Aşağıdaki örnek, bir metin kutusunu bir grafik üzerine nasıl ekleyeceğinizi göstermektedir. Örnek, içinde grafik bulunan önceki tasarımcı dosyasını kullanır. Bu dosyayı kullanarak grafiğe bir metin kutusu ekleriz.

Grafik üzerine bir metin kutusu eklemek için orijinal kod aşağıda verilmektedir. Kodu çalıştırdığınızda aşağıdaki çıktı oluşturulur.

Bir metin kutusu grafik üzerine eklenir

todo:image_alt_text

// 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 eklemenize olanak tanır. Örneğin, bir resim ekleyerek bir grafiği vurgulamak veya anlamını artırmak veya bir marka resim dosyası eklemek.

ShapeCollection sınıfı, grafiğe bir resim nesnesi eklemek için kullanılan addPictureInChart adında bir yöntem sağlar. Aşağıdaki parametre listesi, yöntem için kullanılan parametreleri gösterir:

  • top – resmin, grafik alanının sol üst köşesinden dikey ofseti, 1/4000 birimde.
  • left – resmin, grafik alanının sol üst köşesinden dikey ofseti, 1/4000 birimde.
  • stream – resim verisini içeren bir akım nesnesi.
  • widthScale – resmin genişlik ölçeği, yüzde değeri.
  • heightScale – resmin yükseklik ölçeği, yüzde değeri.

Yöntem, Picture sınıfının bir nesnesini döndürür. Picture sınıfı, grafikte bir resim nesnesini temsil eder.

Aşağıdaki örnek, bir resmi bir grafik üzerine nasıl ekleyeceğinizi göstermektedir. Örnek, içinde grafik bulunan önceki tasarımcı dosyasını kullanır. Bu dosyayı kullanarak grafiğe bir resim ekleriz.

Aşağıda, grafik üzerine bir resim eklemek için orijinal kod bulunmaktadır. Kodu çalıştırdığınızda aşağıdaki çıktı oluşturulur.

Bir resim grafik içine eklenir

todo:image_alt_text

// 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, MsoDrawingType numaralandırmasını kullanarak bir grafik sayfasına onay kutuları eklemenize olanak tanır. Aşağıdaki örnek, bir grafik sayfasına bir onay kutusu eklemenin nasıl yapılacağını göstermektedir.

Aşağıdaki resim, çıktı dosyasındaki grafik tablosunu içeren onay kutusu göstermektedir.

todo:image_alt_text

Aşağıdaki kod parçası tarafından oluşturulan çıktı dosyası ekli olarak sunulmuştur.

// 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");