プレゼンテーションでPHPを使用してチャート ワークシート数式を適用する

プレゼンテーションにおけるチャートスプレッドシート数式について

Chart spreadsheet (または chart worksheet) はプレゼンテーション内のチャートのデータ ソースです。Chart spreadsheet にはデータが含まれ、チャート上にグラフィックで表されます。PowerPointでチャートを作成すると、このチャートに関連付けられたワークシートが自動的に作成されます。Chart worksheet はすべてのチャートタイプ (折れ線グラフ、棒グラフ、サンバースト グラフ、円グラフ など) で作成されます。PowerPoint で chart spreadsheet を表示するには、チャートをダブルクリックします：

todo:image_alt_text

Chart spreadsheet にはチャート要素の名前 (カテゴリ名: Category1、系列名) と、これらのカテゴリと系列に対応する数値データのテーブルが含まれています。デフォルトでは、新しいチャートを作成すると chart spreadsheet のデータは既定のデータで設定されます。その後、ワークシート上で手動でデータを変更できます。

通常、チャートは複雑なデータ (例: 金融アナリスト、科学アナリスト) を表し、他のセルの値や動的データから計算されたセルを持ちます。セルの値を手動で計算してハードコードすると、将来の変更が困難になります。特定のセルの値を変更すると、そのセルに依存するすべてのセルも更新する必要があります。さらに、テーブル データは他のテーブルのデータに依存することがあり、簡単かつ柔軟に更新できる複雑なプレゼンテーション データ スキームを作成します。

Chart spreadsheet formula はプレゼンテーション内で chart spreadsheet データを自動的に計算および更新する式です。スプレッドシート数式は特定のセルまたはセルの集合のデータ計算ロジックを定義します。数式はセル参照、数学関数、論理演算子、算術演算子、変換関数、文字列定数などを使用する数式または論理式です。数式の定義はセルに記述され、そのセルは単純な値を含みません。スプレッドシート数式は値を計算して返し、その値がセルに割り当てられます。プレゼンテーションの chart spreadsheet 数式は実際には Excel の数式と同じで、同じ既定の関数、演算子、定数がサポートされています。

Aspose.Slides の chart spreadsheet は ChartData::getChartDataWorkbook メソッドで ChartDataWorkbook 型として表されます。 スプレッドシート数式は ChartDataCell::setFormula メソッドで割り当ておよび変更できます。 Aspose.Slides でサポートされている数式機能は次のとおりです。

  • 論理定数
  • 数値定数
  • 文字列定数
  • エラー定数
  • 算術演算子
  • 比較演算子
  • A1 形式のセル参照
  • R1C1 形式のセル参照
  • 事前定義関数

通常、スプレッドシートは最後に計算された数式の値を保存します。プレゼンテーションの読み込み後にチャート データが変更されていない場合、ChartDataCell::getValue メソッドはそれらの値を返します。ただし、スプレッドシート データが変更された場合、読み取り時にサポートされていない数式に対して CellUnsupportedDataException がスローされます。これは、数式が正常に解析されるとセルの依存関係が決定され、最後の値の正確性が確認されるためです。数式が解析できない場合、セル値の正確性は保証できません。

プレゼンテーションにチャート スプレッドシート数式を追加する

最初に、ShapeCollection::addChart を使用して新しいプレゼンテーションの最初のスライドにチャートを追加します。チャートのワークシートは自動的に作成され、ChartData::getChartDataWorkbook メソッドでアクセスできます:

  $pres = new Presentation();
  try {
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::ClusteredColumn, 150, 150, 500, 300);
    $workbook = $chart->getChartData()->getChartDataWorkbook();
    # ...
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

次に、ChartDataCell::setValue メソッド (Object 型) を使用してセルにいくつかの値を書き込みます。Object 型なので任意の値を設定できます:

  $workbook->getCell(0, "F2")->setValue(-2.5);
  $workbook->getCell(0, "G3")->setValue(6.3);
  $workbook->getCell(0, "H4")->setValue(3);

数式を書き込むには、ChartDataCell::setFormula メソッドを使用します。

Note: ChartDataCell::setFormula メソッドは A1 形式のセル参照を設定するために使用されます。

R1C1 形式の数式を設定するには、ChartDataCell::setR1C1Formula メソッドを使用します。

その後、セル B2 と C2 の値を読み取ろうとすると、計算された結果が得られます:

  $value1 = $cell1->getValue();// 7.8

  $value2 = $cell2->getValue();// 2.1

論理定数

セル数式で FALSE および TRUE などの論理定数を使用できます:

  $workbook->getCell(0, "A2")->setValue(false);
  $cell = $workbook->getCell(0, "B2");
  $cell->setFormula("A2 = TRUE");
  $value = $cell->getValue();// 値はブール値 "false" を含みます

数値定数

数式では一般的な表記または科学的表記の数値を使用できます:

  $workbook->getCell(0, "A2")->setFormula("1 + 0.5");
  $workbook->getCell(0, "B2")->setFormula(".3 * 1E-2");

文字列定数

文字列 (リテラル) 定数はそのまま使用され、変更されません。文字列定数には日付、テキスト、数値などが含まれます:

  $workbook->getCell(0, "A2")->setFormula("\"abc\"");
  $workbook->getCell(0, "B2")->setFormula("\"2/3/2020 12:00\"");

エラー定数

数式で結果を計算できない場合、セルにはエラーコードが表示されます。各エラーには特定のコードがあります。

  • #DIV/0! - 数式がゼロで除算しようとした場合。
  • #GETTING_DATA - 値の計算中にセルに表示されることがあります。
  • #N/A - 情報が不足しているか利用できません。原因としては、数式で使用されるセルが空、余分なスペース文字、綴りミスなどがあります。
  • #NAME? - 指定されたセルまたは数式オブジェクトが名前で見つかりません。
  • #NULL! - 数式に誤りがある場合に発生します (例: (,) またはコロン (:) の代わりにスペース文字を使用)。
  • #NUM! - 数式内の数値が無効、桁数が多すぎる、または小さすぎるなど。
  • #REF! - 無効なセル参照。
  • #VALUE! - 予期しない型の値。例: 文字列を数値セルに設定した場合。
  $cell = $workbook->getCell(0, "A2");
  $cell->setFormula("2 / 0");
  $value = $cell->getValue();// 値は文字列 "#DIV/0!" を含みます

算術演算子

チャート ワークシート数式で使用できるすべての算術演算子:

演算子 意味 例
+ (プラス記号) 加算または単項プラス 2 + 3
- (マイナス記号) 減算または符号反転 2 - 3
-3
* (アスタリスク) 乗算 2 * 3
/ (スラッシュ) 除算 2 / 3
% (パーセント記号) パーセント 30%
^ (キャレット) 指数 2 ^ 3

Note: 評価順序を変更するには、先に計算したい部分を丸括弧で囲みます。

比較演算子

セルの値を比較する際に比較演算子を使用できます。これらの演算子で比較すると、結果は TRUE または FALSE の論理値になります:

演算子 意味 例
= (イコール) 等しい A2 = 3
<> (不等号) 等しくない A2 <> 3
> (大なり) より大きい A2 > 3
>= (大なりイコール) 以上 A2 >= 3
< (小なり) より小さい A2 < 3
<= (小なりイコール) 以下 A2 <= 3

A1 形式のセル参照

A1 形式のセル参照 は、列が文字識別子 (例: “A")、行が数字識別子 (例: “1") のワークシートで使用されます。使用例は次のとおりです:

セル参照 例
絶対参照 相対参照 混合参照
セル $A$2 A2

A$2

$A2
行 $2:$2 2:2 -
列 $A:$A A:A -
範囲 $A$2:$C$4 A2:C4

$A$2:C4

A$2:$C$4

A1 形式のセル参照を数式で使用する例:

  $workbook->getCell(0, "A2")->setFormula("C3 + SUM(F2:H5)");

R1C1 形式のセル参照

R1C1 形式のセル参照 は、行と列の両方が数字識別子のワークシートで使用されます。使用例は次のとおりです:

セル参照 例
絶対参照 相対参照 混合参照
セル R2C3 R[2]C[3] R2C[3]
R[2]C3
行 R2 R[2] -
列 C3 C[3] -
範囲 R2C3:R5C7 R[2]C[3]:R[5]C[7] R2C3:R[5]C[7]
R[2]C3:R5C[7]

R1C1 形式のセル参照を数式で使用する例:

  $workbook->getCell(0, "A2")->setR1C1Formula("R2C4 + SUM(R5C6:R7C9)");

事前定義関数

数式で使用できる事前定義関数があります。これらの関数は次のような一般的な操作を簡略化します:

  • ABS
  • AVERAGE
  • CEILING
  • CHOOSE
  • CONCAT
  • CONCATENATE
  • DATE (1900 日付システム)
  • DAYS
  • FIND
  • FINDB
  • IF
  • INDEX (参照形式)
  • LOOKUP (ベクトル形式)
  • MATCH (ベクトル形式)
  • MAX
  • SUM
  • VLOOKUP

FAQ

外部 Excel ファイルを数式付きチャートのデータ ソースとして使用できますか？

はい。Aspose.Slides は外部ブックを chart のデータ ソース としてサポートしており、プレゼンテーション外部の XLSX から数式を使用できます。

チャート数式は同じブック内のシート名でシートを参照できますか？

はい。数式は標準的な Excel 参照モデルに従うため、同じブック内または外部ブック内の他のシートを参照できます。外部参照の場合は、Excel の構文でパスとブック名を含めます。

PHPでプレゼンテーションチャートをフォーマットする PHPでPowerPointチャートをアニメーション化