Class PositionedImage

PositionedImage

Obraz o stałej pozycji zakotwiczony w elemencie Paragraph. W przeciwieństwie do InlineImage element PositionedImage jest nie Element. Nie ma Element nadrzędny lub potomny Element. Zamiast tego: jest zakotwiczony do Paragraph lub ListItem i jest umieszczany przez odsunięcia z tę kotwicę. Element PositionedImage ma identyfikator, którego można użyć, aby się do niego odwołać. 

var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().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

MetodaZwracany typKrótki opis
getAs(contentType)BlobZwraca dane wewnątrz tego obiektu jako obiekt blob przekonwertowany na określony typ treści.
getBlob()BlobZwraca dane wewnątrz tego obiektu jako obiekt blob.
getHeight()IntegerPobiera wysokość obrazu w pikselach.
getId()StringPobiera identyfikator obrazu.
getLayout()PositionedLayoutPobiera wartość wyliczeniową, która reprezentuje układ obrazu.
getLeftOffset()NumberPobiera przesunięcie obrazu (w punktach) od lewej krawędzi akapitu.
getParagraph()ParagraphPobiera Paragraph, do którego jest zakotwiczony obraz.
getTopOffset()NumberPobiera przesunięcie obrazu (w punktach) od góry akapitu.
getWidth()IntegerPobiera szerokość obrazu w pikselach.
setHeight(height)PositionedImageUstawia wysokość obrazu w pikselach.
setLayout(layout)PositionedImageOkreśla definicję układu zdjęcia.
setLeftOffset(offset)PositionedImageOkreśla przesunięcie obrazu (w punktach) od lewej krawędzi akapitu.
setTopOffset(offset)PositionedImageOkreśla przesunięcie obrazu (w punktach) od góry akapitu.
setWidth(width)PositionedImageUstawia 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. Ten dodaje do nazwy pliku odpowiednie rozszerzenie, na przykład „mojplik.pdf”. Jednak zakłada, że część nazwy pliku, która następuje po ostatnim kropce (jeśli występuje), jest już , które należy zastąpić. W rezultacie „ShoppingList.12.25.2014” zmienia się w „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zobacz Limity dla Google Usługi. Nowo utworzone domeny Google Workspace mogą być tymczasowo bardziej rygorystyczne limity.

Parametry

NazwaTypOpis
contentTypeStringTyp MIME do skonwertowania. W przypadku większości blobów atrybut 'application/pdf' to jedyną prawidłową opcją. W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG możesz też użyć dowolnego z tych atrybutów: 'image/bmp', 'image/gif', 'image/jpeg' lub 'image/png'. prawidłowe. W przypadku dokumentów w Dokumentach Google prawidłowa jest też wartość 'text/markdown'.

Powrót

Blob – dane w postaci obiektu blob.

getBlob()

Zwraca dane wewnątrz tego obiektu jako obiekt blob.

Powrót

Blob – dane w postaci 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 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 korzystające 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ść wyliczeniową, która reprezentuje układ obrazu.

Powrót

PositionedLayout – układ obrazu

Autoryzacja

Skrypty korzystające 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 krawędzi akapitu.

Powrót

Number – przesunięcie obrazu od lewej krawędzi akapitu.

Autoryzacja

Skrypty korzystające 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 korzystające 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()

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

Powrót

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

Autoryzacja

Skrypty korzystające 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 korzystające 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)

Ustawia wysokość obrazu w pikselach.

Parametry

NazwaTypOpis
heightIntegerwysokość obrazu w pikselach.

Powrót

PositionedImage – bieżący obiekt,

Autoryzacja

Skrypty korzystające 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 definicję układu zdjęcia.

Parametry

NazwaTypOpis
layoutPositionedLayoutwyliczenie reprezentujące tryb układu

Powrót

PositionedImage – ten obiekt służący do tworzenia łańcuchów,

Autoryzacja

Skrypty korzystające 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)

Określa przesunięcie obrazu (w punktach) od lewej krawędzi akapitu.

Parametry

NazwaTypOpis
offsetNumberprzesunięcie od lewej strony akapitu

Powrót

PositionedImage – ten obiekt służący do tworzenia łańcuchów,

Autoryzacja

Skrypty korzystające 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)

Określa przesunięcie obrazu (w punktach) od góry akapitu.

Parametry

NazwaTypOpis
offsetNumberodsunięcie od góry akapitu

Powrót

PositionedImage – ten obiekt służący do tworzenia łańcuchów,

Autoryzacja

Skrypty korzystające 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 korzystające 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