Travailler avec les formes
Travailler avec les formes
Aspose.Cells FOSS pour Java vous permet d’ajouter et de gérer des objets de dessin (formes auto) annexés aux cellules du feuille de travail. Les formes sont exposées par le ShapeCollection accessible via Worksheet.getShapes(). Chaque forme a un type géométrique, un modèle auto-formé, une position d’anchore à deux cellule.
Vue d’ensemble
Les formes dans un feuille de travail sont gérées par le «ShapeCollection» . Vous ajoutez une nouvelle forme avec le Shapecollection.add(autoShageType, upperLeftRow, UpperRownOffset, topLefTom, opperSelfTomb, hauteur, largeur) qui retourne l’indice basé sur zéro de la nouvelle image. Passez une valeur d’«AutoShakeTyp» pour spécifier la géométrie pré-déterminée.
Une fois qu’une forme est dans la collection, vous pouvez lire et écrire son nom, le type de géométrie, l’auto-formation et les positions cellulaires d’ancre.
Classes clés
| Class | Description |
|---|---|
Shape | Represents a drawing object (auto shape) with name, geometry, and cell-anchor position. |
ShapeCollection | Collection of all drawing shapes on a worksheet. Supports count, index access, add, and remove. |
AutoShapeType | Enum specifying the preset DrawingML geometry for a shape. |
ShapeModel | Internal serialization model for a shape. Exposes raw XML fields for advanced round-trip use. |
Ajouter une forme
Utilisez ‘ShapeCollection.add(…)’ pour insérer un objet de dessin.La méthode accepte:
- Un « AutoShapeType » pour la pré-section géométrique.
- L’anchor supérieur gauche (roue, offset de rang, colonne, opset d’une colonnade) - tous les intégrateurs basés sur zéro.
- La taille et la largeur de la forme en pixels.
La méthode retourne l’indice basé sur zéro de la nouvelle forme.
Les propriétés de la forme
Compte tenu d’un objet « forme », les méthodes de lecture suivantes sont disponibles :
- ‘Shape.getName()’ — la ligne de nom interne de la forme.
- ‘Shape.getGeometryType()’ — la ligne de type géométrie.
Shape.getAutoShapes()— la valeur enum de ‘Autoshapés’ .Shape.getUpperLeftRow()/ ` Shape .getupperLeftColumn()’ — la cellule de l’anchore à gauche supérieure.Shape.getLowerRightRow()/ ` Shape .getRowerColumn()’ — la cellule d’anchore à droite inférieure.
Propriétés de forme écrite
- « Shape.setName(nome)» — renommée de la forme.
- ‘Shape.setGeometryType(type)’ — modifier la ligne de type de géométrie.
Shape.setAutoShapesType(type)— modifier le pré-settant ‘AutoshapésTyp’.Shape.setUpperLeftRow(ro)/ ` Shape .setUperUppeColumn(col)‘ — réposition.Shape.setLowerRightRow(ro)/ ` Shape .setDowRighColumn(col)’ — réaffiche l’anchor.
Le résumé de référence API
forme
| Method | Return type | Description |
|---|---|---|
getName() | String | Internal name of the shape. |
setName(name) | void | Sets the internal name. |
getGeometryType() | String | Geometry type identifier string. |
setGeometryType(type) | void | Sets the geometry type string. |
getAutoShapeType() | AutoShapeType | Preset auto-shape geometry enum value. |
setAutoShapeType(type) | void | Sets the preset auto-shape geometry. |
getUpperLeftRow() | int | Row index of the top-left anchor cell. |
setUpperLeftRow(row) | void | Sets the top-left anchor row. |
getUpperLeftColumn() | int | Column index of the top-left anchor cell. |
setUpperLeftColumn(col) | void | Sets the top-left anchor column. |
getLowerRightRow() | int | Row index of the bottom-right anchor cell. |
setLowerRightRow(row) | void | Sets the bottom-right anchor row. |
getLowerRightColumn() | int | Column index of the bottom-right anchor cell. |
setLowerRightColumn(col) | void | Sets the bottom-right anchor column. |
Formation
| Method | Return type | Description |
|---|---|---|
getCount() | int | Number of shapes on the worksheet. |
get(index) | Shape | Returns the shape at the given zero-based index. |
add(...) | int | Adds a new shape; returns its collection index. |
removeAt(index) | void | Removes the shape at the given index. |
Voir aussi
- Aspose.Cells pour Java - Documentation d’entreprise