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

Class Shape

PageElement은 더 구체적인 분류가 없는 일반적인 모양을 나타냅니다. 텍스트 상자, 직사각형, 기타 사전 정의된 도형이 포함됩니다.

방법

메서드	반환 유형	간략한 설명
`alignOnPage(alignmentPosition)`	`Shape`	요소를 페이지의 지정된 정렬 위치에 정렬합니다.
`bringForward()`	`Shape`	페이지 요소를 한 요소씩 페이지에서 앞으로 가져옵니다.
`bringToFront()`	`Shape`	페이지 요소를 페이지 앞으로 가져옵니다.
`duplicate()`	`PageElement`	페이지 요소를 복사합니다.
`getAutofit()`	`Autofit`	이 도형 내에서 텍스트의 `Autofit`를 반환합니다.
`getBorder()`	`Border`	도형의 `Border`를 반환합니다.
`getConnectionSites()`	`ConnectionSite[]`	페이지 요소에 있는 `ConnectionSite` 목록을 반환하거나 페이지 요소에 연결 사이트가 없는 경우 빈 목록을 반환합니다.
`getContentAlignment()`	`ContentAlignment`	도형에 있는 텍스트의 `ContentAlignment`를 반환합니다.
`getDescription()`	`String`	페이지 요소의 대체 텍스트 설명을 반환합니다.
`getFill()`	`Fill`	도형의 `Fill`를 반환합니다.
`getHeight()`	`Number`	요소의 높이(포인트)를 가져옵니다. 이는 요소의 회전이 없을 때 요소의 경계 상자 높이입니다.
`getInherentHeight()`	`Number`	요소의 고유한 높이를 포인트로 반환합니다.
`getInherentWidth()`	`Number`	요소의 고유한 너비를 포인트로 반환합니다.
`getLeft()`	`Number`	요소에 회전이 없을 때 페이지 왼쪽 상단에서 측정한 요소의 가로 위치를 반환합니다.
`getLink()`	`Link`	링크가 없으면 `Link` 또는 `null`를 반환합니다.
`getObjectId()`	`String`	이 객체의 고유 ID를 반환합니다.
`getPageElementType()`	`PageElementType`	`PageElementType` enum으로 표시된 페이지 요소 유형을 반환합니다.
`getParentGroup()`	`Group`	이 페이지 요소가 속한 그룹을 반환하거나 요소가 그룹에 없는 경우 `null`를 반환합니다.
`getParentPage()`	`Page`	이 페이지 요소가 있는 페이지를 반환합니다.
`getParentPlaceholder()`	`PageElement`	자리표시자의 상위 페이지 요소를 반환합니다.
`getPlaceholderIndex()`	`Integer`	도형의 자리표시자 색인을 반환합니다.
`getPlaceholderType()`	`PlaceholderType`	도형의 자리표시자 유형을 반환합니다. 도형이 자리표시자가 아니면 `PlaceholderType.NONE`를 반환합니다.
`getRotation()`	`Number`	가운데를 중심으로 한 요소의 시계 방향 회전 각도를 반환합니다. 여기서 0도는 회전하지 않음을 의미합니다.
`getShapeType()`	`ShapeType`	도형의 유형을 반환합니다.
`getText()`	`TextRange`	도형의 텍스트 콘텐츠를 반환합니다.
`getTitle()`	`String`	페이지 요소의 대체 텍스트 제목을 반환합니다.
`getTop()`	`Number`	요소에 회전이 없을 때 페이지 왼쪽 상단에서 측정한 요소의 세로 위치를 가져옵니다.
`getTransform()`	`AffineTransform`	페이지 요소의 변환을 반환합니다.
`getWidth()`	`Number`	요소의 너비(포인트)를 반환합니다. 이는 요소의 회전이 없을 때 요소의 경계 상자 너비입니다.
`preconcatenateTransform(transform)`	`Shape`	제공된 변환을 페이지 요소의 기존 변환에 연결합니다.
`remove()`	`void`	페이지 요소를 삭제합니다.
`removeLink()`	`void`	`Link`를 삭제합니다.
`replaceWithImage(blobSource)`	`Image`	이 도형을 `BlobSource`에서 제공한 이미지로 바꿉니다.
`replaceWithImage(blobSource, crop)`	`Image`	이 도형을 `BlobSource`에서 제공한 이미지로 바꿉니다.
`replaceWithImage(imageUrl)`	`Image`	이 도형을 이미지로 바꿉니다.
`replaceWithImage(imageUrl, crop)`	`Image`	이 도형을 이미지로 바꿉니다.
`replaceWithSheetsChart(sourceChart)`	`SheetsChart`	이 도형을 Google Sheets 차트로 대체합니다.
`replaceWithSheetsChartAsImage(sourceChart)`	`Image`	이 도형을 Google Sheets 차트의 이미지로 바꿉니다.
`scaleHeight(ratio)`	`Shape`	요소의 높이를 지정된 비율로 조정합니다.
`scaleWidth(ratio)`	`Shape`	요소의 너비를 지정된 비율로 조정합니다.
`select()`	`void`	활성 프레젠테이션에서 `PageElement`만 선택하고 이전 선택사항은 삭제합니다.
`select(replace)`	`void`	활성 프레젠테이션에서 `PageElement`을(를) 선택합니다.
`sendBackward()`	`Shape`	페이지 요소를 한 요소씩 페이지에서 뒤로 보냅니다.
`sendToBack()`	`Shape`	페이지 요소를 페이지 뒤로 보냅니다.
`setContentAlignment(contentAlignment)`	`Shape`	도형에 있는 텍스트의 `ContentAlignment`를 설정합니다.
`setDescription(description)`	`Shape`	페이지 요소의 대체 텍스트 설명을 설정합니다.
`setHeight(height)`	`Shape`	요소의 높이를 포인트 단위로 설정합니다. 이는 요소의 회전이 없을 때 요소의 경계 상자 높이입니다.
`setLeft(left)`	`Shape`	요소에 회전이 없을 때 페이지 왼쪽 상단에서 측정한 요소의 가로 위치를 설정합니다.
`setLinkSlide(slideIndex)`	`Link`	슬라이드의 0 기반 색인을 사용하여 `Link`를 지정된 `Slide`로 설정합니다.
`setLinkSlide(slide)`	`Link`	`Link`를 지정된 `Slide`로 설정하며 링크는 지정된 슬라이드 ID로 설정됩니다.
`setLinkSlide(slidePosition)`	`Link`	슬라이드의 상대 위치를 사용하여 `Link`를 지정된 `Slide`로 설정합니다.
`setLinkUrl(url)`	`Link`	`Link`를 지정된 비어 있지 않은 URL 문자열로 설정합니다.
`setRotation(angle)`	`Shape`	요소의 중심을 중심으로 한 시계 방향 회전 각도를 도 단위로 설정합니다.
`setTitle(title)`	`Shape`	페이지 요소의 대체 텍스트 제목을 설정합니다.
`setTop(top)`	`Shape`	요소에 회전이 없을 때 페이지 왼쪽 상단에서 측정한 포인트의 세로 위치를 설정합니다.
`setTransform(transform)`	`Shape`	제공된 변환을 사용하여 페이지 요소의 변환을 설정합니다.
`setWidth(width)`	`Shape`	요소의 너비를 포인트로 설정합니다. 이는 요소의 회전이 없을 때 요소의 경계 상자 너비입니다.

자세한 문서

`alignOnPage(alignmentPosition)`

요소를 페이지의 지정된 정렬 위치에 정렬합니다.

매개변수

이름	유형	설명
`alignmentPosition`	`AlignmentPosition`	이 페이지 요소를 페이지에서 정렬할 위치입니다.

Return 키

Shape: 체인을 위한 페이지 요소입니다.

`bringForward()`

페이지 요소를 한 요소씩 페이지에서 앞으로 가져옵니다.

페이지 요소가 그룹에 포함되어서는 안 됩니다.

Return 키

Shape: 체인을 위한 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`bringToFront()`

페이지 요소를 페이지 앞으로 가져옵니다.

페이지 요소가 그룹에 포함되어서는 안 됩니다.

Return 키

Shape: 체인을 위한 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`duplicate()`

페이지 요소를 복사합니다.

중복 페이지 요소는 원본과 동일한 위치에 같은 페이지에 배치됩니다.

Return 키

PageElement: 이 페이지 요소의 새로운 중복 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getAutofit()`

이 도형 내에서 텍스트의 Autofit를 반환합니다. 도형이 텍스트를 허용하지 않으면 null입니다.

Return 키

Autofit - 이 도형 내에서 텍스트가 자동 조정됩니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getBorder()`

도형의 Border를 반환합니다.

Return 키

Border: 이 도형의 테두리 설정입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getConnectionSites()`

페이지 요소에 있는 ConnectionSite 목록을 반환하거나 페이지 요소에 연결 사이트가 없는 경우 빈 목록을 반환합니다.

Return 키

ConnectionSite[] — 연결 사이트 목록입니다. 이 요소에 연결 사이트가 없으면 비어 있을 수 있습니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getContentAlignment()`

도형에 있는 텍스트의 ContentAlignment를 반환합니다.

Return 키

ContentAlignment - 이 도형 내의 텍스트 정렬입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getDescription()`

페이지 요소의 대체 텍스트 설명을 반환합니다. 설명은 제목과 결합되어 대체 텍스트를 표시하고 읽습니다.

Return 키

String: 페이지 요소의 대체 텍스트 설명입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getFill()`

도형의 Fill를 반환합니다.

Return 키

Fill: 이 도형의 채우기 설정입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getHeight()`

요소의 높이(포인트)를 가져옵니다. 이는 요소의 회전이 없을 때 요소의 경계 상자 높이입니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 배치 제한사항을 참고하세요.

Return 키

Number: 페이지 요소의 고유한 높이(포인트) 또는 페이지 요소에 높이가 없는 경우 null입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getInherentHeight()`

요소의 고유한 높이를 포인트로 반환합니다.

페이지 요소의 변환은 고유한 크기를 기준으로 합니다. 요소의 변환과 함께 고유한 크기를 사용하여 요소의 최종 시각적 모양을 결정합니다.

Return 키

Number: 페이지 요소의 고유한 높이(포인트) 또는 페이지 요소에 높이가 없는 경우 null입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getInherentWidth()`

요소의 고유한 너비를 포인트로 반환합니다.

페이지 요소의 변환은 고유한 크기를 기준으로 합니다. 요소의 변환과 함께 고유한 크기를 사용하여 요소의 최종 시각적 모양을 결정합니다.

Return 키

Number: 페이지 요소의 고유한 너비(포인트) 또는 페이지 요소에 너비가 없는 경우 null입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getLeft()`

요소에 회전이 없을 때 페이지 왼쪽 상단에서 측정한 요소의 가로 위치를 반환합니다.

Return 키

Number: 페이지 왼쪽 상단 모서리에서부터 요소의 가로 방향 위치입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getLink()`

링크가 없으면 Link 또는 null를 반환합니다.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

Return 키

Link

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getObjectId()`

이 객체의 고유 ID를 반환합니다. 페이지 및 페이지 요소에서 사용하는 객체 ID는 동일한 네임스페이스를 공유합니다.

Return 키

String - 이 객체의 고유 ID입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getPageElementType()`

PageElementType enum으로 표시된 페이지 요소 유형을 반환합니다.

Return 키

PageElementType: 페이지 요소의 유형입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getParentGroup()`

이 페이지 요소가 속한 그룹을 반환하거나 요소가 그룹에 없는 경우 null를 반환합니다.

Return 키

Group: 이 페이지 요소가 속한 그룹 또는 null입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getParentPage()`

이 페이지 요소가 있는 페이지를 반환합니다.

Return 키

Page: 이 요소가 속한 페이지입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getParentPlaceholder()`

자리표시자의 상위 페이지 요소를 반환합니다. 도형이 자리표시자가 아니거나 상위가 없으면 null를 반환합니다.

Return 키

PageElement - 이 도형 자리표시자의 상위 페이지 요소 또는 도형이 자리표시자가 아니거나 상위 요소가 없는 경우 null입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getPlaceholderIndex()`

도형의 자리표시자 색인을 반환합니다. 동일한 자리표시자 유형의 인스턴스가 두 개 이상 같은 경우 각 인스턴스는 고유한 색인 값을 갖습니다. 도형이 자리표시자가 아니면 null를 반환합니다.

Return 키

Integer: 이 도형의 자리표시자 색인 또는 도형이 자리표시자가 아닌 경우 null입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getPlaceholderType()`

도형의 자리표시자 유형을 반환합니다. 도형이 자리표시자가 아니면 PlaceholderType.NONE를 반환합니다.

Return 키

PlaceholderType: 이 도형의 자리표시자 유형입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getRotation()`

가운데를 중심으로 한 요소의 시계 방향 회전 각도를 반환합니다. 여기서 0도는 회전하지 않음을 의미합니다.

Return 키

Number: 0(포함)에서 360(제외) 사이의 회전 각도(도)입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getShapeType()`

도형의 유형을 반환합니다.

Return 키

ShapeType: 이 도형의 유형입니다.

`getText()`

도형의 텍스트 콘텐츠를 반환합니다.

도형 내 텍스트는 항상 줄바꿈 문자로 끝납니다.

Return 키

TextRange - 이 도형의 텍스트 콘텐츠

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getTitle()`

페이지 요소의 대체 텍스트 제목을 반환합니다. 제목이 대체 텍스트를 표시하고 읽기 위해 설명과 결합됩니다.

Return 키

String: 페이지 요소의 대체 텍스트 제목입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getTop()`

요소에 회전이 없을 때 페이지 왼쪽 상단에서 측정한 요소의 세로 위치를 가져옵니다.

Return 키

Number: 이 요소를 세로(페이지 왼쪽 상단)부터 세로로 나타낸 지점입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getTransform()`

페이지 요소의 변환을 반환합니다.

페이지 요소의 시각적 모양은 절대적인 변환에 의해 결정됩니다. 절대 변환을 계산하려면 페이지 요소의 변환을 모든 상위 그룹의 변환과 연결합니다. 페이지 요소가 그룹에 없으면 절대 변환은 이 필드의 값과 동일합니다.

Return 키

AffineTransform: 페이지 요소의 변환입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`getWidth()`

요소의 너비(포인트)를 반환합니다. 이는 요소의 회전이 없을 때 요소의 경계 상자 너비입니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 배치 제한사항을 참고하세요.

Return 키

Number: 페이지 요소의 고유한 너비(포인트) 또는 페이지 요소에 너비가 없는 경우 null입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`preconcatenateTransform(transform)`

제공된 변환을 페이지 요소의 기존 변환에 연결합니다.

newTransform = argument * existingTransform

예를 들어 페이지 요소를 왼쪽으로 36포인트 이동하려면 다음 단계를 따르세요.

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

페이지 요소의 변환을 setTransform(transform)로 바꿀 수도 있습니다.

매개변수

이름	유형	설명
`transform`	`AffineTransform`	이 페이지 요소의 변환에 연결할 변환입니다.

Return 키

Shape: 체인을 위한 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`remove()`

페이지 요소를 삭제합니다.

삭제 작업 후 Group에 페이지 요소가 하나만 포함되어 있거나 포함되어 있지 않은 경우 그룹 자체도 삭제됩니다.

마스터 또는 레이아웃에서 자리표시자 PageElement이 삭제되면 비어 있는 상속 자리표시자도 삭제됩니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`removeLink()`

Link를 삭제합니다.

shape.removeLink();

`replaceWithImage(blobSource)`

이 도형을 BlobSource에서 제공한 이미지로 바꿉니다.

이미지는 삽입 시 제공된 BlobSource에서 한 번 가져오며 프레젠테이션 내에 표시되도록 사본이 저장됩니다. 이미지 크기는 50MB 미만이고 25메가픽셀을 초과할 수 없으며 PNG, JPEG 또는 GIF 형식이어야 합니다.

이미지의 가로세로 비율을 유지하기 위해 기존 도형의 크기를 기준으로 이미지의 크기가 조정되고 중앙에 배치됩니다.

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
shape.replaceWithImage(driveImage);

매개변수

이름	유형	설명
`blobSource`	`BlobSource`	이미지 데이터입니다.

Return 키

Image: 셰이프를 대체한 Image입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`replaceWithImage(blobSource, crop)`

이 도형을 BlobSource에서 제공한 이미지로 바꿉니다.

이미지를 삽입하면 BlobSource에서 한 번 가져오며 프레젠테이션 내에 표시되도록 사본이 저장됩니다. 이미지 크기는 50MB 미만이고 25메가픽셀을 초과할 수 없으며 PNG, JPEG 또는 GIF 형식이어야 합니다.

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

매개변수

이름	유형	설명
`blobSource`	`BlobSource`	이미지 데이터입니다.
`crop`	`Boolean`	`true`인 경우, 기존 도형의 크기에 맞게 이미지를 자릅니다. 그렇지 않으면 이미지의 크기가 조정되고 중앙에 배치됩니다.

Return 키

Image: 셰이프를 대체한 Image입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`replaceWithImage(imageUrl)`

이 도형을 이미지로 바꿉니다.

이미지를 삽입하면 URL에서 한 번 가져오며 프레젠테이션 내에 표시되도록 사본이 저장됩니다. 이미지 크기는 50MB 미만이고 25메가픽셀을 초과할 수 없으며 PNG, JPEG 또는 GIF 형식이어야 합니다.

제공된 URL은 공개적으로 액세스할 수 있어야 하며 2KB 이하여야 합니다. URL 자체는 이미지와 함께 저장되고 Image.getSourceUrl()를 통해 노출됩니다.

이미지의 가로세로 비율을 유지하기 위해 기존 도형의 크기를 기준으로 이미지의 크기가 조정되고 중앙에 배치됩니다.

매개변수

이름	유형	설명
`imageUrl`	`String`	이미지를 다운로드할 이미지 URL입니다.

Return 키

Image: 셰이프를 대체한 Image입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`replaceWithImage(imageUrl, crop)`

이 도형을 이미지로 바꿉니다.

제공된 URL은 2KB 이하여야 합니다. URL 자체는 이미지와 함께 저장되고 Image.getSourceUrl()를 통해 노출됩니다.

매개변수

이름	유형	설명
`imageUrl`	`String`	이미지를 다운로드할 이미지 URL입니다.
`crop`	`Boolean`	`true`인 경우, 기존 도형의 크기에 맞게 이미지를 자릅니다. 그렇지 않으면 이미지의 크기가 조정되고 중앙에 배치됩니다.

Return 키

Image: 셰이프를 대체한 Image입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`replaceWithSheetsChart(sourceChart)`

이 도형을 Google Sheets 차트로 대체합니다.

차트는 원본 Google Sheets 차트와 연결되어 있어 업데이트할 수 있습니다. 다른 공동작업자는 소스 스프레드시트 링크를 볼 수 있습니다.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

매개변수

이름	유형	설명
`sourceChart`	`EmbeddedChart`	스프레드시트의 도형을 대체하는 차트입니다.

Return 키

SheetsChart - 도형을 대체한 차트입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`replaceWithSheetsChartAsImage(sourceChart)`

이 도형을 Google Sheets 차트의 이미지로 바꿉니다.

Google 스프레드시트의 가로세로 비율을 유지하기 위해 차트 이미지의 크기가 조정되고 기존 도형의 크기를 기준으로 중심이 설정됩니다.

차트 이미지가 원본 Google Sheets 차트와 연결되어 있지 않습니다.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

매개변수

이름	유형	설명
`sourceChart`	`EmbeddedChart`	스프레드시트의 도형을 대체하는 차트입니다.

Return 키

Image - 도형을 대체한 차트의 이미지입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`scaleHeight(ratio)`

요소의 높이를 지정된 비율로 조정합니다. 요소의 높이가 요소에 회전이 없을 때 경계 상자의 높이입니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 배치 제한사항을 참고하세요.

매개변수

이름	유형	설명
`ratio`	`Number`	이 페이지 요소의 높이를 조정하는 비율입니다.

Return 키

Shape: 체인을 위한 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`scaleWidth(ratio)`

요소의 너비를 지정된 비율로 조정합니다. 요소의 너비는 요소에 회전이 없을 때 경계 상자의 너비입니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 배치 제한사항을 참고하세요.

매개변수

이름	유형	설명
`ratio`	`Number`	이 페이지 요소의 너비를 조정할 비율입니다.

Return 키

Shape: 체인을 위한 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`select()`

활성 프레젠테이션에서 PageElement만 선택하고 이전 선택사항은 삭제합니다. 이는 true로 select(replace)를 호출하는 것과 같습니다.

스크립트는 스크립트를 프레젠테이션에 결합한 경우에만 스크립트를 실행하는 사용자의 선택에 액세스할 수 있습니다.

그러면 PageElement의 상위 Page가 current page selection로 설정됩니다.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`select(replace)`

활성 프레젠테이션에서 PageElement을(를) 선택합니다.

스크립트는 스크립트를 프레젠테이션에 결합한 경우에만 스크립트를 실행하는 사용자의 선택에 액세스할 수 있습니다.

true를 이 메서드에 전달하여 PageElement만 선택하고 이전 선택 항목은 삭제합니다. 그러면 PageElement의 상위 Page도 current page selection로 설정됩니다.

false를 전달하여 여러 PageElement 객체를 선택합니다. PageElement 객체는 동일한 Page에 있어야 합니다.

false 매개변수를 사용하여 페이지 요소를 선택하는 동안 다음 조건을 충족해야 합니다.

PageElement 객체의 상위 Page가 current page selection이어야 합니다.
Page 객체를 여러 개 선택해야 합니다.

이를 위해서는 먼저 Page.selectAsCurrentPage()를 사용하여 상위 Page을 선택한 다음 페이지에서 페이지 요소를 선택하는 것이 좋습니다.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

매개변수

이름	유형	설명
`replace`	`Boolean`	`true`인 경우 선택 항목이 이전 선택 항목을 대체합니다. 그렇지 않으면 선택 항목이 이전 선택 항목에 추가됩니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`sendBackward()`

페이지 요소를 한 요소씩 페이지에서 뒤로 보냅니다.

페이지 요소가 그룹에 포함되어서는 안 됩니다.

Return 키

Shape: 체인을 위한 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`sendToBack()`

페이지 요소를 페이지 뒤로 보냅니다.

페이지 요소가 그룹에 포함되어서는 안 됩니다.

Return 키

Shape: 체인을 위한 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setContentAlignment(contentAlignment)`

도형에 있는 텍스트의 ContentAlignment를 설정합니다.

이 메서드는 업데이트된 도형에서 텍스트 자동 맞춤 속성을 자동으로 비활성화합니다.

매개변수

이름	유형	설명
`contentAlignment`	`ContentAlignment`	설정할 정렬입니다.

Return 키

Shape - 체이닝용 도형.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setDescription(description)`

페이지 요소의 대체 텍스트 설명을 설정합니다.

Group 요소에는 이 메서드가 지원되지 않습니다.

// Set the first page element's alt text description to "new alt text description".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

매개변수

이름	유형	설명
`description`	`String`	대체 텍스트 설명을 설정할 문자열입니다.

Return 키

Shape: 이 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setHeight(height)`

요소의 높이를 포인트 단위로 설정합니다. 이는 요소의 회전이 없을 때 요소의 경계 상자 높이입니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 배치 제한사항을 참고하세요.

매개변수

이름	유형	설명
`height`	`Number`	설정할 페이지 요소의 새로운 높이(포인트)입니다.

Return 키

Shape: 체인을 위한 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setLeft(left)`

요소에 회전이 없을 때 페이지 왼쪽 상단에서 측정한 요소의 가로 위치를 설정합니다.

매개변수

이름	유형	설명
`left`	`Number`	설정할 새 가로 위치(포인트)입니다.

Return 키

Shape: 체인을 위한 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setLinkSlide(slideIndex)`

슬라이드의 0 기반 색인을 사용하여 Link를 지정된 Slide로 설정합니다.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

매개변수

이름	유형	설명
`slideIndex`	`Integer`	슬라이드의 0부터 시작하는 색인입니다.

Return 키

Link: 설정된 Link입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setLinkSlide(slide)`

Link를 지정된 Slide로 설정하며 링크는 지정된 슬라이드 ID로 설정됩니다.

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

매개변수

이름	유형	설명
`slide`	`Slide`	연결할 `Slide`입니다.

Return 키

Link: 설정된 Link입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setLinkSlide(slidePosition)`

슬라이드의 상대 위치를 사용하여 Link를 지정된 Slide로 설정합니다.

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

매개변수

이름	유형	설명
`slidePosition`	`SlidePosition`	상대 `SlidePosition`

Return 키

Link: 설정된 Link입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setLinkUrl(url)`

Link를 지정된 비어 있지 않은 URL 문자열로 설정합니다.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

매개변수

이름	유형	설명
`url`	`String`	URL 문자열입니다.

Return 키

Link: 설정된 Link입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setRotation(angle)`

요소의 중심을 중심으로 한 시계 방향 회전 각도를 도 단위로 설정합니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 배치 제한사항을 참고하세요.

매개변수

이름	유형	설명
`angle`	`Number`	설정할 새 시계 방향 회전 각도입니다(도 단위).

Return 키

Shape: 체인을 위한 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setTitle(title)`

페이지 요소의 대체 텍스트 제목을 설정합니다.

Group 요소에는 이 메서드가 지원되지 않습니다.

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

매개변수

이름	유형	설명
`title`	`String`	대체 텍스트 제목을 설정할 문자열입니다.

Return 키

Shape: 이 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setTop(top)`

요소에 회전이 없을 때 페이지 왼쪽 상단에서 측정한 포인트의 세로 위치를 설정합니다.

매개변수

이름	유형	설명
`top`	`Number`	설정할 새 세로 위치(포인트)입니다.

Return 키

Shape: 체인을 위한 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setTransform(transform)`

제공된 변환을 사용하여 페이지 요소의 변환을 설정합니다.

그룹의 변환을 업데이트하면 해당 그룹에 있는 페이지 요소의 절대 변환이 변경되어 시각적 모양이 변경될 수 있습니다.

그룹에 있는 페이지 요소의 변환을 업데이트하면 해당 페이지 요소의 변환만 변경됩니다. 그룹이나 그룹의 다른 페이지 요소의 변환에는 영향을 미치지 않습니다.

변환이 페이지 요소의 시각적 모양에 미치는 영향에 관한 자세한 내용은 getTransform()를 참고하세요.

매개변수

이름	유형	설명
`transform`	`AffineTransform`	이 페이지 요소에 설정된 변환입니다.

Return 키

Shape - 연결용 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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

`setWidth(width)`

요소의 너비를 포인트로 설정합니다. 이는 요소의 회전이 없을 때 요소의 경계 상자 너비입니다.

이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 배치 제한사항을 참고하세요.

매개변수

이름	유형	설명
`width`	`Number`	설정할 이 페이지 요소의 새 너비(포인트)입니다.

Return 키

Shape: 체인을 위한 페이지 요소입니다.

승인

이 방법을 사용하는 스크립트에는 다음 범위 중 하나 이상을 사용하여 승인이 필요합니다.

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