Per utilizzare l'API Presentazioni in modo efficace, devi conoscere il dell'architettura delle presentazioni e dei loro componenti, nonché le interazioni tra questi componenti. In questa pagina viene fornita una panoramica dettagliata argomenti:
- Modello concettuale dei componenti della presentazione
- Rappresentazione di questi componenti da parte dell'API
- Proprietà di stile dei componenti
Leggendo questa panoramica e le altre panoramiche dei concetti, sarà più facile capire e utilizza le guide illustrative, il riferimento documentazione e la ricetta campioni.
Presentazioni, pagine ed elementi di pagina
L'elemento contenitore più esterno di Presentazioni Google è una presentazione. Questo è l'unità che può essere salvata su Google Drive, condivisa con altri utenti e così via.
Ogni presentazione contiene vari tipi di pagine. Un tipo di pagina è un una slide, ovvero le pagine su cui gli utenti vedere e passare da un momento all'altro della presentazione su uno schermo.
Ogni pagina contiene una serie di elementi pagina, che insieme costituiscono contenuti della pagina, come illustrato nel seguente diagramma:
Oltre alle slide, ci sono altri tipi di pagine che ti consentono di applicare la progettazione a diverse slide, creando un aspetto coerente. Questi altri tipi di pagina sono principali e layout e le loro proprietà determinano il modo in cui le slide come mostrato nel diagramma seguente:
Principali: la pagina principale ha due scopi. Segnaposto nell'istanza principale contiene i valori predefiniti per gli stili di testo utilizzati in tutta la presentazione. La sfondo e qualsiasi altra forma nella slide dello schema costituiscono l'impostazione predefinita. sfondo per tutte le slide in base a quello schema. Se hai un logo aziendale con che desideri venga visualizzato su ogni slide della presentazione, inseriscilo nello schema.
Layout: i modelli di layout determinano la disposizione dei contenuti per ogni tipo. della slide. Se vuoi che tutte le slide del titolo abbiano un determinato aspetto, ad esempio Ad esempio, puoi modificare il modello di layout del titolo.
Esistono altri due tipi di pagine (note e note) che Sono pertinenti principalmente per lavorare con le note del relatore.
Tipi e struttura della rappresentazione delle API
Questa sezione descrive come il modello concettuale di Presentazioni Google, come descritto di cui sopra, è rappresentato nell'API Presentazioni.
Il seguente diagramma illustra la relazione tra presentazioni, pagine ed elementi di pagina come tipi nell'API Presentazioni:
Le sezioni seguenti mostrano come questi tipi sono rappresentati in JSON.
Presentazioni
Una presentazione include una numero di proprietà e contiene le pagine al suo interno:
{
"presentationId": string,
"pageSize": { object(Size) },
"slides": [ { object(Page) } ],
"title": string,
"masters": [ { object(Page) } ],
"layouts": [ { object(Page) } ],
"notesMaster": object(Page),
"locale": string,
}
Pagine
Una pagina include un insieme di e contiene gli elementi di pagina al suo interno:
{
"objectId": string,
"pageType": enum(PageType),
"pageElements": [ { object(PageElement) } ],
"pageProperties": { object(PageProperties) },
// Union field properties can be only one of the following:
"slideProperties": { object(SlideProperties) },
"layoutProperties": { object(LayoutProperties) },
"notesProperties": { object(NotesProperties) },
// End of list of possible types for union field properties.
}
Elementi pagina
Elementi della pagina sono i componenti visivi posizionati nelle pagine. Un elemento di pagina nell'API contiene varie proprietà, incluso un campo che varia a seconda tipo di elemento pagina:
{
"objectId": string,
"size": { object(Size) },
"transform": { object(AffineTransform) },
"title": string,
"description": string,
// Union field element_kind can be only one of the following:
"elementGroup": { object(Group) },
"shape": { object(Shape) },
"image": { object(Image) },
"video": { object(Video) },
"line": { object(Line) },
"table": { object(Table) },
"wordArt": { object(WordArt) },
"sheetsChart": { object(SheetsChart) },
// End of list of possible types for union field element_kind.
}
Esistono diversi tipi di elementi di pagina, come definito dal campo Union
element_kind
nella definizione precedente. Questi tipi di elementi di pagina vengono
descritti nella seguente tabella:
Tipo di elemento | Descrizione |
---|---|
Gruppo | Un insieme di elementi di pagina trattati come una singola unità. Possono essere spostati, scalati e ruotati insieme. |
Shape | Un oggetto visivo semplice, come rettangoli, ellissi e caselle di testo. Le forme possono contenere testo e, pertanto, sono gli elementi di pagina più comuni per la creazione di slide. |
Immagine | Un'immagine importata in Presentazioni. |
Video | Un video importato in Presentazioni. |
Linea | Una linea, una curva o un connettore visiva. |
Tabella | Una griglia di contenuti. |
WordArt | Un elemento di testo visivo che si comporta più come una forma. |
SheetsChart | Un grafico importato in Presentazioni da Fogli Google. |
Proprietà degli elementi di pagina e di pagina
L'API Presentazioni ti consente di leggere e aggiornare l'aspetto di pagine e pagine elementi della presentazione. Supporto per diversi elementi di pagina diverse proprietà che controllano il rendering dell'elemento della pagina.
Ogni tipo di elemento di pagina ha un elemento e una proprietà di proprietà corrispondenti di aggiornamento, ad esempio:
- C'è un tipo di elemento della pagina Forma
- Il relativo campo proprietà è shapeProperties
- La richiesta per aggiornare queste proprietà è UpdateShapePropertiesRequest
Esiste lo stesso insieme di richieste di elementi/proprietà/aggiornamenti per ogni elemento della pagina tipo: Image/imageProperties/UpdateImageProperties, e così via.
Puoi leggere l'attributo proprietà ovunque lo trovi durante la lettura di un element; per modificare i valori al suo interno, utilizzala con il tipo di richiesta corrispondente come il payload per il comando batchUpdate , che permette di modificare questi valori nella presentazione.
Tipi di proprietà
Esistono alcune proprietà comuni tra i diversi tipi di oggetti in l'API Presentazioni:
Proprietà | Descrizione |
---|---|
Colore | I colori nell'API Presentazioni possono essere un valore RGB o un riferimento al colore di un tema. I colori del tema sono indicati per nome (ad esempio "DARK1") e possono essere mappati a valori RGB utilizzando una combinazione di colori della pagina. Questa combinazione di colori viene comunemente aggiornata quando si modifica il tema della presentazione nell'editor di Presentazioni. |
Riempi | Il riempimento rappresenta il rendering dello spazio vuoto all'interno di un oggetto. Il riempimento più comunemente supportato in Presentazioni è il riempimento a tinta unita, in cui l'interno di un oggetto viene riempito con un singolo colore a tinta unita. I riempimenti possono essere utilizzati anche per gli sfondi delle pagine. |
Contorno | Il contorno rappresenta l'insieme di linee che circondano l'elemento della pagina. Il colore delle linee è controllato dal Riempimento. I chiamanti possono anche regolare la larghezza e lo stile del trattino dei contorni. |
Ombre | L'ombra rappresenta un effetto visivo che riproduce un'ombra fisica proiettata dall'oggetto. Al momento, le ombre nell'API Presentazioni sono di sola lettura. |
Aggiornamento delle proprietà
Per aggiornare una proprietà, usa il
Update...Properties
richiesta in un
batchUpdate
, ad esempio UpdateShapeProperties
per Forme. Queste richieste
accetta un messaggio con le proprietà complete e può utilizzare
maschere di campo per determinare quali campi
deve essere aggiornato.
Eredità della proprietà
Una pagina o un elemento di pagina possono ereditare proprietà dagli oggetti principali. Un le proprietà di un oggetto, incluse quelle che definisce e quelle che eredita, determina il suo aspetto visivo finale.
- Proprietà della pagina: una pagina eredita tutte le proprietà che non possiede definire, ma che sono definite nel layout o master su cui si basa.
- Proprietà della forma: una forma può essere contrassegnata come segnaposto, consentendo fai riferimento in modo esplicito a un'altra forma segnaposto (nel layout principale della pagina) o principale) da cui ereditare le proprietà.
Queste idee sono illustrate più dettagliatamente nei paragrafi seguenti.
Ereditarietà delle proprietà della pagina
La struttura di slide, layout e schemi definisce una gerarchia di ereditarietà all'interno della presentazione: le slide ereditano dai layout, mentre i layout ereditano maestri. Il layout e lo schema principali di una slide sono specificati nella slide slideProperties .
Una pagina può ereditare proprietà, ad esempio background e color schema, da una pagina principale. Per ereditare una proprietà, la pagina secondaria non imposta semplicemente un per quella proprietà nel suo PageProperties . Non eseguendo l'override il valore definito dall'elemento principale, la pagina accetta il valore ereditato.
Il seguente diagramma mostra una slide che eredita le proprietà da un layout, che eredita da un master:
Le proprietà utilizzate per eseguire il rendering di una slide sono una combinazione di quelle che definisce quelle che eredita. In questo esempio, i valori risolti utilizzati per visualizzare la slide 1 sono i seguenti:
- ProprietàA è "Rosso".
- ProprietàB è "Arancia".
Ereditarietà delle proprietà delle forme
Le forme possono ereditare proprietà come riempimento, contorno o ombreggiatura da altri
forme. Una forma è un segnaposto se si trova
Shape.placeholder
. Il campo Shape.placeholder.parentObjectId
del segnaposto secondario
ne identifica il segnaposto principale. Quando crei una nuova slide basata su
, tutti i segnaposto in quel layout vengono visualizzati come forme secondarie nella nuova slide.
Analogamente, i segnaposto sulle pagine master possono fungere da elementi principali dei layout
segnaposto.
Con questa gerarchia di ereditarietà definita, la pagina secondaria eredita una proprietà non imposta quel valore nel suo ShapeProperties . Non eseguendo l'override del valore definito dall'elemento principale, la forma secondaria accetta il valore ereditato.
Il seguente diagramma mostra l'ereditarietà tra tre segnaposto contenuti in una slide, in un layout e in uno schema:
Le proprietà utilizzate per eseguire il rendering di una forma segnaposto sono una combinazione di quelle definisce e quelle che eredita. In questo esempio, i valori risolti forme sono i seguenti:
- Placeholder1: proprietàA viene visualizzata come "Giallo", proprietàB come "verde".
- Placeholder2: proprietàA viene visualizzata come "Giallo", proprietàB come "Viola".
- Placeholder3: proprietàA viene visualizzata come "Giallo", proprietàB come "Viola".
Le forme sono l'unico tipo di elemento di pagina che può avere elementi padre. Altri tipi, come immagini, tabelle e grafici, non possono essere segnaposto e non possono avere genitori.
"Nascondere" utilizzando ProprietàState
Il campo PropertyState
l'enumerazione controlla se la proprietà di una forma viene effettivamente utilizzata per il rendering,
o se il valore viene utilizzato solo per l'ereditarietà da forme secondarie. Una proprietà con
lo stato della proprietà NOT_RENDERED
non verrà utilizzato durante il rendering della forma
ma con stato proprietà corrispondente: RENDERED
possono comunque ereditare questa proprietà.
Il seguente diagramma mostra l'ereditarietà tra tre che manipolano il campo PropertyState:
Il rendering delle proprietà della forma può essere influenzato dal campo PropertyState. In questo esempio, i valori risolti per queste forme sono i seguenti:
- Placeholder1: proprietàA viene visualizzata come "Rosso".
- Placeholder2: proprietàA non visualizzato. Se si trattasse della proprietà della struttura, Il segnaposto 2 non ha un contorno.
- Placeholder3: proprietàA non visualizzato.
Esiste un altro possibile valore
Il campo PropertyState
enumerazione: lo stato della proprietà INHERIT
indica che lo stato della proprietà
viene ereditato e deve essere utilizzato il valore della risorsa padre. Forme senza
i publisher principali non possono avere uno stato della proprietà INHERIT
.