Class PositionedImage

PositionedImage

Obraz o stałej pozycji zakotwiczony w Paragraph. W przeciwieństwie do InlineImage, PositionedImage nie jest Element. Nie ma elementu nadrzędnego ani elementu równorzędnegoElement. Zamiast tego jest ona przytwierdzona do znaku Paragraph lub ListItem i umieszczana za pomocą przesunięć względem tego punktu. 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 w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści.
getBlob()	Blob	Zwraca dane w tym obiekcie jako obiekt blob.
getHeight()	Integer	Pobiera wysokość obrazu w pikselach.
getId()	String	Pobiera identyfikator obrazu.
getLayout()	PositionedLayout	Pobiera wartość wyliczeniową, która określa układ obrazu.
getLeftOffset()	Number	Pobiera przesunięcie obrazu (w punktach) od lewej strony akapitu.
getParagraph()	Paragraph	Zwraca Paragraph, do którego zakotwiczony jest obraz.
getTopOffset()	Number	Pobiera odsunięcie obrazu od góry akapitu (w punktach).
getWidth()	Integer	Pobiera szerokość obrazu w pikselach.
setHeight(height)	PositionedImage	Ustawia wysokość obrazu w pikselach.
setLayout(layout)	PositionedImage	Określa definicję układu obrazu.
setLeftOffset(offset)	PositionedImage	Ustawia odsunięcie obrazu od lewej strony akapitu (w punktach).
setTopOffset(offset)	PositionedImage	Ustawia odsunięcie obrazu od góry akapitu (w punktach).
setWidth(width)	PositionedImage	Ustawia szerokość obrazu w pikselach.

Szczegółowa dokumentacja

getAs(contentType)

Zwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, np. „mójplik.pdf”. Zakłada jednak, że część nazwy pliku, która następuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W konsekwencji nazwa „ShoppingList.12.25.2014” zmieni się na „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zapoznaj się z artykułem Limity 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 zostać przekonwertowany plik. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf'. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są też znaki 'image/bmp', 'image/gif', 'image/jpeg' i 'image/png'. W przypadku dokumentu Google 'text/markdown' jest również prawidłowy.

Powrót

Blob – dane w formie obiektu blob.

---

getBlob()

Zwraca dane w tym obiekcie jako obiekt blob.

Powrót

Blob – dane w formie obiektu blob.

---

getHeight()

Pobiera wysokość obrazu w pikselach.

Powrót

Integer – wysokość obrazu w pikselach.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

---

getLayout()

Pobiera wartość wyliczeniową, która określa układ obrazu.

Powrót

PositionedLayout – układ obrazu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 lewego akapitu.

Autoryzacja

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

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

---

getParagraph()

Zwraca Paragraph, do którego zakotwiczony jest obraz.

Powrót

Paragraph – akapit nadrzędny;

Autoryzacja

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

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

---

getTopOffset()

Pobiera odsunięcie obrazu od góry akapitu (w punktach).

Powrót

Number – przesunięcie obrazu od górnej krawędzi lewego akapitu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

Integer – szerokość obrazu w pikselach.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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;

Powrót

PositionedImage – bieżący obiekt

Autoryzacja

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

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

---

setLayout(layout)

Określa definicję układu obrazu.

Parametry

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

Powrót

PositionedImage – ten obiekt do łączenia w łańcuch

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 od lewej strony akapitu (w punktach).

Parametry

Nazwa	Typ	Opis
offset	Number	odsunięcie od lewej krawędzi akapitu,

Powrót

PositionedImage – ten obiekt do łączenia w łańcuch

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 od góry akapitu (w punktach).

Parametry

Nazwa	Typ	Opis
offset	Number	odsunięcie od górnej krawędzi akapitu,

Powrót

PositionedImage – ten obiekt do łączenia w łańcuch

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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;

Powrót

PositionedImage – bieżący obiekt

Autoryzacja

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

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