이미지를 나타내는 PageElement
입니다.
방법
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
alignOnPage(alignmentPosition) | Image | 요소를 페이지의 지정된 정렬 위치에 정렬합니다. |
bringForward() | Image | 페이지 요소를 페이지 앞으로 한 요소씩 가져옵니다. |
bringToFront() | Image | 페이지 요소를 페이지 앞으로 가져옵니다. |
duplicate() | PageElement | 페이지 요소를 복제합니다. |
getAs(contentType) | Blob | 이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. |
getBlob() | Blob | 이 이미지 내의 데이터를 blob으로 반환합니다. |
getBorder() | Border | 이미지의 Border 를 반환합니다. |
getConnectionSites() | ConnectionSite[] | 페이지 요소의 ConnectionSite 목록을 반환하거나 페이지 요소에 연결 사이트가 없는 경우 빈 목록을 반환합니다. |
getContentUrl() | String | 이미지의 URL을 가져옵니다. |
getDescription() | String | 페이지 요소의 대체 텍스트 설명을 반환합니다. |
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도는 회전이 없음을 의미합니다. |
getSourceUrl() | String | 가능한 경우 이미지의 소스 URL을 가져옵니다. |
getTitle() | String | 페이지 요소의 대체 텍스트 제목을 반환합니다. |
getTop() | Number | 요소에 회전이 없는 경우 페이지의 왼쪽 상단에서 측정한 요소의 세로 위치를 포인트 단위로 가져옵니다. |
getTransform() | AffineTransform | 페이지 요소의 변환을 반환합니다. |
getWidth() | Number | 요소의 너비를 포인트 단위로 반환합니다. 이는 요소에 회전이 없을 때 요소 경계 상자의 너비입니다. |
preconcatenateTransform(transform) | Image | 제공된 변환을 페이지 요소의 기존 변환에 사전 연결합니다. |
remove() | void | 페이지 요소를 삭제합니다. |
removeLink() | void | Link 를 삭제합니다. |
replace(blobSource) | Image | 이 이미지를 BlobSource 객체에 설명된 이미지로 바꿉니다. |
replace(blobSource, crop) | Image | 이 이미지를 Image 객체에서 설명한 이미지로 대체하고 필요에 따라 이미지를 자릅니다. |
replace(imageUrl) | Image | 이 이미지를 제공된 URL에서 다운로드한 다른 이미지로 대체합니다. |
replace(imageUrl, crop) | Image | 이 이미지를 제공된 URL에서 다운로드한 다른 이미지로 바꾸고 필요에 따라 이미지를 자릅니다. |
scaleHeight(ratio) | Image | 지정된 비율로 요소의 높이를 조정합니다. |
scaleWidth(ratio) | Image | 지정된 비율로 요소의 너비를 조정합니다. |
select() | void | 활성 프레젠테이션에서 PageElement 만 선택하고 이전 선택 항목을 삭제합니다. |
select(replace) | void | 활성 프레젠테이션에서 PageElement 를 선택합니다. |
sendBackward() | Image | 페이지 요소를 페이지에서 한 요소씩 뒤로 보냅니다. |
sendToBack() | Image | 페이지 요소를 페이지 뒤로 보냅니다. |
setDescription(description) | Image | 페이지 요소의 대체 텍스트 설명을 설정합니다. |
setHeight(height) | Image | 요소의 높이를 포인트 단위로 설정합니다. 이는 요소에 회전이 없는 경우 요소 경계 상자의 높이입니다. |
setLeft(left) | Image | 요소의 가로 위치를 포인트 단위로 설정합니다(요소에 회전이 없을 때 페이지 왼쪽 상단으로부터 측정). |
setLinkSlide(slideIndex) | Link | 슬라이드의 0부터 시작하는 색인을 사용하여 Link 를 지정된 Slide 로 설정합니다. |
setLinkSlide(slide) | Link | Link 를 지정된 Slide 로 설정합니다. 링크는 지정된 슬라이드 ID로 설정됩니다. |
setLinkSlide(slidePosition) | Link | 슬라이드의 상대 위치를 사용하여 Link 를 지정된 Slide 로 설정합니다. |
setLinkUrl(url) | Link | Link 을 비어 있지 않은 지정된 URL 문자열로 설정합니다. |
setRotation(angle) | Image | 중심을 기준으로 요소의 시계 방향 회전 각도를 도 단위로 설정합니다. |
setTitle(title) | Image | 페이지 요소의 대체 텍스트 제목을 설정합니다. |
setTop(top) | Image | 요소에 회전이 없을 때 페이지의 왼쪽 상단으로부터 측정한 세로 위치를 포인트 단위로 설정합니다. |
setTransform(transform) | Image | 제공된 변환을 사용하여 페이지 요소의 변환을 설정합니다. |
setWidth(width) | Image | 요소의 너비를 포인트 단위로 설정합니다. 이 너비는 요소에 회전이 없을 때 요소 경계 상자의 너비입니다. |
자세한 문서
alignOnPage(alignmentPosition)
요소를 페이지의 지정된 정렬 위치에 정렬합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
alignmentPosition | AlignmentPosition | 페이지에서 이 페이지 요소를 정렬할 위치입니다. |
리턴
Image
- 연결용 페이지 요소입니다.
bringForward()
bringToFront()
duplicate()
페이지 요소를 복제합니다.
중복된 페이지 요소가 같은 페이지에서 원본과 같은 위치에 배치됩니다.
리턴
PageElement
- 이 페이지 요소의 새 복제본입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
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' 중 어느 것도 사용할 수 있습니다. |
리턴
Blob
- blob 형식의 데이터입니다.
getBlob()
getBorder()
getConnectionSites()
페이지 요소의 ConnectionSite
목록을 반환하거나 페이지 요소에 연결 사이트가 없는 경우 빈 목록을 반환합니다.
리턴
ConnectionSite[]
: 연결 사이트 목록으로, 이 요소에 연결 사이트가 없는 경우 비어 있을 수 있습니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getContentUrl()
이미지의 URL을 가져옵니다.
이 URL은 요청자의 계정으로 태그가 지정되므로 URL이 있는 사람은 누구나 원래 요청자로서 실질적으로 이미지에 액세스할 수 있습니다. 프레젠테이션의 공유 설정이 변경되면 이미지에 대한 액세스 권한이 손실될 수 있습니다. 반환된 URL은 잠시 후에 만료됩니다.
리턴
String
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDescription()
페이지 요소의 대체 텍스트 설명을 반환합니다. 설명은 제목과 결합되어 대체 텍스트를 표시하고 읽습니다.
리턴
String
- 페이지 요소의 대체 텍스트 설명입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getHeight()
요소의 높이(포인트 단위)를 가져옵니다. 이 높이는 요소에 회전이 없을 때 요소 경계 상자의 높이입니다.
이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 위치 제한사항을 참고하세요.
리턴
Number
- 페이지 요소의 고유 높이입니다(포인트 단위). 또는 페이지 요소에 높이가 없는 경우 null
입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentHeight()
요소의 고유 높이를 포인트 단위로 반환합니다.
페이지 요소의 변환은 그 고유한 크기를 기준으로 합니다. 요소의 변환과 함께 고유한 크기를 사용하여 요소의 최종 시각적 모양을 결정합니다.
리턴
Number
- 페이지 요소의 고유 높이입니다(포인트 단위). 또는 페이지 요소에 높이가 없는 경우 null
입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getInherentWidth()
요소의 고유 너비를 포인트 단위로 반환합니다.
페이지 요소의 변환은 그 고유한 크기를 기준으로 합니다. 요소의 변환과 함께 고유한 크기를 사용하여 요소의 최종 시각적 모양을 결정합니다.
리턴
Number
- 페이지 요소의 고유한 너비(포인트) 또는 null
(페이지 요소에 너비가 없는 경우)
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLeft()
요소에 회전이 없는 경우 페이지의 왼쪽 상단에서 측정한 요소의 가로 위치를 포인트 단위로 반환합니다.
리턴
Number
- 이 요소의 가로 위치로 페이지 왼쪽 상단을 기준으로 포인트 단위로 표시됩니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLink()
getObjectId()
이 객체의 고유 ID를 반환합니다. 페이지와 페이지 요소에서 사용되는 객체 ID는 동일한 네임스페이스를 공유합니다.
리턴
String
- 이 객체의 고유 ID입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementType()
PageElementType
enum으로 표시된 페이지 요소의 유형을 반환합니다.
리턴
PageElementType
- 페이지 요소의 유형입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentGroup()
getParentPage()
getParentPlaceholder()
자리표시자의 상위 페이지 요소를 반환합니다. 이미지가 자리표시자가 아니거나 상위 요소가 없으면 null
를 반환합니다.
리턴
PageElement
- 이 이미지 자리표시자의 상위 페이지 요소 또는 null
(이미지가 자리표시자가 아니거나 상위 요소가 없는 경우)입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderIndex()
자리표시자 이미지의 색인을 반환합니다. 같은 페이지에 있는 둘 이상의 자리표시자 이미지가 동일한 유형인 경우 각각 고유한 색인 값을 갖습니다. 이미지가 자리표시자가 아니면 null
을 반환합니다.
리턴
Integer
- 이 이미지의 자리표시자 색인 또는 null
(이미지가 자리표시자가 아닌 경우)
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderType()
이미지의 자리표시자 유형을 반환하거나 도형이 자리표시자가 아니면 PlaceholderType.NONE
을 반환합니다.
리턴
PlaceholderType
- 이 이미지의 자리표시자 유형입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRotation()
중심을 기준으로 요소의 시계 방향 회전 각도를 반환합니다(도). 여기서 0도는 회전이 없음을 의미합니다.
리턴
Number
- 0도 이상 360도 이하의 회전 각도입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getSourceUrl()
가능한 경우 이미지의 소스 URL을 가져옵니다.
URL로 이미지를 삽입하면 이미지 삽입 중에 제공된 URL이 반환됩니다.
리턴
String
- 이미지 URL 또는 null
(이미지에 소스 URL이 없는 경우)
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTitle()
페이지 요소의 대체 텍스트 제목을 반환합니다. 제목은 설명과 결합되어 대체 텍스트를 표시하고 읽습니다.
리턴
String
- 페이지 요소의 대체 텍스트 제목입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTop()
요소에 회전이 없는 경우 페이지의 왼쪽 상단에서 측정한 요소의 세로 위치를 포인트 단위로 가져옵니다.
리턴
Number
- 이 요소의 세로 위치(포인트 단위)(페이지 왼쪽 상단 기준)
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTransform()
페이지 요소의 변환을 반환합니다.
페이지 요소의 시각적 모양은 절대 변환에 따라 결정됩니다. 절대 변환을 계산하려면 페이지 요소의 변환을 모든 상위 그룹의 변환과 연결합니다. 페이지 요소가 그룹에 없는 경우 절대 변환은 이 필드의 값과 동일합니다.
리턴
AffineTransform
- 페이지 요소의 변환입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getWidth()
요소의 너비를 포인트 단위로 반환합니다. 이는 요소에 회전이 없을 때 요소 경계 상자의 너비입니다.
이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 위치 제한사항을 참고하세요.
리턴
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 | 이 페이지 요소의 변환에 사전 연결할 변환입니다. |
리턴
Image
- 연결용 페이지 요소입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
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();
replace(blobSource)
이 이미지를 BlobSource
객체에 설명된 이미지로 바꿉니다.
이미지를 삽입하면
BlobSource
에서 이미지를 한 번 가져오고 사본이 프레젠테이션 내에 표시되도록 저장됩니다.
이미지는 크기가 50MB 미만이어야 하고 25메가픽셀을 초과할 수 없으며 PNG, JPEG 또는 GIF 형식이어야 합니다.
이미지의 가로세로 비율을 유지하기 위해 기존 이미지의 크기를 기준으로 이미지의 크기가 조정되고 중앙에 배치됩니다.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); image.replace(driveImage);
매개변수
이름 | 유형 | 설명 |
---|---|---|
blobSource | BlobSource | 이미지 데이터입니다. |
리턴
Image
: 대체 후의 Image
입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(blobSource, crop)
이 이미지를 Image
객체에서 설명한 이미지로 대체하고 필요에 따라 이미지를 자릅니다.
이미지를 삽입하면
BlobSource
에서 이미지를 한 번 가져오고 사본이 프레젠테이션 내에 표시되도록 저장됩니다.
이미지는 크기가 50MB 미만이어야 하고 25메가픽셀을 초과할 수 없으며 PNG, JPEG 또는 GIF 형식이어야 합니다.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); // Replace and crop the drive image. image.replace(driveImage, true);
매개변수
이름 | 유형 | 설명 |
---|---|---|
blobSource | BlobSource | 이미지 데이터입니다. |
crop | Boolean | true 인 경우 기존 이미지의 크기에 맞게 이미지를 자릅니다. 그렇지 않으면 이미지의 크기가 조정되고 중앙에 배치됩니다. |
리턴
Image
: 대체 후의 Image
입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl)
이 이미지를 제공된 URL에서 다운로드한 다른 이미지로 대체합니다.
이미지를 삽입하면 URL에서 이미지를 한 번 가져오며 프레젠테이션 내에 표시하기 위해 사본이 저장됩니다. 이미지는 크기가 50MB 미만이어야 하고 25메가픽셀을 초과할 수 없으며 PNG, JPEG 또는 GIF 형식이어야 합니다.
제공된 URL은 공개적으로 액세스할 수 있어야 하며 2KB 이하여야 합니다. URL 자체는 이미지와 함께 저장되고 getSourceUrl()
를 통해 노출됩니다.
이미지의 가로세로 비율을 유지하기 위해 기존 이미지의 크기를 기준으로 이미지의 크기가 조정되고 중앙에 배치됩니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
imageUrl | String | 이미지를 다운로드할 URL입니다. |
리턴
Image
: 대체 후의 Image
입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl, crop)
이 이미지를 제공된 URL에서 다운로드한 다른 이미지로 바꾸고 필요에 따라 이미지를 자릅니다.
이미지를 삽입하면 URL에서 이미지를 한 번 가져오며 프레젠테이션 내에 표시하기 위해 사본이 저장됩니다. 이미지는 크기가 50MB 미만이어야 하고 25메가픽셀을 초과할 수 없으며 PNG, JPEG 또는 GIF 형식이어야 합니다.
제공된 URL은 2KB 이하여야 합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
imageUrl | String | 이미지를 다운로드할 URL입니다. |
crop | Boolean | true 인 경우 기존 이미지의 크기에 맞게 이미지를 자릅니다. 그렇지 않으면 이미지의 크기가 조정되고 중앙에 배치됩니다. |
리턴
Image
: 대체 후의 Image
입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
지정된 비율로 요소의 높이를 조정합니다. 요소의 높이는 요소에 회전이 없을 때 경계 상자의 높이입니다.
이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 위치 제한사항을 참고하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
ratio | Number | 이 페이지 요소의 높이를 조정하는 비율입니다. |
리턴
Image
- 연결용 페이지 요소입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
지정된 비율로 요소의 너비를 조정합니다. 요소의 너비는 요소에 회전이 없을 때 경계 상자의 너비입니다.
이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 위치 제한사항을 참고하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
ratio | Number | 페이지 요소의 너비를 조정할 비율입니다. |
리턴
Image
- 연결용 페이지 요소입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
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
를 선택합니다.
스크립트는 스크립트를 실행하는 사용자의 선택에만 액세스할 수 있으며 스크립트가 프레젠테이션에 바인드된 경우에만 액세스할 수 있습니다.
PageElement
만 선택하고 이전 선택 항목을 삭제하려면 이 메서드에 true
를 전달합니다. 이렇게 하면 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()
sendToBack()
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 | 대체 텍스트 설명을 설정할 문자열입니다. |
리턴
Image
- 이 페이지 요소입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
요소의 높이를 포인트 단위로 설정합니다. 이는 요소에 회전이 없는 경우 요소 경계 상자의 높이입니다.
이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 위치 제한사항을 참고하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
height | Number | 이 페이지 요소의 새 높이로 설정할 수 있습니다(단위: 포인트). |
리턴
Image
- 연결용 페이지 요소입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
setLinkSlide(slideIndex)
슬라이드의 0부터 시작하는 색인을 사용하여 Link
를 지정된 Slide
로 설정합니다.
// Set a link to the first slide of the presentation. shape.setLinkSlide(0);
매개변수
이름 | 유형 | 설명 |
---|---|---|
slideIndex | Integer | 슬라이드의 0부터 시작하는 색인입니다. |
리턴
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
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 입니다. |
리턴
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
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 입니다. |
리턴
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkUrl(url)
setRotation(angle)
중심을 기준으로 요소의 시계 방향 회전 각도를 도 단위로 설정합니다.
이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 위치 제한사항을 참고하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
angle | Number | 설정할 새 시계 방향 회전 각도(단위: 도)입니다. |
리턴
Image
- 연결용 페이지 요소입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
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 | 대체 텍스트 제목을 설정할 문자열입니다. |
리턴
Image
- 이 페이지 요소입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
setTransform(transform)
제공된 변환을 사용하여 페이지 요소의 변환을 설정합니다.
그룹의 변환을 업데이트하면 해당 그룹에 있는 페이지 요소의 절대 변환이 변경되어 시각적 모양이 변경될 수 있습니다.
그룹에 있는 페이지 요소의 변환을 업데이트하면 해당 페이지 요소의 변환만 변경됩니다. 그룹 또는 그룹에 있는 다른 페이지 요소의 변환에는 영향을 미치지 않습니다.
변환이 페이지 요소의 시각적 모양에 미치는 영향에 관한 자세한 내용은 getTransform()
를 참고하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
transform | AffineTransform | 이 페이지 요소에 설정된 변환입니다. |
리턴
Image
- 체이닝용 요소입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
요소의 너비를 포인트 단위로 설정합니다. 이 너비는 요소에 회전이 없을 때 요소 경계 상자의 너비입니다.
이 방법은 일부 페이지 요소와 호환되지 않습니다. 이 방법과 호환되지 않는 페이지 요소를 알아보려면 크기 및 위치 제한사항을 참고하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
width | Number | 이 페이지 요소의 새 너비로 포인트 단위입니다. |
리턴
Image
- 연결용 페이지 요소입니다.
승인
이 방법을 사용하는 스크립트는 다음 범위 중 하나 이상을 승인해야 합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations