Java スライドのチャートエンティティ

Java スライドのチャートエンティティの紹介

チャートは、プレゼンテーションでデータを視覚化するための強力なツールです。ビジネスレポート、学術プレゼンテーション、またはその他の形式のコンテンツを作成する場合でも、チャートは情報を効果的に伝えるのに役立ちます。Aspose.Slides for Java はチャートを操作するための強力な機能を備えているため、Java 開発者にとって頼りになる選択肢となっています。

前提条件

チャートエンティティの世界に飛び込む前に、次の前提条件が満たされていることを確認してください。

Java開発キット（JDK）がインストールされている
Aspose.Slides for Java ライブラリがダウンロードされ、プロジェクトに追加されました
Javaプログラミングの基礎知識

それでは、Aspose.Slides for Java を使用してグラフの作成とカスタマイズを始めましょう。

ステップ1: プレゼンテーションの作成

最初のステップは、チャートを追加する新しいプレゼンテーションを作成することです。プレゼンテーションを作成するためのコードスニペットを次に示します。

String dataDir = "Your Document Directory";
Presentation pres = new Presentation();

ステップ2: チャートの追加

プレゼンテーションの準備ができたら、グラフを追加します。この例では、マーカー付きのシンプルな折れ線グラフを追加します。手順は次のとおりです。

//最初のスライドにアクセスする
ISlide slide = pres.getSlides().get_Item(0);

//サンプルチャートの追加
IChart chart = slide.getShapes().addChart(ChartType.LineWithMarkers, 50, 50, 500, 400);

ステップ3: グラフタイトルのカスタマイズ

適切に定義されたチャートにはタイトルが必要です。チャートのタイトルを設定してみましょう。

//設定チャートタイトル
chart.setTitle(true);
chart.getChartTitle().addTextFrameForOverriding("");
IPortion chartTitle = chart.getChartTitle().getTextFrameForOverriding().getParagraphs().get_Item(0).getPortions().get_Item(0);
chartTitle.setText("Sample Chart");

ステップ4: グリッド線の書式設定

グラフの主グリッド線と副グリッド線の書式を設定できます。垂直軸のグリッド線の書式を設定してみましょう。

//値軸の主グリッド線の形式を設定する
chart.getAxes().getVerticalAxis().getMajorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.Solid);
chart.getAxes().getVerticalAxis().getMajorGridLinesFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
chart.getAxes().getVerticalAxis().getMajorGridLinesFormat().getLine().setWidth(5);
chart.getAxes().getVerticalAxis().getMajorGridLinesFormat().getLine().setDashStyle(LineDashStyle.DashDot);

//値軸の補助グリッド線の書式を設定する
chart.getAxes().getVerticalAxis().getMinorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.Solid);
chart.getAxes().getVerticalAxis().getMinorGridLinesFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.RED);
chart.getAxes().getVerticalAxis().getMinorGridLinesFormat().getLine().setWidth(3);

ステップ5: 値軸のカスタマイズ

数値軸の数値形式、最大値、最小値を制御できます。カスタマイズ方法は次のとおりです。

//値軸の数値形式の設定
chart.getAxes().getVerticalAxis().setNumberFormatLinkedToSource(false);
chart.getAxes().getVerticalAxis().setDisplayUnit(DisplayUnitType.Thousands);
chart.getAxes().getVerticalAxis().setNumberFormat("0.0%");

//設定チャートの最大値、最小値
chart.getAxes().getVerticalAxis().setAutomaticMajorUnit(false);
chart.getAxes().getVerticalAxis().setAutomaticMaxValue(false);
chart.getAxes().getVerticalAxis().setAutomaticMinorUnit(false);
chart.getAxes().getVerticalAxis().setAutomaticMinValue(false);
chart.getAxes().getVerticalAxis().setMaxValue(15f);
chart.getAxes().getVerticalAxis().setMinValue(-2f);
chart.getAxes().getVerticalAxis().setMinorUnit(0.5f);
chart.getAxes().getVerticalAxis().setMajorUnit(2.0f);

ステップ 6: 値軸タイトルの追加

グラフにさらに情報を追加するには、値軸にタイトルを追加します。

//値軸のタイトルの設定
chart.getAxes().getVerticalAxis().setTitle(true);
chart.getAxes().getVerticalAxis().getTitle().addTextFrameForOverriding("");
IPortion valtitle = chart.getAxes().getVerticalAxis().getTitle().getTextFrameForOverriding().getParagraphs().get_Item(0).getPortions().get_Item(0);
valtitle.setText("Primary Axis");

ステップ 7: カテゴリ軸の書式設定

通常はデータカテゴリを表すカテゴリ軸もカスタマイズできます。

//カテゴリ軸の主グリッド線の形式を設定する
chart.getAxes().getHorizontalAxis().getMajorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.Solid);
chart.getAxes().getHorizontalAxis().getMajorGridLinesFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.GREEN);
chart.getAxes().getHorizontalAxis().getMajorGridLinesFormat().getLine().setWidth(5);

//カテゴリ軸の補助グリッド線の書式設定
chart.getAxes().getHorizontalAxis().getMinorGridLinesFormat().getLine().getFillFormat().setFillType(FillType.Solid);
chart.getAxes().getHorizontalAxis().getMinorGridLinesFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.YELLOW);
chart.getAxes().getHorizontalAxis().getMinorGridLinesFormat().getLine().setWidth(3);

ステップ8: 凡例の追加

凡例はグラフ内のデータ系列を説明するのに役立ちます。凡例をカスタマイズしてみましょう。

//凡例テキストプロパティの設定
IChartPortionFormat txtleg = chart.getLegend().getTextFormat().getPortionFormat();
txtleg.setFontBold(NullableBool.True);
txtleg.setFontHeight(16);
txtleg.setFontItalic(NullableBool.True);
txtleg.getFillFormat().setFillType(FillType.Solid);
txtleg.getFillFormat().getSolidFillColor().setColor(Color.RED);

//重複するチャートなしでチャートの凡例を表示するよう設定する
chart.getLegend().setOverlay(true);

ステップ9: プレゼンテーションを保存する

最後に、グラフを含むプレゼンテーションを保存します。

pres.save(dataDir + "FormattedChart_out.pptx", SaveFormat.Pptx);