Obraz o stałej pozycji zakotwiczony w elemencie Paragraph
. W przeciwieństwie do InlineImage
właściwość PositionedImage
nie jest wartością Element
. Nie ma elementu nadrzędnego ani równorzędnego Element
. Zamiast tego jest zakotwiczony do elementu Paragraph
lub ListItem
i jest umieszczony w przesunięciach od tej kotwicy. Element PositionedImage
ma identyfikator, który pozwala się do niego odwołać.
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 | Zwracaj dane wewnątrz tego obiektu jako obiekt blob. |
getHeight() | Integer | Pobiera wysokość obrazu w pikselach. |
getId() | String | Pobiera identyfikator obrazu. |
getLayout() | PositionedLayout | Pobiera wartość wyliczeniową, która reprezentuje sposób układu obrazu. |
getLeftOffset() | Number | Pobiera odsunięcie obrazu w punktach od lewej strony akapitu. |
getParagraph() | Paragraph | Pobiera Paragraph , do którego obraz jest zakotwiczony. |
getTopOffset() | Number | Pobiera odsunięcie obrazu w punktach od góry akapitu. |
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 | Określa odsunięcie obrazu w punktach od lewej strony akapitu. |
setTopOffset(offset) | PositionedImage | Określa odsunięcie obrazu w punktach od góry 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 do nazwy pliku odpowiednie rozszerzenie, na przykład „mójplik.pdf”. Zakładamy jednak, że część nazwy pliku, która występuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W związku z tym „Lista zakupów.12.25.2014” zmieni się na „Lista zakupów.12.25.pdf”.
Aby sprawdzić dzienne limity konwersji, przeczytaj artykuł Limity w usługach Google. Nowo utworzone domeny Google Workspace mogą tymczasowo podlegać bardziej rygorystycznym limitom.
Parametry
Nazwa | Typ | Opis |
---|---|---|
contentType | String | Typ MIME, na który ma zostać przekonwertowany. W przypadku większości obiektów blob jedyną prawidłową opcją jest 'application/pdf' . W przypadku zdjęć w formacie BMP, GIF, JPEG lub PNG obowiązują dowolne z tych wartości: 'image/bmp' , 'image/gif' , 'image/jpeg' i 'image/png' . |
Powroty
Blob
– dane w postaci obiektu blob.
getBlob()
getHeight()
Pobiera wysokość obrazu w pikselach.
Powroty
Integer
– wysokość obrazu w pikselach.
Upoważnienie
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.
Powroty
String
– identyfikator obrazu,
Upoważnienie
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 sposób układu obrazu.
Powroty
PositionedLayout
– układ obrazu,
Upoważnienie
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 odsunięcie obrazu w punktach od lewej strony akapitu.
Powroty
Number
– przesunięcie obrazu od lewej krawędzi akapitu.
Upoważnienie
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()
getTopOffset()
Pobiera odsunięcie obrazu w punktach od góry akapitu.
Powroty
Number
– odsunięcie obrazu od górnej krawędzi lewego akapitu;
Upoważnienie
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.
Powroty
Integer
– szerokość obrazu w pikselach.
Upoważnienie
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
Nazwa | Typ | Opis |
---|---|---|
height | Integer | wysokość obrazu w pikselach |
Powroty
PositionedImage
– bieżący obiekt,
Upoważnienie
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 obrazu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
layout | PositionedLayout | wyliczenie reprezentujące tryb układu |
Powroty
PositionedImage
– obiekt do tworzenia łańcuchów,
Upoważnienie
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 odsunięcie obrazu w punktach od lewej strony akapitu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Number | przesunięcie od lewej krawędzi akapitu |
Powroty
PositionedImage
– obiekt do tworzenia łańcuchów,
Upoważnienie
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 odsunięcie obrazu w punktach od góry akapitu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
offset | Number | przesunięcie od góry akapitu |
Powroty
PositionedImage
– obiekt do tworzenia łańcuchów,
Upoważnienie
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
Nazwa | Typ | Opis |
---|---|---|
width | Integer | szerokość obrazu w pikselach |
Powroty
PositionedImage
– bieżący obiekt,
Upoważnienie
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