Esistono due modi diversi per ottenere e modificare le dimensioni e la posizione di un elemento della pagina:
- Utilizzando le funzioni getter e setter per le dimensioni e la posizione.
- Manipolare la trasformazione affine mediante le funzioni
getTransform()esetTransform()conservando la dimensione intrinseca.
Lettura delle proprietà degli elementi di pagina
Come mostrato nella figura, le dimensioni e la posizione vengono misurate rispetto al riquadro di delimitazione di un elemento di pagina sottoposto a rendering quando non ha rotazione:
- A sinistra e In alto: misurate dall'angolo in alto a sinistra della pagina all'angolo in alto a sinistra del riquadro di delimitazione non ruotato. Utilizza
getLeft()egetTop()per leggere i valori. - Larghezza e Altezza: la larghezza e l'altezza del riquadro di delimitazione non ruotato.
Utilizza
getWidth()egetHeight()per leggere i valori. - Rotazione: la rotazione in senso orario rispetto alla linea verticale attorno al centro del riquadro di delimitazione. Utilizza
getRotation()per leggere il valore.
Tutte le lunghezze sono misurate in punti (pt). La rotazione viene misurata in gradi (°).
Impostazione delle proprietà degli elementi della pagina
Puoi impostare le dimensioni e la posizione di un elemento della pagina quando lo crei utilizzando un metodo di inserimento come insertShape(). Per una forma esistente, puoi impostare le dimensioni, la posizione e la rotazione. Puoi anche impostare la scala di un elemento per ridimensionarlo o rifletterlo lungo uno dei suoi bordi.
Al momento della creazione
Puoi fornire informazioni su posizione e dimensioni durante la creazione di un elemento della pagina.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = slide.insertShape(SlidesApp.ShapeType.TEXT_BOX, 100, 200, 300, 60);
Logger.log('Left: ' + shape.getLeft() + 'pt; Top: '
+ shape.getTop() + 'pt; Width: '
+ shape.getWidth() + 'pt; Height: '
+ shape.getHeight() + 'pt; Rotation: '
+ shape.getRotation() + ' degrees.');
Lo script riportato sopra crea una forma nella prima diapositiva della presentazione attiva con le dimensioni e la posizione specificate e legge le informazioni su queste ultime. Il log previsto è:
Left: 100pt; Top: 200pt; Width: 300pt; Height: 60pt; Rotation: 0 degrees.
Dimensioni, posizione e rotazione
Puoi aggiornare le dimensioni e la posizione di un elemento della pagina dopo la creazione:
- Utilizza
setLeft()esetTop()per impostare la posizione dell'angolo in alto a sinistra del riquadro di delimitazione non ruotato. - Utilizza
setWidth()esetHeight()per impostare la larghezza e l'altezza visualizzate della delimitata. - Usa
setRotation()per impostare la rotazione in senso orario della casella delimitante attorno al suo centro.
Lo script seguente crea una forma nella prima diapositiva della presentazione attiva, utilizza i setter per aggiornarne la posizione, le dimensioni e la rotazione e legge le informazioni sulla posizione e sulle dimensioni della forma.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
shape.setLeft(100).setTop(200).setWidth(50).setHeight(60).setRotation(90);
Logger.log('Left: ' + shape.getLeft()
+ 'pt; Top: ' + shape.getTop()
+ 'pt; Width: ' + shape.getWidth()
+ 'pt; Height: ' + shape.getHeight()
+ 'pt; Rotation: ' + shape.getRotation() + '\u00B0.');
L'output del log previsto da questo script è mostrato di seguito:
Left: 100pt; Top: 200pt; Width: 50pt; Height: 60pt; Rotation: 90°.
I setter di dimensioni, posizione e rotazione possono essere utilizzati in qualsiasi ordine o combinazione. La sostituzione della terza riga sopra riportata con lo script seguente produrrà lo stesso risultato:
shape.setWidth(55);
shape.setRotation(90).setHeight(60).setLeft(100);
shape.setWidth(50).setTop(200);
Scalabilità
Invece di utilizzare setWidth() e setHeight() sopra per impostare le dimensioni della forma su un valore assoluto, scaleWidth() e scaleHeight() possono essere utilizzati per allungare o comprimere un elemento della pagina con un fattore di scala relativo.
shape.scaleHeight(0.5).scaleWidth(2);
La figura seguente mostra come funziona il codice riportato sopra su una forma quadrata ruotata di 45°. Tieni presente che l'angolo in alto a sinistra del riquadro di delimitazione è fisso durante il ridimensionamento.
Riflesso lungo il bordo
L'argomento in scaleWidth() e scaleHeight() può essere negativo, così da poter
utilizzare per capovolgere un elemento di pagina orizzontalmente o verticalmente.
shape.scaleWidth(-1); // Flip horizontally along the left edge of the bounding box.
shape.scaleHeight(-1); // Flip vertically along the top edge of the bounding box.
La figura seguente mostra come funziona il codice riportato sopra su una forma ruotata di 45°. Tieni presente che l'elemento pagina viene capovolto lungo uno dei bordi del suo riquadro delimitante, ma non nel suo centro.
Rotazione delle linee
Come per altri elementi della pagina, la rotazione di una linea non corrisponde all'angolo verticale della linea, ma alla rotazione del relativo riquadro di delimitazione. Quando crei una linea con punti di inizio e di fine specificati, la sua rotazione è sempre di 0°. Trascinando i punti finali della linea nell'interfaccia utente di Presentazioni Google ne modifichi l'angolo verticale, nonché le dimensioni e la posizione della sua area delimitata, ma non la rotazione. L'utilizzo di setRotation() ruota la casella delimitante della linea, che
modifica efficacemente il suo angolo verticale. Pertanto, due linee possono avere lo stesso angolo verticale visivo, ma riquadri di delimitazione diversi e, di conseguenza, dimensioni, posizione e valori di rotazione diversi.
Limitazioni
Alcuni metodi di dimensionamento e posizionamento non sono compatibili con alcuni tipi di elementi della pagina. La tabella di seguito riassume i metodi non compatibili con alcuni tipi di elementi di pagina.
| Metodi | Shape | Video | Tabella |
|---|---|---|---|
| getHeight(), getWidth() | ✔ | ✔ | NO (restituisce null) |
| setHeight(), setWidth() | ✔ | ✔ | NO |
| setRotation() | ✔ | NO | NO |
| scaleHeight(), scaleWidth() | ✔ | ✔ | NO |
Tutti i metodi di dimensionamento e posizionamento possono dare risultati imprevisti se l'elemento della pagina ha una distorsione. Tutte le limitazioni sono soggette a modifica. Consulta la documentazione di riferimento per informazioni aggiornate.
Utilizzo delle trasformazioni affine
Per il controllo avanzato, le dimensioni e la posizione di un elemento della pagina possono essere calcolate e regolate anche tramite le dimensioni intrinseche (native) e la trasformazione affine.
Google Apps Script offre un'interfaccia simile per utilizzare la trasformazione affine dell'API Presentazioni Google.
- Per leggere questo
articolo, vengono illustrati
i concetti di trasformazione affine e come dedurre le dimensioni visualizzate dalle dimensioni intrinsiche
(native) e dalla trasformazione per gli elementi della pagina. In Apps Script, utilizza
getInherentWidth()egetInherentHeight()per le dimensioni native degli elementi della pagina.getTransform()per la trasformazione affine degli elementi della pagina.
- Per scrivere, questo
articolo descrive
come ridimensionare e posizionare gli elementi della pagina utilizzando la trasformazione affine per ottenere
riscalatura, rotazione, riflessione e così via. In Apps Script, utilizza
setTransform()per impostare la trasformazione affine degli elementi della pagina (simile alla modalità ABSOLUTE);preconcatenateTransform()per pre-concatenare una trasformazione affine alla trasformazione attuale degli elementi della pagina (simile alla modalità RELATIVA).
Lo script seguente crea una forma, ne imposta la trasformazione, ne legge le dimensioni intrinseche e la trasformazione affine.
var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
shape.setTransform(SlidesApp.newAffineTransformBuilder()
.setScaleX(2)
.setScaleY(1)
.setTranslateX(100)
.setTranslateY(200)
.build());
Logger.log('Inherent width: ' + shape.getInherentWidth()
+ 'pt; Inherent height: '
+ shape.getInherentHeight() + 'pt.');
L'output del log previsto da questo script è il seguente:
Inherent width: 236.2pt; Inherent height: 236.2pt.
La forma risultante avrà la seguente trasformazione e le dimensioni e la posizione visualizzate:
AffineTransform{scaleX=2.0, scaleY=1.0, shearX=0.0, shearY=0.0, translateX=100.0, translateY=200.0}
Left: 100pt; Top: 200pt; Width: 472.4pt; Height: 236.2pt; Rotation: 0°.