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

MetodaZwracany typKrótki opis
getAs(contentType)BlobZwraca dane z tego obiektu jako blob przekonwertowany na określony typ treści.
getBlob()BlobZwraca dane z tego obiektu jako blob.
getHeight()IntegerPobiera wysokość obrazu w pikselach.
getId()StringPobiera identyfikator obrazu.
getLayout()PositionedLayoutPobiera wartość typu enum, która reprezentuje sposób rozmieszczenia obrazu.
getLeftOffset()NumberPobiera przesunięcie obrazu (w punktach) od lewej strony akapitu.
getParagraph()ParagraphPobiera Paragraph, do którego jest zakotwiczony obraz.
getTopOffset()NumberZwraca odsunięcie obrazu w punktach od góry akapitu.
getWidth()IntegerPobiera szerokość obrazu w pikselach.
setHeight(height)PositionedImageOkreśla wysokość obrazu w pikselach.
setLayout(layout)PositionedImageOkreśla sposób rozmieszczenia obrazu.
setLeftOffset(offset)PositionedImageUstawia przesunięcie obrazu w punktach od lewej strony akapitu.
setTopOffset(offset)PositionedImageUstawia odsunięcie obrazu (w punktach) od góry akapitu.
setWidth(width)PositionedImageUstawia 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” zmieni nazwę na „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

NazwaTypOpis
contentTypeStringTyp 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 z tego obiektu 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

NazwaTypOpis
heightIntegerwysokość 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

NazwaTypOpis
layoutPositionedLayoutEnum 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

NazwaTypOpis
offsetNumberprzesunię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

NazwaTypOpis
offsetNumberodsunię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

NazwaTypOpis
widthIntegerszerokość 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