Working with Shapes

シェイプの操作

Aspose.Cells FOSS for Java は、ワークシートのセルにアンカーされた描画オブジェクト（オートシェイプ）を追加および管理できるようにします。シェイプは、Worksheet.getShapes() からアクセスできる ShapeCollection を通じて公開されます。各シェイプにはジオメトリタイプ、オートシェイプタイプ、名前、そして 2 つのセルによるアンカー位置があります。

概要

ワークシート内のシェイプは ShapeCollection を通じて管理されます。新しいシェイプは ShapeCollection.add(autoShapeType, upperLeftRow, upperLeftRowOffset, upperLeftColumn, upperLeftColumnOffset, height, width) で追加し、これにより新しいシェイプのゼロベースインデックスが返されます。プリセットジオメトリを指定するには、AutoShapeType 値を渡します。

シェイプがコレクションに追加されると、その名前、ジオメトリタイプ、オートシェイプタイプ、アンカーセル位置を読み書きできます。

主要クラス

クラス	説明
`Shape`	名前、ジオメトリ、およびセルアンカー位置を持つ描画オブジェクト（オートシェイプ）を表します。
`ShapeCollection`	ワークシート上のすべての描画シェイプのコレクションです。カウント、インデックスアクセス、追加、削除をサポートします。
`AutoShapeType`	シェイプのプリセットDrawingMLジオメトリを指定する列挙型です。
`ShapeModel`	シェイプの内部シリアライズモデルです。高度な往復使用のために、生のXMLフィールドを公開します。

シェイプの追加

ShapeCollection.add(...) を使用して描画オブジェクトを挿入します。このメソッドは以下を受け取ります：

ジオメトリプリセット用の AutoShapeType 値です。
左上のアンカー（行、行オフセット、列、列オフセット）— すべてゼロベースの整数です。
形状の高さと幅（ピクセル単位）。

このメソッドは新しい形状のゼロベースインデックスを返します。

形状プロパティの読み取り

Shape オブジェクトがある場合、次の読み取りメソッドが利用可能です:

Shape.getName() — 形状の内部名文字列です。
Shape.getGeometryType() — ジオメトリタイプ文字列です。
Shape.getAutoShapeType() — AutoShapeType 列挙値です。
Shape.getUpperLeftRow() / Shape.getUpperLeftColumn() — 左上のアンカーセルです。
Shape.getLowerRightRow() / Shape.getLowerRightColumn() — 右下のアンカーセルです。

シェイププロパティの書き込み

Shape.setName(name) — シェイプの名前を変更します。
Shape.setGeometryType(type) — ジオメトリタイプ文字列を変更します。
Shape.setAutoShapeType(type) — AutoShapeType プリセットを変更します。
Shape.setUpperLeftRow(row) / Shape.setUpperLeftColumn(col) — 再配置します。
Shape.setLowerRightRow(row) / Shape.setLowerRightColumn(col) — リサイズアンカー。

API Reference の概要

Shape

メソッド	戻り値の型	説明
`getName()`	`String`	シェイプの内部名。
`setName(name)`	`void`	内部名を設定します。
`getGeometryType()`	`String`	ジオメトリタイプの識別子文字列。
`setGeometryType(type)`	`void`	ジオメトリタイプ文字列を設定します。
`getAutoShapeType()`	`AutoShapeType`	プリセット自動シェイプジオメトリ列挙値。
`setAutoShapeType(type)`	`void`	プリセットのオートシェイプジオメトリを設定します。
`getUpperLeftRow()`	`int`	左上アンカーセルの行インデックス。
`setUpperLeftRow(row)`	`void`	左上のアンカー行を設定します。
`getUpperLeftColumn()`	`int`	左上アンカーセルの列インデックス。
`setUpperLeftColumn(col)`	`void`	左上のアンカー列を設定します。
`getLowerRightRow()`	`int`	右下隅のアンカーセルの行インデックス。
`setLowerRightRow(row)`	`void`	右下のアンカー行を設定します。
`getLowerRightColumn()`	`int`	右下隅のアンカーセルの列インデックス。
`setLowerRightColumn(col)`	`void`	右下のアンカー列を設定します。

ShapeCollection

メソッド	戻り値の型	説明
`getCount()`	`int`	ワークシート上の図形の数。
`get(index)`	`Shape`	指定されたゼロベースのインデックスにある shape を返します。
`add(...)`	`int`	新しい形状を追加し、そのコレクションインデックスを返します。
`removeAt(index)`	`void`	指定されたインデックスの形状を削除します。

参照

Aspose.Cells for Java — Enterprise Documentation

シェイプの操作