ShapeCollection
Panoramica
ShapeCollection è una classe in Aspose.Slides FOSS per C++.
Gestisce la raccolta di forme su una diapositiva. Opera in due modalità: - Modalità semplice (predefinito): le forme sono gestite solo in memoria. - XML-backed mode (dopo init_internal): le forme vengono caricate da e salvate nello spTree XML della diapositiva, con caching pigro.
Questa classe fornisce 49 metodi per lavorare con gli oggetti ShapeCollection nei programmi C++. I metodi disponibili includono: ShapeCollection, Table, add_auto_shape, add_auto_shape_impl, add_connector, add_connector_impl, add_picture_frame, add_picture_frame_impl, add_table, add_table_impl, as_i_collection, as_i_enumerable, e 25 metodi aggiuntivi. Tutti i membri pubblici sono accessibili a qualsiasi applicazione C++ dopo l’installazione del pacchetto Aspose.Slides FOSS per C++. Proprietà: ShapeCollection, Table.
Proprietà
| Nome | Tipo | Accesso | Descrizione |
|---|---|---|---|
ShapeCollection | ShapeCollection | Lettura | Ottiene la collezione di forme. |
Table | Table | Lettura | Ottiene la tabella. |
Metodi
| Firma | Descrizione |
|---|---|
ShapeCollection() → ShapeCollection | La proprietà fornisce l’accesso alla collezione stessa |
Table() → Table | La proprietà fornisce l’accesso alla forma Table associata alla collezione |
Table() → Table | |
ShapeCollection() | |
ShapeCollection() | |
init_internal(slide_part: Internal::pptx::SlidePart, parent_slide: IBaseSlide) | Inizializza da una parte della diapositiva, entrando in modalità basata su XML. |
parent_group() → IGroupShape | Restituisce la forma del gruppo genitore, oppure nullptr se è di livello superiore. |
as_i_collection() → IShapeCollection | Restituisce questa collezione come interfaccia di collezione generica. |
as_i_enumerable() → IShapeCollection | Restituisce questa collezione come interfaccia enumerabile generica. |
size() → std::size_t | Restituisce il numero di forme. |
to_array() → std::vector<Shape*> | Restituisce tutte le forme come puntatori non proprietari. |
to_array(start_index: std::size_t, count: std::size_t) → std::vector<Shape*> | Restituisce tutte le forme come puntatori non proprietari. |
reorder(new_index: std::size_t, shape: Shape) | Sposta una forma nella posizione specificata (z-order). |
reorder(index: std::size_t, shapes: std::span<Shape*>) | Sposta una forma nella posizione specificata (z-order). |
add_auto_shape(type: ShapeType, x: double, y: double, width: double, height: double) → AutoShape | Aggiunge un AutoShape alla collezione. |
add_auto_shape(type: ShapeType, x: double, y: double, width: double, height: double, create_from_template: bool) → AutoShape | Aggiunge un AutoShape alla collezione. |
insert_auto_shape(index: std::size_t, type: ShapeType, x: double, y: double, width: double, height: double) → AutoShape | Inserisce un AutoShape all’indice specificato. |
insert_auto_shape(index: std::size_t, type: ShapeType, x: double, y: double, width: double, height: double, create_from_template: bool) → AutoShape | Inserisce un AutoShape all’indice specificato. |
add_connector(type: ShapeType, x: double, y: double, width: double, height: double) → Connector | Aggiunge un Connector alla collezione. |
add_connector(type: ShapeType, x: double, y: double, width: double, height: double, create_from_template: bool) → Connector | Aggiunge un Connector alla collezione. |
insert_connector(index: std::size_t, type: ShapeType, x: double, y: double, width: double, height: double) → Connector | Inserisce un Connector all’indice specificato. |
insert_connector(index: std::size_t, type: ShapeType, x: double, y: double, width: double, height: double, create_from_template: bool) → Connector | Inserisce un Connector all’indice specificato. |
index_of(shape: Shape) → std::ptrdiff_t | Restituisce l’indice basato su zero di una forma, o -1 se non trovata. |
add_picture_frame(type: ShapeType, x: double, y: double, width: double, height: double, image: PPImage) → PictureFrame | Aggiunge un PictureFrame alla collezione. |
insert_picture_frame(index: std::size_t, type: ShapeType, x: double, y: double, width: double, height: double, image: PPImage) → PictureFrame | Inserisce un PictureFrame all’indice specificato. |
add_table(x: double, y: double, column_widths: std::span<const double>, row_heights: std::span<const double>) → Table | Aggiunge una Table alla collezione. |
insert_table(index: std::size_t, x: double, y: double, column_widths: std::span<const double>, row_heights: std::span<const double>) → Table | Inserisce una Tabella all’indice specificato. |
remove(shape: Shape) | Rimuove una forma dalla collezione per riferimento. |
remove_at(index: std::size_t) | Rimuove la forma all’indice fornito. |
clear() | Rimuove tutte le forme. |
table_count() → std::size_t | Restituisce il numero di tabelle nella collezione. |
table_at(index: std::size_t) → Table | Restituisce la tabella all’indice fornito. |
table_at(index: std::size_t) → Table | Restituisce la tabella all’indice fornito. |
begin() → iterator | Restituisce un iteratore alla prima forma |
end() → iterator | Restituisce un iteratore oltre l’ultima forma |
begin() → const_iterator | |
end() → const_iterator | |
get_sp_tree() → pugi::xml_node | Ottieni l’elemento spTree dalla diapositiva XML. |
load_shapes() | Carica tutte le forme dal XML, popolando la cache interna. No-op se la cache è già valida. |
invalidate_cache() | Invalidare la cache delle forme, forzando un ricaricamento al prossimo accesso. |
save_to_part() | Salva le modifiche alla parte della diapositiva. |
next_shape_id() → int | Trova il prossimo ID forma disponibile nello spTree. |
build_auto_shape_xml(sp: pugi::xml_node, shape_id: int, name: std::string_view, type: ShapeType, x: double, y: double, w: double, h: double, create_from_template: bool) | Genera il contenuto XML per un nuovo elemento AutoShape. |
build_connector_xml(cxn_sp: pugi::xml_node, shape_id: int, name: std::string_view, type: ShapeType, x: double, y: double, w: double, h: double, create_from_template: bool) | Crea contenuto XML per un nuovo elemento connettore (cxnSp). |
add_auto_shape_impl(index: std::optional<std::size_t>, type: ShapeType, x: double, y: double, w: double, h: double, create_from_template: bool) → AutoShape | Implementazione core per add_auto_shape e insert_auto_shape. |
add_connector_impl(index: std::optional<std::size_t>, type: ShapeType, x: double, y: double, w: double, h: double, create_from_template: bool) → Connector | Implementazione core per add_connector e insert_connector. |
add_picture_frame_impl(index: std::optional<std::size_t>, type: ShapeType, x: double, y: double, w: double, h: double, image: PPImage) → PictureFrame | Implementazione core per add_picture_frame e insert_picture_frame. |
add_table_impl(index: std::optional<std::size_t>, x: double, y: double, column_widths: std::span<const double>, row_heights: std::span<const double>) → Table | Implementazione core per add_table e insert_table. |
reorder_single(new_index: std::size_t, shape: Shape) | Riordina una singola forma in una nuova posizione in XML e nella cache. |
