Working with Shapes

Praca z kształtami

Aspose.Cells FOSS dla Java umożliwia dodawanie i zarządzanie obiektami rysunkowymi (auto-kształtami) zakotwionymi w komórkach arkusza. Kształty są udostępniane przez ShapeCollection dostępny za pośrednictwem Worksheet.getShapes(). Każdy kształt ma typ geometrii, typ auto-kształtu, nazwę oraz pozycję zakotwiczenia w dwóch komórkach.

Przegląd

Kształty w arkuszu są zarządzane przez ShapeCollection. Dodajesz nowy kształt za pomocą ShapeCollection.add(autoShapeType, upperLeftRow, upperLeftRowOffset, upperLeftColumn, upperLeftColumnOffset, height, width), który zwraca indeks zerowy nowego kształtu. Przekaż wartość AutoShapeType, aby określić predefiniowaną geometrię.

Gdy kształt znajduje się w kolekcji, możesz odczytywać i zapisywać jego nazwę, typ geometrii, typ auto-kształtu oraz pozycje komórek zakotwiczenia.

Kluczowe klasy

Klasa	Opis
`Shape`	Reprezentuje obiekt rysunku (auto shape) z nazwą, geometrią i pozycją kotwicy komórki.
`ShapeCollection`	Zbiór wszystkich kształtów rysunkowych na arkuszu. Obsługuje liczenie, dostęp indeksowy, dodawanie i usuwanie.
`AutoShapeType`	Wyliczenie określające wstępną geometrię DrawingML dla kształtu.
`ShapeModel`	Wewnętrzny model serializacji dla kształtu. Udostępnia surowe pola XML do zaawansowanego użycia round-trip.

Dodawanie kształtu

Użyj ShapeCollection.add(...), aby wstawić obiekt rysunkowy. Metoda przyjmuje:

Wartość AutoShapeType dla zestawu geometrycznego.
Górna lewa kotwica (wiersz, offset wiersza, kolumna, offset kolumny) — wszystkie liczby całkowite liczone od zera.
Wysokość i szerokość kształtu w pikselach.

Metoda zwraca indeks zerobazowy nowego kształtu.

Odczytywanie właściwości kształtu

Dla obiektu Shape dostępne są następujące metody odczytu:

Shape.getName() — wewnętrzny łańcuch nazwy kształtu.
Shape.getGeometryType() — łańcuch typu geometrycznego.
Shape.getAutoShapeType() — wartość wyliczeniowa AutoShapeType.
Shape.getUpperLeftRow() / Shape.getUpperLeftColumn() — komórka kotwicy w lewym górnym rogu.
Shape.getLowerRightRow() / Shape.getLowerRightColumn() — komórka kotwicy w prawym dolnym rogu.

Zapisywanie właściwości kształtu

Shape.setName(name) — zmień nazwę kształtu.
Shape.setGeometryType(type) — zmień ciąg typu geometrii.
Shape.setAutoShapeType(type) — zmień preset AutoShapeType.
Shape.setUpperLeftRow(row) / Shape.setUpperLeftColumn(col) — przesuń.
Shape.setLowerRightRow(row) / Shape.setLowerRightColumn(col) — kotwica zmiany rozmiaru.

API Reference Podsumowanie

Shape

Metoda	Typ zwracany	Opis
`getName()`	`String`	Wewnętrzna nazwa kształtu.
`setName(name)`	`void`	Ustawia wewnętrzną nazwę.
`getGeometryType()`	`String`	Ciąg identyfikatora typu geometrii.
`setGeometryType(type)`	`void`	Ustawia ciąg typu geometrii.
`getAutoShapeType()`	`AutoShapeType`	Wstępnie ustawiona wartość wyliczeniowa geometrii auto-kształtu.
`setAutoShapeType(type)`	`void`	Ustawia wstępną geometrię automatycznego kształtu.
`getUpperLeftRow()`	`int`	Indeks wiersza lewego górnego komórki kotwicy.
`setUpperLeftRow(row)`	`void`	Ustawia wiersz kotwicy w lewym górnym rogu.
`getUpperLeftColumn()`	`int`	Indeks kolumny lewego górnego komórki kotwicy.
`setUpperLeftColumn(col)`	`void`	Ustawia kolumnę kotwicy w lewym górnym rogu.
`getLowerRightRow()`	`int`	Indeks wiersza prawego dolnego komórki kotwicy.
`setLowerRightRow(row)`	`void`	Ustawia wiersz kotwicy w prawym dolnym rogu.
`getLowerRightColumn()`	`int`	Indeks kolumny prawej dolnej komórki kotwicy.
`setLowerRightColumn(col)`	`void`	Ustawia prawą dolną kolumnę kotwiczącą.

ShapeCollection

Metoda	Typ zwracany	Opis
`getCount()`	`int`	Liczba kształtów na arkuszu.
`get(index)`	`Shape`	Zwraca shape o podanym indeksie zerowym.
`add(...)`	`int`	Dodaje nowy kształt; zwraca jego indeks w kolekcji.
`removeAt(index)`	`void`	Usuwa kształt o podanym indeksie.

Zobacz także

Aspose.Cells for Java — Enterprise Documentation