Working with Shapes

Práce s tvary

Aspose.Cells FOSS pro Java vám umožňuje přidávat a spravovat kreslicí objekty (automatické tvary) ukotvené k buňkám listu. Tvary jsou zpřístupněny prostřednictvím ShapeCollection dostupného přes Worksheet.getShapes(). Každý tvar má typ geometrie, typ automatického tvaru, název a pozici ukotvení na dvou buňkách.

Přehled

Tvary v listu jsou spravovány prostřednictvím ShapeCollection. Nový tvar přidáte pomocí ShapeCollection.add(autoShapeType, upperLeftRow, upperLeftRowOffset, upperLeftColumn, upperLeftColumnOffset, height, width), který vrací nulově založený index nového tvaru. Předáte hodnotu AutoShapeType pro určení předdefinované geometrie.

Jakmile je tvar ve sbírce, můžete číst a zapisovat jeho název, typ geometrie, typ automatického tvaru a pozice ukotvení buňky.

Klíčové třídy

Třída	Popis:
`Shape`	Reprezentuje kreslicí objekt (auto shape) s názvem, geometrií a pozicí ukotvenou na buňce.
`ShapeCollection`	Sbírka všech kreslicích tvarů na listu. Podporuje počet, přístup indexem, přidání a odebrání.
`AutoShapeType`	Výčet určující předdefinovanou DrawingML geometrii pro tvar.
`ShapeModel`	Interní model serializace pro tvar. Zpřístupňuje surová XML pole pro pokročilé obousměrné použití.

Přidání tvaru

Použijte ShapeCollection.add(...) k vložení kreslicího objektu. Metoda přijímá:

Hodnota AutoShapeType pro předvolbu geometrie.
Kotva v levém horním rohu (řádek, offset řádku, sloupec, offset sloupce) — všechny celé čísla od nuly.
Výška a šířka tvaru v pixelech.

Metoda vrací index nového tvaru počítaný od nuly.

Čtení vlastností tvaru

Pro objekt Shape jsou k dispozici následující metody čtení:

Shape.getName() — interní řetězec názvu tvaru.
Shape.getGeometryType() — řetězec typu geometrie.
Shape.getAutoShapeType() — hodnota výčtu AutoShapeType.
Shape.getUpperLeftRow() / Shape.getUpperLeftColumn() — kotvící buňka v levém horním rohu.
Shape.getLowerRightRow() / Shape.getLowerRightColumn() — kotvící buňka v pravém dolním rohu.

Zápis vlastností tvaru

Shape.setName(name) — přejmenujte tvar.
Shape.setGeometryType(type) — změňte řetězec typu geometrie.
Shape.setAutoShapeType(type) — změňte předvolbu AutoShapeType.
Shape.setUpperLeftRow(row) / Shape.setUpperLeftColumn(col) — přemístěte.
Shape.setLowerRightRow(row) / Shape.setLowerRightColumn(col) — ukotvení změny velikosti.

API Reference Shrnutí

Shape

Metoda	Typ vrácení	Popis:
`getName()`	`String`	Interní název tvaru.
`setName(name)`	`void`	Nastavuje vnitřní název.
`getGeometryType()`	`String`	Řetězec identifikátoru typu geometrie.
`setGeometryType(type)`	`void`	Nastaví řetězec typu geometrie.
`getAutoShapeType()`	`AutoShapeType`	Přednastavená hodnota výčtu geometrie automatického tvaru.
`setAutoShapeType(type)`	`void`	Nastaví přednastavenou geometrii automatického tvaru.
`getUpperLeftRow()`	`int`	Index řádku levé horní kotvící buňky.
`setUpperLeftRow(row)`	`void`	Nastaví řádek levého horního ukotvení.
`getUpperLeftColumn()`	`int`	Index sloupce levé horní kotvící buňky.
`setUpperLeftColumn(col)`	`void`	Nastaví sloupec kotvy v levém horním rohu.
`getLowerRightRow()`	`int`	Index řádku pravé dolní kotvící buňky.
`setLowerRightRow(row)`	`void`	Nastaví řádek kotvy vpravo dole.
`getLowerRightColumn()`	`int`	Index sloupce pravé dolní kotvící buňky.
`setLowerRightColumn(col)`	`void`	Nastaví spodně pravý ukotvovací sloupec.

ShapeCollection

Metoda	Typ vrácení	Popis:
`getCount()`	`int`	Počet tvarů v listu.
`get(index)`	`Shape`	Vrací tvar na zadaném indexu počítaném od nuly.
`add(...)`	`int`	Přidá nový tvar; vrátí jeho index v kolekci.
`removeAt(index)`	`void`	Odstraní tvar na zadaném indexu.

Viz také:

Aspose.Cells for Java — Enterprise Documentation