チャート内のコントロール

チャートにラベルコントロールを追加

ラベルは、スプレッドシートのコンテンツに関する情報をユーザーに提供する手段を提供します。Aspose.Cellsを使用して、チャートにラベルを追加および操作できます。

クラス ShapeCollection は、ラベルコントロールをチャートに追加するための addLabelInChart メソッドを提供します。以下は、メソッドに使用されるパラメータのリストです:

  • top - ラベルの上部左隅からの垂直オフセット、チャートエリアの1/4000単位。
  • left - ラベルの上部左隅からの水平オフセット、チャートエリアの1/4000単位。
  • height - ラベルの高さ、チャートエリアの1/4000単位。
  • width – ラベルの幅(チャート領域の1/4000単位)。

メソッドは、ラベルのチャート内の重要なメンバーを詳細に示す Label クラスのオブジェクトを返します。以下は、その重要なメンバーのいくつかです:

  • Text プロパティはラベルのキャプション文字列を指定します。
  • Fill プロパティは塗りつぶしの色の属性を指定します。

次の例は、チャートにラベルを追加する方法を示しています。この例では、チャートが含まれるデザイナーファイルを使用します。このファイルを使用して、チャートにラベルを挿入します。

以下は、デザイナーファイルのスクリーンショットです。

デザイナーチャート

todo:image_alt_text

チャートにラベルを追加するための元のコードは以下のとおりです。コードを実行すると、次の出力が生成されます。

チャートにラベルが追加されます

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

チャートにテキストボックスコントロールを追加

レポートで重要な情報を強調表示する一つの方法は、テキストボックスを使用することです。たとえば、企業名を表示したり、最高の売上地域を示したりするためにテキストを入力します。 ShapeCollection クラス には addTextBoxInChart という名前のメソッドがあり、これを使用してチャートにテキストボックスコントロールを追加します。以下は、このメソッドに使用されるパラメータのリストです:

  • top - テキストボックスの上部左隅からの垂直オフセット、チャートエリアの1/4000単位。
  • left – チャートエリアの左上隅からのテキストボックスの垂直オフセット(1/4000ユニット)。
  • height – テキストボックスの高さ、チャートエリアの1/4000単位で指定します。
  • width – テキストボックスの幅、チャートエリアの1/4000単位で指定します。

メソッドは、TextBoxクラスのオブジェクトを返します。TextBoxクラスは、チャート内のテキストボックスを表します。

次の例は、チャートにテキストボックスを追加する方法を示しています。この例では、前のデザイナーファイルを使用しています。このファイルを使用して、チャートにテキストボックスを挿入してチャートのタイトルを表示します。

以下は、チャートにテキストボックスを追加するための元のコードです。コードを実行すると、以下の出力が生成されます。

チャートにテキストボックスが追加されています

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

チャートに画像を追加する

Aspose.Cellsを使用すると、チャートに画像を挿入することができます。たとえば、チャートやその内容を強調したり、意味を追加するために画像を追加したり、ブランドのイメージファイルを挿入することができます。

ShapeCollection クラスは、画像オブジェクトをチャートに追加するために使用されるaddPictureInChartメソッドを提供します。以下は、メソッドに使用されるパラメータのリストです。

  • top – 画像の上部左隅からの垂直オフセット、チャートエリアの1/4000単位で指定します。
  • left – 画像の上部左隅からの水平オフセット、チャートエリアの1/4000単位で指定します。
  • stream – 画像データを含むストリームオブジェクト。
  • widthScale – 画像幅のスケール、パーセンテージ値。
  • heightScale – 画像の高さのスケール、パーセンテージ値。

メソッドは、Pictureクラスのオブジェクトを返します。Pictureクラスは、チャート内の画像オブジェクトを表します。

以下の例は、チャートに画像を追加する方法を示しています。この例では、前のデザイナーファイルを使用して、チャート内に画像を挿入しています。

以下は、チャートに画像を追加するための元のコードです。コードを実行すると、以下の出力が生成されます。

画像がチャートに挿入されます

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

チャートにチェックボックスを追加する

Aspose.Cellsを使用して、チャートシートにチェックボックスを挿入できます。次の例では、チャートシートにチェックボックスを追加する方法を示しています。

次の画像は、出力ファイルに含まれるチャートシートにチェックボックスが表示されています。

todo:image_alt_text

以下のコードスニペットによって生成された出力ファイルを参照のために添付します。

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