Node.jsとC++を使ってワークシート内のシェイプを前面または背面に送る

可能な使用シナリオ

同じ場所に複数の図形が存在する場合、それらの可視性はz順序の位置によって決まります。Aspose.Cellsは Shape.toFrontOrBack() メソッドを提供しており、これにより図形のz順序の位置を変更できます。図形を背面に送るには-1、-2、-3などの負の数を使用し、前面に持ち上げるには1、2、3などの正の数を使用します。

ワークシート内でShape FrontまたはBackを送信する

次のサンプルコードは、Shape.toFrontOrBack()メソッドの使用例を説明しています。コード内で使用されているサンプルExcelファイルと、その出力として生成されたExcelファイルを参照してください。このコード実行時のサンプルExcelファイルへの効果を示したスクリーンショットもあります。

サンプルコード

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");
const sourceFilePath = path.join(dataDir, "sampleToFrontOrBack.xlsx");

// Load source Excel file
const workbook = new AsposeCells.Workbook(sourceFilePath);

// Access first worksheet
const worksheet = workbook.getWorksheets().get(0);

// Access first and fourth shape
const shape1 = worksheet.getShapes().get(0);
const shape4 = worksheet.getShapes().get(3);

// Print the Z-Order position of the shape
console.log("Z-Order Shape 1: " + shape1.getZOrderPosition());

// Send this shape to front
shape1.toFrontOrBack(2);

// Print the Z-Order position of the shape
console.log("Z-Order Shape 4: " + shape4.getZOrderPosition());

// Send this shape to back
shape4.toFrontOrBack(-2);

// Save the output Excel file
const outputFilePath = path.join(dataDir, "outputToFrontOrBack.xlsx");
workbook.save(outputFilePath);