Working with Shapes

Arbeiten mit Formen

Aspose.Cells FOSS für Java ermöglicht das Hinzufügen und Verwalten von Zeichenobjekten (Autoformen), die an Arbeitsblattzellen verankert sind. Formen werden über das ShapeCollection bereitgestellt, das über Worksheet.getShapes() zugänglich ist. Jede Form hat einen Geometrietyp, einen Autoform-Typ, einen Namen und eine Zwei-Zellen-Ankerposition.

Übersicht

Formen in einem Arbeitsblatt werden über das ShapeCollection verwaltet. Sie fügen eine neue Form mit ShapeCollection.add(autoShapeType, upperLeftRow, upperLeftRowOffset, upperLeftColumn, upperLeftColumnOffset, height, width) hinzu, die den nullbasierten Index der neuen Form zurückgibt. Übergeben Sie einen AutoShapeType-Wert, um die vordefinierte Geometrie anzugeben.

Sobald sich eine Form in der Sammlung befindet, können Sie ihren Namen, Geometrietyp, Autoform-Typ und die Ankerzellenpositionen lesen und schreiben.

Wichtige Klassen

Klasse	Beschreibung
`Shape`	Stellt ein Zeichenobjekt (Autoform) mit Name, Geometrie und Zell-Anker-Position dar.
`ShapeCollection`	Sammlung aller Zeichenformen in einem Arbeitsblatt. Unterstützt Zählen, Indexzugriff, Hinzufügen und Entfernen.
`AutoShapeType`	Enum, das die voreingestellte DrawingML-Geometrie für eine Form angibt.
`ShapeModel`	Internes Serialisierungsmodell für eine Form. Gibt rohe XML-Felder für fortgeschrittene Round-Trip-Verwendung frei.

Hinzufügen einer Form

Verwenden Sie ShapeCollection.add(...), um ein Zeichenobjekt einzufügen. Die Methode akzeptiert:

Ein AutoShapeType-Wert für die Geometrie-Voreinstellung.
Der obere linke Anker (Zeile, Zeilenoffset, Spalte, Spaltenoffset) — alle nullbasierten Ganzzahlen.
Die Höhe und Breite der Form in Pixeln.

Die Methode gibt den nullbasierten Index der neuen Form zurück.

Formeigenschaften lesen

Für ein Shape-Objekt stehen die folgenden Lesemethoden zur Verfügung:

Shape.getName() — die interne Namenszeichenkette der Form.
Shape.getGeometryType() — die Zeichenkette des Geometrietypus.
Shape.getAutoShapeType() — der AutoShapeType Enum-Wert.
Shape.getUpperLeftRow() / Shape.getUpperLeftColumn() — die obere linke Ankerzelle.
Shape.getLowerRightRow() / Shape.getLowerRightColumn() — die untere rechte Ankerzelle.

Shape-Eigenschaften schreiben

Shape.setName(name) — die Form umbenennen.
Shape.setGeometryType(type) — den Geometrietyp-String ändern.
Shape.setAutoShapeType(type) — die AutoShapeType-Voreinstellung ändern.
Shape.setUpperLeftRow(row) / Shape.setUpperLeftColumn(col) — neu positionieren.
Shape.setLowerRightRow(row) / Shape.setLowerRightColumn(col) — Anker zum Ändern der Größe.

API Reference Zusammenfassung

Shape

Methode	Rückgabetyp	Beschreibung
`getName()`	`String`	Interner Name der Form.
`setName(name)`	`void`	Setzt den internen Namen.
`getGeometryType()`	`String`	Geometrietyp-Bezeichner-String.
`setGeometryType(type)`	`void`	Setzt den Geometrietyp-String.
`getAutoShapeType()`	`AutoShapeType`	Voreinstellung für Auto-Shape-Geometrie-Enum-Wert.
`setAutoShapeType(type)`	`void`	Setzt die vordefinierte Autoform-Geometrie.
`getUpperLeftRow()`	`int`	Zeilenindex der oberen linken Ankerzelle.
`setUpperLeftRow(row)`	`void`	Setzt die obere linke Ankerzeile.
`getUpperLeftColumn()`	`int`	Spaltenindex der oberen linken Ankerzelle.
`setUpperLeftColumn(col)`	`void`	Setzt die obere linke Ankerspalte.
`getLowerRightRow()`	`int`	Zeilenindex der unteren rechten Ankerzelle.
`setLowerRightRow(row)`	`void`	Setzt die untere rechte Ankerzeile.
`getLowerRightColumn()`	`int`	Spaltenindex der unteren rechten Ankerzelle.
`setLowerRightColumn(col)`	`void`	Setzt die untere rechte Anker-Spalte.

ShapeCollection

Methode	Rückgabetyp	Beschreibung
`getCount()`	`int`	Anzahl der Formen im Arbeitsblatt.
`get(index)`	`Shape`	Gibt die Form am angegebenen nullbasierten Index zurück.
`add(...)`	`int`	Fügt eine neue Form hinzu; gibt deren Index in der Sammlung zurück.
`removeAt(index)`	`void`	Entfernt die Form am angegebenen Index.

Siehe auch

Aspose.Cells for Java — Enterprise Documentation