단일 단위로 조인된 PageElement
컬렉션입니다.
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
alignOnPage(alignmentPosition) | Group | 요소를 페이지에서 지정된 정렬 위치에 정렬합니다. |
bringForward() | Group | 페이지에서 페이지 요소를 한 요소씩 앞으로 가져옵니다. |
bringToFront() | Group | 페이지 요소를 페이지의 맨 앞으로 가져옵니다. |
duplicate() | PageElement | 페이지 요소를 복사합니다. |
getChildren() | PageElement[] | 그룹의 페이지 요소 컬렉션을 가져옵니다. |
getConnectionSites() | ConnectionSite[] | 페이지 요소의 ConnectionSite 목록을 반환하거나 페이지가
요소에 연결 사이트가 없습니다. |
getDescription() | String | 페이지 요소의 대체 텍스트 설명을 반환합니다. |
getHeight() | Number | 요소 높이(포인트, 즉 요소에 회전이 없습니다. |
getInherentHeight() | Number | 요소의 고유 높이를 반환합니다(포인트). |
getInherentWidth() | Number | 요소의 고유 너비를 포인트 단위로 반환합니다. |
getLeft() | Number | 요소의 왼쪽 상단으로부터 측정된 요소의 가로 위치를 포인트 단위로 반환합니다. 페이지에 회전이 없을 때 나타납니다. |
getObjectId() | String | 이 객체의 고유 ID를 반환합니다. |
getPageElementType() | PageElementType | PageElementType enum으로 표시된 페이지 요소의 유형을 반환합니다. |
getParentGroup() | Group | 이 페이지 요소가 속한 그룹을 반환하거나 null 요소가
그룹 |
getParentPage() | Page | 이 페이지 요소가 있는 페이지를 반환합니다. |
getRotation() | Number | 중심을 중심으로 한 요소의 시계 방향 회전 각도를 도 단위로 반환합니다. 여기서 0도입니다. 이는 회전이 없음을 의미합니다. |
getTitle() | String | 페이지 요소의 대체 텍스트 제목을 반환합니다. |
getTop() | Number | 페이지의 왼쪽 상단 모서리에서 측정한 요소의 세로 위치(포인트)를 가져옵니다. 요소에 회전이 없을 때 |
getTransform() | AffineTransform | 페이지 요소의 변환을 가져옵니다. |
getWidth() | Number | 요소의 너비를 포인트로 반환합니다. 포인트는 요소의 경계 상자 너비인 요소에 회전이 없습니다. |
preconcatenateTransform(transform) | Group | 제공된 변환을 페이지 요소의 기존 변환에 미리 연결합니다. |
remove() | void | 페이지 요소를 삭제합니다. |
scaleHeight(ratio) | Group | 지정된 비율로 요소의 높이를 조정합니다. |
scaleWidth(ratio) | Group | 지정된 비율로 요소의 너비를 조정합니다. |
select() | void | 활성 프레젠테이션에서 PageElement 만 선택하고 이전 프레젠테이션은 모두 삭제합니다.
선택합니다. |
select(replace) | void | 활성 프레젠테이션에서 PageElement 를 선택합니다. |
sendBackward() | Group | 페이지에서 페이지 요소를 한 요소씩 뒤로 보냅니다. |
sendToBack() | Group | 페이지 요소를 페이지 뒷면으로 보냅니다. |
setDescription(description) | Group | 페이지 요소의 대체 텍스트 설명을 설정합니다. |
setHeight(height) | Group | 요소의 높이를 포인트로 설정합니다. 포인트는 요소에 회전이 없습니다. |
setLeft(left) | Group | 요소의 왼쪽 상단으로부터 측정된 요소의 가로 위치를 포인트 단위로 설정합니다. 페이지에 회전이 없을 때 나타납니다. |
setRotation(angle) | Group | 중심을 중심으로 요소의 시계 방향 회전 각도를 도 단위로 설정합니다. |
setTitle(title) | Group | 페이지 요소의 대체 텍스트 제목을 설정합니다. |
setTop(top) | Group | 페이지의 왼쪽 상단 모서리에서 측정한 요소의 세로 위치를 포인트 단위로 설정합니다. 요소에 회전이 없을 때 |
setTransform(transform) | Group | 제공된 변환을 사용하여 페이지 요소의 변환을 설정합니다. |
setWidth(width) | Group | 요소의 너비를 포인트로 설정합니다. 포인트는 요소에 회전이 없습니다. |
ungroup() | void | 그룹의 요소를 그룹 해제합니다. |
자세한 문서
alignOnPage(alignmentPosition)
요소를 페이지에서 지정된 정렬 위치에 정렬합니다.
매개변수
이름 | 유형 | 설명 |
---|---|---|
alignmentPosition | AlignmentPosition | 페이지에서 이 페이지 요소를 정렬할 위치입니다. |
리턴
Group
- 체인을 위한 이 페이지 요소입니다.
bringForward()
bringToFront()
duplicate()
페이지 요소를 복사합니다.
중복 페이지 요소는 원본과 같은 페이지의 같은 위치에 배치됩니다.
리턴
PageElement
- 이 페이지 요소의 새로운 복제본입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getChildren()
그룹의 페이지 요소 컬렉션을 가져옵니다. 그룹의 최소 크기는 2입니다.
리턴
PageElement[]
- 이 그룹의 페이지 요소 목록입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getConnectionSites()
페이지 요소의 ConnectionSite
목록을 반환하거나 페이지가
요소에 연결 사이트가 없습니다.
리턴
ConnectionSite[]
- 연결 사이트 목록으로, 이 요소에 연결 사이트가 없는 경우 비어 있을 수 있습니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
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()
getRotation()
중심을 중심으로 한 요소의 시계 방향 회전 각도를 도 단위로 반환합니다. 여기서 0도입니다. 이는 회전이 없음을 의미합니다.
리턴
Number
- 0 (0도 이상)에서 360도 (제외) 사이의 회전 각도입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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()
페이지 요소의 변환을 가져옵니다.
새로 만든 Group
의 초기 변환은 항상 ID 변환입니다.
1.0 scale 매개변수와 0.0 기울기 및 변환 매개변수입니다.
리턴
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 | 이 페이지 요소의 변환에 미리 연결할 변환입니다. |
리턴
Group
- 체인을 위한 이 페이지 요소입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
scaleHeight(ratio)
지정된 비율로 요소의 높이를 조정합니다. 요소의 높이는 요소의 높이입니다. 경계 상자로 표시됩니다.
이 방법은 일부 페이지 요소와 호환되지 않습니다. 어떤 페이지 요소가 제대로 작동하지 않는지 알아보기 위해 자세한 내용은 크기 및 포지셔닝 제한사항을 참조하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
ratio | Number | 이 페이지 요소의 높이가 조정되는 비율입니다. |
리턴
Group
- 체인을 위한 이 페이지 요소입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
지정된 비율로 요소의 너비를 조정합니다. 요소의 너비는 요소의 너비입니다. 경계 상자로 표시됩니다.
이 방법은 일부 페이지 요소와 호환되지 않습니다. 어떤 페이지 요소가 제대로 작동하지 않는지 알아보기 위해 자세한 내용은 크기 및 포지셔닝 제한사항을 참조하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
ratio | Number | 이 페이지 요소의 너비를 조정하는 비율입니다. |
리턴
Group
- 체인을 위한 이 페이지 요소입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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
입니다.
여러 PageElement
객체를 선택하려면 false
를 전달합니다. PageElement
객체는 동일한 Page
에 있어야 합니다.
false
를 사용하여 페이지 요소를 선택할 때는 다음 조건을 충족해야 합니다.
매개변수:
PageElement
객체의 상위Page
는current page selection
이어야 합니다.- 여러
Page
객체를 선택해서는 안 됩니다.
이를 위해서는 상위 Page
를 선택하는 것이 좋습니다.
먼저 Page.selectAsCurrentPage()
를 사용하여 해당 페이지의 페이지 요소를 선택합니다.
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 | 대체 텍스트 설명을 설정할 문자열입니다. |
리턴
Group
- 이 페이지 요소입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
요소의 높이를 포인트로 설정합니다. 포인트는 요소에 회전이 없습니다.
이 방법은 일부 페이지 요소와 호환되지 않습니다. 어떤 페이지 요소가 제대로 작동하지 않는지 알아보기 위해 자세한 내용은 크기 및 포지셔닝 제한사항을 참조하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
height | Number | 설정할 페이지 요소의 새로운 높이입니다(포인트 단위). |
리턴
Group
- 체인을 위한 이 페이지 요소입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
setRotation(angle)
중심을 중심으로 요소의 시계 방향 회전 각도를 도 단위로 설정합니다.
이 방법은 일부 페이지 요소와 호환되지 않습니다. 어떤 페이지 요소가 제대로 작동하지 않는지 알아보기 위해 자세한 내용은 크기 및 포지셔닝 제한사항을 참조하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
angle | Number | 설정할 새 시계 방향 회전 각도입니다(단위: 도). |
리턴
Group
- 체인을 위한 이 페이지 요소입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
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 | 대체 텍스트 제목을 설정할 문자열입니다. |
리턴
Group
- 이 페이지 요소입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
setTransform(transform)
제공된 변환을 사용하여 페이지 요소의 변환을 설정합니다.
그룹의 변환을 업데이트하면 그룹 내에 있는 페이지 요소의 절대 변환이 해당 그룹의 시각적 모양이 바뀔 수 있습니다.
그룹에 있는 페이지 요소의 변환을 업데이트하면 표시됩니다. 그룹이나 다른 페이지 요소의 변환에는 영향을 주지 않으며 그룹
변환이 페이지 요소의 시각적 모양에 미치는 영향에 대한 자세한 내용은 getTransform()
를 참고하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
transform | AffineTransform | 이 페이지 요소에 설정된 변환입니다. |
리턴
Group
- 체이닝을 위한 요소입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
요소의 너비를 포인트로 설정합니다. 포인트는 요소에 회전이 없습니다.
이 방법은 일부 페이지 요소와 호환되지 않습니다. 어떤 페이지 요소가 제대로 작동하지 않는지 알아보기 위해 자세한 내용은 크기 및 포지셔닝 제한사항을 참조하세요.
매개변수
이름 | 유형 | 설명 |
---|---|---|
width | Number | 설정할 이 페이지 요소의 새 너비입니다(포인트 단위). |
리턴
Group
- 체인을 위한 이 페이지 요소입니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
ungroup()
그룹의 요소를 그룹 해제합니다.
그룹 자체가 삭제됩니다.
다른 그룹 내의 그룹은 그룹 해제할 수 없습니다.
승인
이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상으로 승인이 필요합니다.
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations