Class PositionedImage

pozycjonowanyobraz

Obraz w stałym miejscu zakotwiczony w elementach Paragraph. W przeciwieństwie do InlineImage PositionedImage nie jest Element. nie ma rodzica ani rodzeństwa Element. Zamiast tego jest ona zadokowana do elementu Paragraph lub ListItem i jest umieszczana za pomocą przesunięć od tego elementu. Zasób PositionedImage ma identyfikator, za pomocą którego można się do niego odwoływać.

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Append a new paragraph.
const paragraph = body.appendParagraph('New paragraph to anchor the image to.');

// Get an image in Drive from its ID.
const image = DriveApp.getFileById('ENTER_IMAGE_FILE_ID_HERE').getBlob();

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

Metody

Metoda	Zwracany typ	Krótki opis
getAs(contentType)	Blob	Zwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści.
getBlob()	Blob	Zwraca dane w tym obiekcie jako blob.
getHeight()	Integer	Pobiera wysokość obrazu w pikselach.
getId()	String	Pobiera identyfikator obrazu.
getLayout()	PositionedLayout	Pobiera wartość typu enum, która reprezentuje sposób rozmieszczenia obrazu.
getLeftOffset()	Number	Pobiera przesunięcie obrazu (w punktach) od lewej strony akapitu.
getParagraph()	Paragraph	Pobiera Paragraph, do którego jest zakotwiczony obraz.
getTopOffset()	Number	Zwraca odsunięcie obrazu w punktach od góry akapitu.
getWidth()	Integer	Pobiera szerokość obrazu w pikselach.
setHeight(height)	PositionedImage	Określa wysokość obrazu w pikselach.
setLayout(layout)	PositionedImage	Określa sposób rozmieszczenia obrazu.
setLeftOffset(offset)	PositionedImage	Ustawia przesunięcie obrazu w punktach od lewej strony akapitu.
setTopOffset(offset)	PositionedImage	Ustawia odsunięcie obrazu (w punktach) od góry akapitu.
setWidth(width)	PositionedImage	Ustawia szerokość obrazu w pikselach.

Szczegółowa dokumentacja

getAs(contentType)

Zwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści. Ta metoda dodaje odpowiednie rozszerzenie do nazwy pliku, np. „mójplik.pdf”. Zakłada ona jednak, że część nazwy pliku, która następuje po ostatnim okresie (jeśli w ogóle występuje), to istniejące rozszerzenie, które należy zastąpić. W rezultacie plik „ShoppingList.12.25.2014” staje się „ShoppingList.12.25.pdf”.

Informacje o limitach dziennych konwersji znajdziesz w artykule Limity dotyczące usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.

Parametry

Nazwa	Typ	Opis
contentType	String	Typ MIME, na który ma nastąpić konwersja. W przypadku większości blobów opcja 'application/pdf' jest jedyną prawidłową opcją. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są również wartości 'image/bmp', 'image/gif', 'image/jpeg' lub 'image/png'. W przypadku dokumentu w Dokumentach Google możesz też użyć 'text/markdown'.

Powrót

Blob – dane w postaci bloba.

---

getBlob()

Zwraca dane w tym obiekcie jako blob.

Powrót

Blob – dane w postaci bloba.

---

getHeight()

Pobiera wysokość obrazu w pikselach.

Powrót

Integer – wysokość obrazu w pikselach.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getId()

Pobiera identyfikator obrazu.

Powrót

String – identyfikator obrazu

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getLayout()

Pobiera wartość typu enum, która reprezentuje sposób rozmieszczenia obrazu.

Powrót

PositionedLayout – układ obrazu.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getLeftOffset()

Pobiera przesunięcie obrazu (w punktach) od lewej strony akapitu.

Powrót

Number – przesunięcie obrazu od lewej strony akapitu

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym 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.

Powrót

Paragraph – akapit nadrzędny

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getTopOffset()

Zwraca odsunięcie obrazu w punktach od góry akapitu.

Powrót

Number – odsunięcie obrazu od lewego górnego rogu paragrafu

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getWidth()

Pobiera szerokość obrazu w pikselach.

Powrót

Integer – szerokość obrazu w pikselach.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setHeight(height)

Określa wysokość obrazu w pikselach.

Parametry

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

Powrót

PositionedImage – bieżący obiekt

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setLayout(layout)

Określa sposób rozmieszczenia obrazu.

Parametry

Nazwa	Typ	Opis
layout	PositionedLayout	Enum reprezentujący tryb układu.

Powrót

PositionedImage – ten obiekt do łańcucha;

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

setLeftOffset(offset)

Ustawia przesunięcie obrazu w punktach od lewej strony akapitu.

Parametry

Nazwa	Typ	Opis
offset	Number	przesunięcie od lewej strony akapitu

Powrót

PositionedImage – ten obiekt do łańcucha;

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym 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óry akapitu.

Parametry

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

Powrót

PositionedImage – ten obiekt do łańcucha;

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym 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.

Powrót

PositionedImage – bieżący obiekt

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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