이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class PositionedImage

Paragraph에 고정된 고정된 위치 이미지 InlineImage와 달리 PositionedImage는 Element가 아닙니다. 상위 요소 또는 형제 Element가 없습니다. 대신 Paragraph 또는 ListItem에 고정되고 이 고정점의 오프셋을 통해 배치됩니다. PositionedImage에는 이를 참조하는 데 사용할 수 있는 ID가 있습니다.

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);

메서드

메서드	반환 유형	간략한 설명
`getAs(contentType)`	`Blob`	이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다.
`getBlob()`	`Blob`	이 객체 내의 데이터를 blob으로 반환합니다.
`getHeight()`	`Integer`	이미지의 높이를 픽셀 단위로 가져옵니다.
`getId()`	`String`	이미지의 ID를 가져옵니다.
`getLayout()`	`PositionedLayout`	이미지가 배치되는 방식을 나타내는 enum 값을 가져옵니다.
`getLeftOffset()`	`Number`	이미지의 오프셋(단위: 포인트)을 단락 왼쪽에서 가져옵니다.
`getParagraph()`	`Paragraph`	이미지가 고정된 `Paragraph`를 가져옵니다.
`getTopOffset()`	`Number`	이미지의 오프셋을 단락 상단에서부터 포인트 단위로 가져옵니다.
`getWidth()`	`Integer`	이미지 너비를 픽셀 단위로 가져옵니다.
`setHeight(height)`	`PositionedImage`	이미지의 높이를 픽셀 단위로 설정합니다.
`setLayout(layout)`	`PositionedImage`	이미지가 배치되는 방식의 정의를 설정합니다.
`setLeftOffset(offset)`	`PositionedImage`	이미지의 오프셋을 단락 왼쪽에서 픽셀 단위로 설정합니다.
`setTopOffset(offset)`	`PositionedImage`	이미지의 오프셋을 단락 상단에서부터 포인트 단위로 설정합니다.
`setWidth(width)`	`PositionedImage`	이미지의 너비를 픽셀 단위로 설정합니다.

자세한 문서

`getAs(contentType)`

이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. 이 메서드는 파일 이름에 적절한 확장자(예: 'myfile.pdf')를 추가합니다. 그러나 마지막 마침표 (있는 경우) 뒤에 오는 파일 이름 부분이 대체해야 할 기존 확장 프로그램이라고 가정합니다. 따라서 'ShoppingList.12.25.2014'가 'ShoppingList.12.25.pdf'가 됩니다.

전환의 일일 할당량을 보려면 Google 서비스 할당량을 참고하세요. 새로 생성된 Google Workspace 도메인에는 일시적으로 더 엄격한 할당량이 적용될 수 있습니다.

매개변수

이름	유형	설명
`contentType`	`String`	변환할 MIME 유형입니다. 대부분의 blob의 경우 `'application/pdf'`만 유효한 옵션입니다. BMP, GIF, JPEG 또는 PNG 형식의 이미지의 경우 `'image/bmp'`, `'image/gif'`, `'image/jpeg'`, `'image/png'` 중 하나도 유효합니다. Google Docs 문서의 경우 `'text/markdown'`도 유효합니다.

리턴

Blob: 데이터가 blob입니다.

`getBlob()`

이 객체 내의 데이터를 blob으로 반환합니다.

리턴

Blob: 데이터가 blob입니다.

`getHeight()`

이미지의 높이를 픽셀 단위로 가져옵니다.

리턴

Integer: 이미지의 높이(픽셀)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`getId()`

이미지의 ID를 가져옵니다.

리턴

String: 이미지 ID

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`getLayout()`

이미지가 배치되는 방식을 나타내는 enum 값을 가져옵니다.

리턴

PositionedLayout: 이미지 레이아웃

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`getLeftOffset()`

이미지의 오프셋(단위: 포인트)을 단락 왼쪽에서 가져옵니다.

리턴

Number: 왼쪽 단락의 왼쪽에서 이미지의 오프셋

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`getParagraph()`

이미지가 고정된 Paragraph를 가져옵니다.

리턴

Paragraph: 상위 단락

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`getTopOffset()`

이미지의 오프셋을 단락 상단에서부터 포인트 단위로 가져옵니다.

리턴

Number: 왼쪽 단락 상단에서 이미지의 오프셋

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`getWidth()`

이미지 너비를 픽셀 단위로 가져옵니다.

리턴

Integer: 이미지 너비(픽셀)

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setHeight(height)`

이미지의 높이를 픽셀 단위로 설정합니다.

매개변수

이름	유형	설명
`height`	`Integer`	이미지 높이(픽셀)

리턴

PositionedImage: 현재 객체

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setLayout(layout)`

이미지가 배치되는 방식의 정의를 설정합니다.

매개변수

이름	유형	설명
`layout`	`PositionedLayout`	레이아웃 모드를 나타내는 열거형

리턴

PositionedImage: 연결을 위한 this 객체

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setLeftOffset(offset)`

이미지의 오프셋을 단락 왼쪽에서 픽셀 단위로 설정합니다.

매개변수

이름	유형	설명
`offset`	`Number`	문단 왼쪽에서의 오프셋

리턴

PositionedImage: 연결을 위한 this 객체

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setTopOffset(offset)`

이미지의 오프셋을 단락 상단에서부터 포인트 단위로 설정합니다.

매개변수

이름	유형	설명
`offset`	`Number`	줄 상단에서의 오프셋

리턴

PositionedImage: 연결을 위한 this 객체

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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

`setWidth(width)`

이미지의 너비를 픽셀 단위로 설정합니다.

매개변수

이름	유형	설명
`width`	`Integer`	이미지 너비(픽셀)

리턴

PositionedImage: 현재 객체

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상의 승인이 필요합니다.

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