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

Class PositionedImage

Obraz ma stałą pozycję zakotwiczoną w elemencie Paragraph. W przeciwieństwie do InlineImage PositionedImage to nie Element. Nie ma elementu nadrzędnego ani rodzeństwa Element. Jest on zakotwiczony do elementu Paragraph lub ListItem i umieszczony na podstawie przesunięcia od tego kotwicy. PositionedImage ma identyfikator, którego można użyć do odwołania.

var body = DocumentApp.getActiveDocument().getBody();

// Append a new paragraph.
var paragraph = body.appendParagraph("New paragraph to anchor the image to.");
*
// Get an image in Drive from its ID.
var image = DriveApp.getFileById('ENTER_IMAGE_FILE_ID_HERE').getBlob();

// Add the PositionedImage with offsets (in points).
var posImage = paragraph.addPositionedImage(image)
    .setTopOffset(60)
    .setLeftOffset(40);

Metody

Metoda	Zwracany typ	Krótki opis
`getAs(contentType)`	`Blob`	Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
`getBlob()`	`Blob`	Zwraca dane wewnątrz tego obiektu jako blob.
`getHeight()`	`Integer`	Pobiera wysokość obrazu w pikselach.
`getId()`	`String`	Pobiera identyfikator obrazu.
`getLayout()`	`PositionedLayout`	Pobiera wartość enum, która pokazuje rozmieszczanie obrazu.
`getLeftOffset()`	`Number`	Pobiera w punktach odsunięcie obrazu w lewo od akapitu.
`getParagraph()`	`Paragraph`	Pobiera `Paragraph`, do którego jest zakotwiczony obraz.
`getTopOffset()`	`Number`	Pobiera w punktach przesunięcie od początku akapitu od góry.
`getWidth()`	`Integer`	Pobiera szerokość obrazu w pikselach.
`setHeight(height)`	`PositionedImage`	Ustawia wysokość obrazu w pikselach.
`setLayout(layout)`	`PositionedImage`	Ustawia definicję układu obrazu.
`setLeftOffset(offset)`	`PositionedImage`	Ustawia odsunięcie obrazu w punktach od lewego akapitu.
`setTopOffset(offset)`	`PositionedImage`	Ustawia odsunięcie obrazu w punktach od górnej części akapitu.
`setWidth(width)`	`PositionedImage`	Ustawia szerokość obrazu w pikselach.

Szczegółowa dokumentacja

`getAs(contentType)`

Zwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje odpowiednie rozszerzenie do nazwy pliku, np. „"myfile.pdf&quot”. Zakładamy jednak, że część nazwy pliku po ostatnim okresie (jeśli w ogóle) jest rozszerzeniem, które należy zastąpić. W związku z tym "ShoppingList.12.25.2014" zmienia się w "ShoppingList.12.25.pdf".

Aby sprawdzić dzienne limity konwersji, zobacz Limity usług Google. Nowo utworzone domeny Google Workspace mogą podlegać tymczasowym ograniczeniom.

Parametry

Nazwa	Typ	Opis
`contentType`	`String`	Typ MIME, na który ma zostać przekonwertowane. W większości blobów `'application/pdf'` jest jedyną prawidłową opcją. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowy jest też każdy z tych formatów: `'image/bmp'`, `'image/gif'`, `'image/jpeg'` lub `'image/png'`.

Zwróć

Blob – dane jako obiekt blob.

`getBlob()`

Zwraca dane wewnątrz tego obiektu jako blob.

Zwróć

Blob – dane jako obiekt blob.

`getHeight()`

Pobiera wysokość obrazu w pikselach.

Zwróć

Integer – wysokość obrazu w pikselach

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getId()`

Pobiera identyfikator obrazu.

Zwróć

String – identyfikator obrazu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getLayout()`

Pobiera wartość enum, która pokazuje rozmieszczanie obrazu.

Zwróć

PositionedLayout – układ obrazu

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getLeftOffset()`

Pobiera w punktach odsunięcie obrazu w lewo od akapitu.

Zwróć

Number – przesunięcie obrazu z lewego akapitu po lewej stronie,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getParagraph()`

Pobiera Paragraph, do którego jest zakotwiczony obraz.

Zwróć

Paragraph – akapit nadrzędny

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getTopOffset()`

Pobiera w punktach przesunięcie od początku akapitu od góry.

Zwróć

Number – przesunięcie obrazu z lewego akapitu na górze,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getWidth()`

Pobiera szerokość obrazu w pikselach.

Zwróć

Integer – szerokość obrazu w pikselach,

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setHeight(height)`

Ustawia wysokość obrazu w pikselach.

Parametry

Nazwa	Typ	Opis
`height`	`Integer`	wysokość obrazu w pikselach

Zwróć

PositionedImage – bieżący obiekt

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setLayout(layout)`

Ustawia definicję układu obrazu.

Parametry

Nazwa	Typ	Opis
`layout`	`PositionedLayout`	wyliczenie reprezentujące tryb układu

Zwróć

PositionedImage – ten obiekt do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setLeftOffset(offset)`

Ustawia odsunięcie obrazu w punktach od lewego akapitu.

Parametry

Nazwa	Typ	Opis
`offset`	`Number`	odsunięcie akapitu w lewo

Zwróć

PositionedImage – ten obiekt do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setTopOffset(offset)`

Ustawia odsunięcie obrazu w punktach od górnej części akapitu.

Parametry

Nazwa	Typ	Opis
`offset`	`Number`	przesunięcie od góry akapitu

Zwróć

PositionedImage – ten obiekt do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`setWidth(width)`

Ustawia szerokość obrazu w pikselach.

Parametry

Nazwa	Typ	Opis
`width`	`Integer`	szerokość obrazu w pikselach

Zwróć

PositionedImage – bieżący obiekt

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents