Working with Shapes

Werken met Shapes

Werken met vormen

Aspose.Cells FOSS voor Java stelt je in staat om tekenobjecten (auto-vormen) toe te voegen en te beheren die verankerd zijn aan werkbladcellen. Vormen worden blootgesteld via de ShapeCollection die toegankelijk is via Worksheet.getShapes(). Elke vorm heeft een geometrisch type, een auto-vormtype, een naam en een ankerpositie van twee cellen.

Overzicht

Vormen in een werkblad worden beheerd via de ShapeCollection. Je voegt een nieuwe vorm toe met ShapeCollection.add(autoShapeType, upperLeftRow, upperLeftRowOffset, upperLeftColumn, upperLeftColumnOffset, height, width), die de nulgebaseerde index van de nieuwe vorm retourneert. Geef een AutoShapeType waarde door om de vooraf ingestelde geometrie op te geven.

Zodra een vorm zich in de collectie bevindt, kun je de naam, het geometrische type, het auto-vormtype en de ankercelposities lezen en schrijven.

Belangrijke klassen

Klasse	Beschrijving
`Shape`	Stelt een tekenobject (auto-vorm) voor met naam, geometrie en cel-ankerpuntpositie.
`ShapeCollection`	Collectie van alle tekenvormen op een werkblad. Ondersteunt telling, indextoegang, toevoegen en verwijderen.
`AutoShapeType`	Enum die de vooraf ingestelde DrawingML geometrie voor een vorm specificeert.
`ShapeModel`	Intern serialisatiemodel voor een vorm. Biedt ruwe XML-velden bloot voor geavanceerd round-trip gebruik.

Een vorm toevoegen

Gebruik ShapeCollection.add(...) om een tekenobject in te voegen. De methode accepteert:

Een AutoShapeType waarde voor de geometrie-preset.
Het linkerboven-anker (rij, rij-offset, kolom, kolom-offset) — allemaal nulgebaseerde gehele getallen.
De hoogte en breedte van de vorm in pixels.

De methode retourneert de nulgebaseerde index van de nieuwe vorm.

Lezen van vormeigenschappen

Gegeven een Shape object, zijn de volgende lees-methoden beschikbaar:

Shape.getName() — de interne naam-string van de vorm.
Shape.getGeometryType() — de geometrie-type-string.
Shape.getAutoShapeType() — de AutoShapeType enum-waarde.
Shape.getUpperLeftRow() / Shape.getUpperLeftColumn() — de linkerbovenhoek ankercel.
Shape.getLowerRightRow() / Shape.getLowerRightColumn() — de rechteronderhoek ankercel.

Shape-eigenschappen schrijven

Shape.setName(name) — hernoem de vorm.
Shape.setGeometryType(type) — wijzig de geometry type string.
Shape.setAutoShapeType(type) — wijzig de AutoShapeType preset.
Shape.setUpperLeftRow(row) / Shape.setUpperLeftColumn(col) — verplaats.
Shape.setLowerRightRow(row) / Shape.setLowerRightColumn(col) — vergrootanker.

API Reference Samenvatting

Shape

Methode	Retourtype	Beschrijving
`getName()`	`String`	Interne naam van de vorm.
`setName(name)`	`void`	Stelt de interne naam in.
`getGeometryType()`	`String`	Geometrie-type identificatiestring.
`setGeometryType(type)`	`void`	Stelt de geometry type string in.
`getAutoShapeType()`	`AutoShapeType`	Vooraf ingestelde auto-shape geometrie enum-waarde.
`setAutoShapeType(type)`	`void`	Stelt de vooraf ingestelde auto-shape-geometrie in.
`getUpperLeftRow()`	`int`	Rij-index van de linkerboven-ankercel.
`setUpperLeftRow(row)`	`void`	Stelt de top-left anchor row in.
`getUpperLeftColumn()`	`int`	Kolom-index van de linkerboven-ankercel.
`setUpperLeftColumn(col)`	`void`	Stelt de linkerbovenste ankerkolom in.
`getLowerRightRow()`	`int`	Rij-index van de rechtsonder ankercel.
`setLowerRightRow(row)`	`void`	Stelt de rechtsonder ankerrij in.
`getLowerRightColumn()`	`int`	Kolomindex van de ankercel rechtsonder.
`setLowerRightColumn(col)`	`void`	Stelt de rechteronder-ankerkolom in.

ShapeCollection

Methode	Retourtype	Beschrijving
`getCount()`	`int`	Aantal vormen op het werkblad.
`get(index)`	`Shape`	Retourneert de vorm op de gegeven nulgebaseerde index.
`add(...)`	`int`	Voegt een nieuwe vorm toe; retourneert de index in de collectie.
`removeAt(index)`	`void`	Verwijdert de vorm op de opgegeven index.

Zie ook

Aspose.Cells for Java — Enterprise Documentation