Ta strona została przetłumaczona przez Cloud Translation API.

Rozmiary i położenie elementów strony

Rozmiar i pozycję elementu strony możesz uzyskać i zmienić na 2 sposoby:

za pomocą funkcji pobierania i ustawiania rozmiaru i pozycji;
manipulować jego przekształceniem afinicznym za pomocą funkcji getTransform() i setTransform(), zachowując jego rozmiar.

Odczytywanie właściwości elementów strony

Zmiana rozmiaru i obracanie

Jak pokazano na rysunku, rozmiar i pozycja są mierzone względem pola ograniczającego renderowanego elementu strony, gdy nie jest on obrócony:

Lewy i Górny: mierzone od lewego górnego rogu strony do lewego górnego rogu nieobróconego pola ograniczającego. Użyj znaków getLeft() i getTop(), aby odczytać wartości.
Szerokość i wysokość: szerokość i wysokość nieobróconego pola. Użyj znaków getWidth() i getHeight(), aby odczytać wartości.
Obrót: obrót w prawo względem linii pionowej wokół środka ramki ograniczającej. Użyj getRotation(), aby odczytać wartość.

Wszystkie długości są mierzone w punktach (pt). Obrót jest mierzony w stopniach (°).

Ustawianie właściwości elementów strony

Rozmiar i pozycję elementu strony możesz ustawić podczas jego tworzenia za pomocą metody wstawiania, np. insertShape(). W przypadku istniejącego kształtu możesz ustawić rozmiar, pozycję i obrót. Możesz też ustawić skalowanie elementu, aby zmienić jego rozmiar lub odbić go wzdłuż jednej z krawędzi.

W momencie tworzenia

Podczas tworzenia elementu strony możesz podać informacje o jego pozycji i rozmiarze.

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.');

Powyższy skrypt tworzy kształt na pierwszym slajdzie aktywnej prezentacji o określonym położeniu i rozmiarze oraz odczytuje informacje o położeniu i rozmiarze kształtu. Oczekiwany dziennik to:

Left: 100pt; Top: 200pt; Width: 300pt; Height: 60pt; Rotation: 0 degrees.

Rozmiar, położenie i obrót

Po utworzeniu elementu strony możesz zmienić jego rozmiar i pozycję:

Użyj przycisków setLeft() i setTop(), aby ustawić położenie lewego górnego rogu nieobróconego pola.
Użyj znaków setWidth() i setHeight(), aby ustawić renderowaną szerokość i wysokość ramki.
Użyj setRotation(), aby ustawić obrót prostokąta ograniczającego wokół jego środka zgodnie z ruchem wskazówek zegara.

Ten skrypt tworzy kształt na pierwszym slajdzie aktywnej prezentacji, używa funkcji ustawiających do aktualizowania jego pozycji, rozmiaru i obrotu oraz odczytuje informacje o pozycji i rozmiarze kształtu.

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.');

Oczekiwane dane wyjściowe logu z tego skryptu są takie jak poniżej:

Left: 100pt; Top: 200pt; Width: 50pt; Height: 60pt; Rotation: 90°.

Ustawienia rozmiaru, pozycji i rotacji można stosować w dowolnej kolejności i kombinacji. Zastąpienie trzeciego wiersza powyżej tym skryptem da ten sam wynik:

shape.setWidth(55);
shape.setRotation(90).setHeight(60).setLeft(100);
shape.setWidth(50).setTop(200);

Skalowanie

Zamiast używać powyższych wartości setWidth() i setHeight() do ustawiania rozmiaru kształtu na wartość bezwzględną, można użyć wartości scaleWidth() i scaleHeight(), aby rozciągnąć lub skompresować element strony za pomocą względnego współczynnika skalowania.

shape.scaleHeight(0.5).scaleWidth(2);

Ilustracja poniżej pokazuje, jak powyższy kod działa w przypadku kwadratu obróconego o 45°. Pamiętaj, że podczas skalowania lewy górny róg ramki pozostaje nieruchomy.

Skalowanie slajdów

Odbicie wzdłuż krawędzi

Argumenty w funkcjach scaleWidth() i scaleHeight() mogą być ujemne, dzięki czemu można ich używać do odwracania elementu strony w poziomie lub w pionie.

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.

Ilustracja poniżej pokazuje, jak powyższy kod działa w przypadku kształtu obróconego o 45°. Pamiętaj, że element strony jest odwracany wzdłuż jednej z krawędzi ramki ograniczającej, ale nie wzdłuż jej środka.

Odczucia dotyczące Prezentacji

Obrót linii

Podobnie jak w przypadku innych elementów strony, obrót linii nie jest kątem pionowym linii, ale obrotem jej ramki ograniczającej. Gdy utworzysz linię z określonymi punktami początkowym i końcowym, jej obrót zawsze wynosi 0°. Przeciąganie punktów końcowych linii w interfejsie Prezentacji Google zmienia jej kąt pionowy, a także rozmiar i położenie ramki ograniczającej, ale nie zmienia jej obrotu. Użycie setRotation() powoduje obrócenie ramki ograniczającej linii, co skutecznie zmienia jej kąt pionowy. Dwie linie mogą więc mieć ten sam kąt pionowy, ale różne ramki ograniczające, a co za tym idzie – różne wartości rozmiaru, położenia i obrotu.

Ograniczenia

Niektóre metody określania rozmiaru i położenia są niezgodne z niektórymi typami elementów strony. W tabeli poniżej znajdziesz podsumowanie metod, które nie są zgodne z niektórymi typami elementów strony.

Metody	Kształt	Wideo	Tabela
getHeight(), getWidth()	✔	✔	NIE (zwraca wartość null)
setHeight(), setWidth()	✔	✔	NIE
setRotation()	✔	NIE	NIE
scaleHeight(), scaleWidth()	✔	✔	NIE

Wszystkie metody określania rozmiaru i położenia mogą dawać nieoczekiwane wyniki, jeśli element strony jest poddany ścinaniu. Wszystkie ograniczenia mogą ulec zmianie. Aktualne informacje znajdziesz w materiałach referencyjnych.

Korzystanie z przekształceń afinicznych

Aby uzyskać zaawansowaną kontrolę, rozmiar i pozycję elementu strony można też obliczyć i dostosować za pomocą jego wbudowanego (natywnego) rozmiaru i przekształcenia afinicznego.

Google Apps Script udostępnia interfejs podobny do interfejsu Google Slides API, który umożliwia korzystanie z przekształcenia afinicznego.

W tym artykule wyjaśniamy pojęcia związane z przekształceniem afinicznym oraz sposób określania renderowanego rozmiaru elementów strony na podstawie ich rozmiaru natywnego i przekształcenia. W Apps Script użyj
- getInherentWidth() i getInherentHeight() w przypadku natywnego rozmiaru elementów strony;
- getTransform() – przekształcenie afiniczne elementów strony.
- setTransform() – aby ustawić transformację afiniczną elementów strony (podobnie jak w przypadku trybu ABSOLUTE);
- preconcatenateTransform(), aby wstępnie połączyć transformację afiniczną z bieżącą transformacją elementów strony (podobnie jak w przypadku trybu RELATIVE).

Ten skrypt tworzy kształt, ustawia jego przekształcenie, odczytuje jego rozmiar i odczytuje jego przekształcenie afiniczne.

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.');