チャートのコントロール

ラベル、テキスト ボックス、画像などの描画オブジェクトをグラフに挿入する必要がある場合があります。 Aspose.Cells は、実行時にチャートにコントロールを追加できます。

チャートへのラベル コントロールの追加

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

のシェイプコレクションクラスは、という名前のメソッドを提供しますaddLabelInChart、チャートにラベル コントロールを追加するために使用されます。以下は、メソッドに使用されるパラメーターのリストです。

• 上– グラフ領域の 1/4000 単位での左上隅からのラベルの垂直オフセット。
• 左– グラフ領域の 1/4000 単位での左上隅からのラベルの垂直オフセット。
• 身長– グラフ エリアの 1/4000 単位のラベルの高さ。
• 幅 – グラフ エリアの 1/4000 単位のラベルの幅。

メソッドは、ラベルクラス、ここでラベルクラスはチャートのラベルを表します。以下に詳述するように、いくつかの重要なメンバーがあります。

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

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

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

デザイナーチャート

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

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

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

TextBox コントロールをチャートに追加する

レポートで重要な情報を強調する 1 つの方法は、テキスト ボックスを使用することです。たとえば、テキストを入力して会社名を強調表示したり、売上高が最も多い地域を示したりします。のシェイプコレクションクラスは、という名前のメソッドを提供しますaddTextBoxInChart を使用して、テキスト ボックス コントロールをグラフに追加します。以下は、メソッドに使用されるパラメーター リストです。

• 上 – グラフ領域の 1/4000 単位での左上隅からのテキスト ボックスの垂直オフセット。
• 左 – グラフ領域の 1/4000 単位での左上隅からのテキスト ボックスの垂直オフセット。
• 身長– テキスト ボックスの高さ (グラフ領域の 1/4000 単位)。
• 幅 – テキスト ボックスの幅 (グラフ領域の 1/4000 単位)。

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

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

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

グラフにテキスト ボックスが追加されます

// 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 を使用すると、画像をグラフに挿入できます。たとえば、図を追加して図やその内容を強調したり意味を持たせたり、ブランド イメージ ファイルを挿入したりします。

のシェイプコレクションクラスは、という名前のメソッドを提供しますaddPictureInChart を使用して、画像オブジェクトをチャートに追加します。以下は、メソッドに使用されるパラメーター リストです。

• 上– グラフ領域の 1/4000 単位での左上隅からのピクチャの垂直オフセット。
• 左– グラフ領域の 1/4000 単位での左上隅からのピクチャの垂直オフセット。
• ストリーム– 画像データを含むストリーム オブジェクト。
• 幅スケール– 画像幅のスケール、パーセント値。
• 高さスケール– 画像の高さのスケール、パーセント値。

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

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

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

グラフに画像が挿入されます

// 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 を使用すると、チャート シートにチェックボックスを挿入できます。MsoDrawingType列挙。次の例は、グラフ シートにチェックボックスを追加する方法を示しています。

次の図は、出力ファイルにチェックボックスがあるグラフ シートを示しています。

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

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