Pagine, elementi di pagina e proprietà

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:

diagramma dell'architettura di Presentazioni

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:

diagramma dell'architettura dei temi

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:

diagramma in stile erd

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:

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:

ereditarietà delle proprietà slide

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".
di Gemini Advanced.

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:

ereditarietà delle proprietà della forma

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:

stato ed ereditarietà della proprietà

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.