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