チャート内のコントロール
チャートにラベルコントロールを追加
ラベルは、スプレッドシートのコンテンツに関する情報をユーザーに提供する手段を提供します。Aspose.Cellsを使用して、チャートにラベルを追加および操作できます。
クラス ShapeCollection は、ラベルコントロールをチャートに追加するための addLabelInChart メソッドを提供します。以下は、メソッドに使用されるパラメータのリストです:
- top - ラベルの上部左隅からの垂直オフセット、チャートエリアの1/4000単位。
- left - ラベルの上部左隅からの水平オフセット、チャートエリアの1/4000単位。
- height - ラベルの高さ、チャートエリアの1/4000単位。
- width – ラベルの幅(チャート領域の1/4000単位)。
メソッドは、ラベルのチャート内の重要なメンバーを詳細に示す Label クラスのオブジェクトを返します。以下は、その重要なメンバーのいくつかです:
次の例は、チャートにラベルを追加する方法を示しています。この例では、チャートが含まれるデザイナーファイルを使用します。このファイルを使用して、チャートにラベルを挿入します。
以下は、デザイナーファイルのスクリーンショットです。
デザイナーチャート
チャートにラベルを追加するための元のコードは以下のとおりです。コードを実行すると、次の出力が生成されます。
チャートにラベルが追加されます
チャートにテキストボックスコントロールを追加
レポートで重要な情報を強調表示する一つの方法は、テキストボックスを使用することです。たとえば、企業名を表示したり、最高の売上地域を示したりするためにテキストを入力します。 ShapeCollection クラス には addTextBoxInChart という名前のメソッドがあり、これを使用してチャートにテキストボックスコントロールを追加します。以下は、このメソッドに使用されるパラメータのリストです:
- top - テキストボックスの上部左隅からの垂直オフセット、チャートエリアの1/4000単位。
- left – チャートエリアの左上隅からのテキストボックスの垂直オフセット(1/4000ユニット)。
- height – テキストボックスの高さ、チャートエリアの1/4000単位で指定します。
- width – テキストボックスの幅、チャートエリアの1/4000単位で指定します。
メソッドは、TextBoxクラスのオブジェクトを返します。TextBoxクラスは、チャート内のテキストボックスを表します。
次の例は、チャートにテキストボックスを追加する方法を示しています。この例では、前のデザイナーファイルを使用しています。このファイルを使用して、チャートにテキストボックスを挿入してチャートのタイトルを表示します。
以下は、チャートにテキストボックスを追加するための元のコードです。コードを実行すると、以下の出力が生成されます。
チャートにテキストボックスが追加されています
チャートに画像を追加する
Aspose.Cellsを使用すると、チャートに画像を挿入することができます。たとえば、チャートやその内容を強調したり、意味を追加するために画像を追加したり、ブランドのイメージファイルを挿入することができます。
ShapeCollection クラスは、画像オブジェクトをチャートに追加するために使用されるaddPictureInChartメソッドを提供します。以下は、メソッドに使用されるパラメータのリストです。
- top – 画像の上部左隅からの垂直オフセット、チャートエリアの1/4000単位で指定します。
- left – 画像の上部左隅からの水平オフセット、チャートエリアの1/4000単位で指定します。
- stream – 画像データを含むストリームオブジェクト。
- widthScale – 画像幅のスケール、パーセンテージ値。
- heightScale – 画像の高さのスケール、パーセンテージ値。
メソッドは、Pictureクラスのオブジェクトを返します。Pictureクラスは、チャート内の画像オブジェクトを表します。
以下の例は、チャートに画像を追加する方法を示しています。この例では、前のデザイナーファイルを使用して、チャート内に画像を挿入しています。
以下は、チャートに画像を追加するための元のコードです。コードを実行すると、以下の出力が生成されます。
画像がチャートに挿入されます
チャートにチェックボックスを追加する
Aspose.Cellsを使用して、チャートシートにチェックボックスを挿入できます。次の例では、チャートシートにチェックボックスを追加する方法を示しています。
次の画像は、出力ファイルに含まれるチャートシートにチェックボックスが表示されています。
以下のコードスニペットによって生成された出力ファイルを参照のために添付します。