Show.Slide

Show.Slide은 Presentation 모듈(Office.show(iframe))의 객체 타입입니다. 메서드 60개.

Generated from the SDK type definitions

Presentation · 객체 타입 10개 · 메서드 586개 · 네임스페이스 Show. 이 레퍼런스는 SDK 빌드와 함께 생성된 API 문서 아티팩트(sdk-api-doc.html)에서 생성됩니다. 설명은 게시된 편집기 API 주석 그대로입니다. SDK와 Office 버전을 함께 고정하고, 둘 중 하나가 바뀌면 다시 생성하십시오.

비고

모듈: Presentation · Office.show(iframe) · 네임스페이스 Show
얻는 방법: Document.duplicateSlide(slideProxy), Document.duplicateSlides(slideProxyList), Document.findSlides(filter), Document.getCurrentSlide(), Document.getSlide(index), Document.getSlides(), Document.insertSlide(index, layoutType)
모든 메서드는 Promise를 반환하며, 시그니처는 TypeScript 표기입니다.

메서드

메서드	설명
`appendSlideNoteText(text)`	슬라이드 노트 끝에 텍스트를 이어 붙인다.
`deleteComment(commentProxy)`	댓글 하나를 삭제한다.
`deleteComments(commentProxyList)`	여러 댓글을 일괄 삭제한다.
`deleteShape(shapeProxy)`	도형 하나를 삭제한다.
`deleteShapes(shapeProxyList)`	여러 도형을 일괄 삭제한다.
`distributeShapes(shapeProxyList, direction)`	여러 도형을 균등하게 분배(distribute) 한다.
`duplicateShape(shapeProxy)`	도형을 복제한다.
`duplicateShapes(shapeProxyList)`	도형을 복제한다.
`findCharts(filter)`	조건에 맞는 차트 배열을 반환한다.
`findComments(filter)`	조건에 맞는 댓글을 검색한다.
`findShapes(filter)`	조건에 맞는 도형을 검색한다.
`findTables(filter)`	조건에 맞는 표를 검색한다.
`findText(query, caseSensitive)`	이 슬라이드에서 텍스트를 검색한다.
`getBackgroundFill()`	슬라이드에 명시적으로 설정된 배경 채우기를 반환한다.
`getColorScheme()`	이 슬라이드에 적용된 색상 테마를 반환한다.
`getComments()`	슬라이드의 최상위 댓글(답글 제외) 목록을 반환한다.
`getDate()`	날짜 머리글/바닥글 설정을 반환한다.
`getFooter()`	바닥글 텍스트를 반환한다.
`getLayoutType()`	슬라이드에 적용된 레이아웃 종류를 반환한다.
`getNextComment(commentProxy)`	UI의 메모 탐색 기준으로 다음 최상위 댓글을 반환한다.
`getPrevComment(commentProxy)`	UI의 메모 탐색 기준으로 이전 최상위 댓글을 반환한다.
`getShape(index)`	인덱스로 도형을 가져온다.
`getShapes()`	슬라이드의 모든 도형을 반환한다.
`getSlideNoteText()`	슬라이드 노트의 텍스트를 plain text 로 반환한다.
`getTransition()`	슬라이드 전환 효과를 setTransition 의 평면 입력 형태로 반환한다.
`groupShapes(shapeProxyList)`	여러 도형을 하나의 그룹으로 묶는다.
`hide(isHidden)`	이 슬라이드의 숨김 상태를 설정한다.
`insertComment(text)`	댓글을 추가한다.
`insertImage(url)`	웹 이미지를 삽입한다.
`insertShape(presetId, transform)`	도형을 삽입한다.
`insertTable(rowNum, colNum, styleName)`	표를 삽입한다.
`insertTextBox(transform)`	글상자(텍스트박스)를 삽입한다.
`insertWebVideo(url)`	웹 동영상(YouTube / 3DS)을 삽입한다.
`isHidden()`	슬라이드 숨김 여부를 반환한다.
`isShowMasterShapes()`	마스터(레이아웃)의 배경 도형 표시 여부를 반환한다.
`isSlideNumberVisible()`	슬라이드 번호 표시 여부를 반환한다.
`previewTransition(autoPreview)`	이 슬라이드에 설정된 전환 효과 미리보기를 화면에서 재생한다.
`removeDate()`	이 슬라이드의 날짜 머리글/바닥글을 제거한다.
`removeFill()`	슬라이드 배경 채우기를 제거한다.
`removeFooter()`	이 슬라이드의 바닥글을 제거한다.
`removeSlideNumber()`	이 슬라이드의 슬라이드 번호를 제거한다.
`removeTransition()`	전환 효과를 제거한다.
`replaceText(query, replacement, caseSensitive)`	이 슬라이드에서 검색 텍스트를 찾아 모두 새 텍스트로 바꾼다.
`replyComment(commentProxy, text)`	댓글에 답글을 추가한다.
`resetBackground()`	슬라이드 배경을 초기화한다.
`resetLayout()`	슬라이드 레이아웃을 초기화한다.
`saveAsPicture(shapeProxyList)`	슬라이드의 도형들을 하나의 이미지로 저장한다.
`setDate(date)`	이 슬라이드의 날짜 머리글/바닥글을 설정한다.
`setFill(fill)`	getBackgroundFill() 이 반환한 채우기 객체를 그대로 슬라이드 배경에 적용한다.
`setFooter(text)`	이 슬라이드의 바닥글을 설정한다.
`setGradientFill(type, stops, angle)`	슬라이드 배경을 그라데이션으로 설정한다.
`setImageFill(imageUrl, fillMode, alpha, detail)`	슬라이드 배경을 이미지로 설정한다.
`setLayout(layoutType)`	슬라이드에 레이아웃을 적용한다.
`setPatternFill(preset, foreColor, backColor, foreAlpha, backAlpha)`	슬라이드 배경을 패턴(무늬)으로 설정한다.
`setShowMasterShapes(show)`	마스터(레이아웃)의 배경 도형 표시 여부를 설정한다.
`setSlideNoteText(text)`	슬라이드 노트 텍스트를 설정한다.
`setSlideNumber()`	이 슬라이드에 슬라이드 번호를 표시한다.
`setSolidFill(color, alpha)`	슬라이드 배경을 단색으로 설정한다.
`setTransition(transition)`	슬라이드 전환 효과를 설정한다.
`ungroupShapes(shapeProxy)`	그룹을 해제해 자식 도형으로 분리한다.

메서드 상세

`appendSlideNoteText(text)`

슬라이드 노트 끝에 텍스트를 이어 붙인다.

appendSlideNoteText(text: string): Promise<void>;

매개변수

이름	타입	설명
`text`	`string`	추가할 노트 텍스트

반환값

Promise<void>

`deleteComment(commentProxy)`

댓글 하나를 삭제한다. 부모 댓글이면 그 답글도 함께 삭제된다.

deleteComment(commentProxy: Comment): Promise<void>;

매개변수

이름	타입	설명
`commentProxy`	`Comment`	삭제할 댓글

반환값

Promise<void>

`deleteComments(commentProxyList)`

여러 댓글을 일괄 삭제한다. 부모 댓글이 포함되면 그 답글도 함께 삭제된다. (UI 동작과 일치)

deleteComments(commentProxyList: Comment[]): Promise<void>;

매개변수

이름	타입	설명
`commentProxyList`	`Comment[]`	삭제할 댓글 배열

반환값

Promise<void>

`deleteShape(shapeProxy)`

도형 하나를 삭제한다.

deleteShape(shapeProxy: Shape | Image | Line | Group | Chart | Table | Diagram | OleObject | Control): Promise<void>;

매개변수

이름	타입	설명
`shapeProxy`	`Shape \| Image \| Line \| Group \| Chart \| Table \| Diagram \| OleObject \| Control`	삭제할 도형 Proxy

반환값

Promise<void>

`deleteShapes(shapeProxyList)`

여러 도형을 일괄 삭제한다.

deleteShapes(shapeProxyList: (Shape | Image | Line | Group | Chart | Table | Diagram | OleObject | Control)[]): Promise<void>;

매개변수

이름	타입	설명
`shapeProxyList`	`(Shape \| Image \| Line \| Group \| Chart \| Table \| Diagram \| OleObject \| Control)[]`	삭제할 도형 Proxy 배열

반환값

Promise<void>

`distributeShapes(shapeProxyList, direction)`

여러 도형을 균등하게 분배(distribute) 한다. bbox 중심 기준으로 정렬한 뒤, 양 끝 도형 사이 간격이 모두 같아지도록 재배치한다. (2개 미만이면 변경 없음)

distributeShapes(
  shapeProxyList: (Shape | Image | Line | Group | Chart | Table | Diagram | OleObject | Control)[],
  direction: DistributeDirection
): Promise<void>;

매개변수

이름	타입	설명
`shapeProxyList`	`(Shape \| Image \| Line \| Group \| Chart \| Table \| Diagram \| OleObject \| Control)[]`	분배할 도형 Proxy 배열
`direction`	`DistributeDirection`	분배 방향

반환값

Promise<void>

`duplicateShape(shapeProxy)`

도형을 복제한다. 차트는 복제할 수 없어 null을 반환한다.

duplicateShape(shapeProxy: Shape | Image | Line | Group | Chart | Table | Diagram | OleObject | Control): Promise<Shape>;

매개변수

이름	타입	설명
`shapeProxy`	`Shape \| Image \| Line \| Group \| Chart \| Table \| Diagram \| OleObject \| Control`	복제할 도형 Proxy

반환값

Promise<Shape> - 새로 생성된 도형 Proxy

`duplicateShapes(shapeProxyList)`

도형을 복제한다. 차트는 복제할 수 없어 결과에서 제외된다.

duplicateShapes(shapeProxyList: (Shape | Image | Line | Group | Chart | Table | Diagram | OleObject | Control)[]): Promise<Shape[]>;

매개변수

이름	타입	설명
`shapeProxyList`	`(Shape \| Image \| Line \| Group \| Chart \| Table \| Diagram \| OleObject \| Control)[]`	복제할 도형 Proxy 배열

반환값

Promise<Shape[]> - 새로 생성된 도형 Proxy 배열

`findCharts(filter)`

조건에 맞는 차트 배열을 반환한다.

findCharts(filter?: ChartFilter): Promise<Chart[]>;

매개변수

이름	타입	설명
`filter` (선택)	`ChartFilter`	검색 조건 (기본값: 전체 차트)

반환값

Promise<Chart[]>

`findComments(filter)`

조건에 맞는 댓글을 검색한다.

findComments(filter?: CommentFilter): Promise<Comment[]>;

매개변수

이름	타입	설명
`filter` (선택)	`CommentFilter`	검색 조건 (기본값: 전체 댓글)

반환값

Promise<Comment[]> - 조건에 맞는 댓글 목록

`findShapes(filter)`

조건에 맞는 도형을 검색한다.

findShapes(filter?: ShapeFilter): Promise<Shape[]>;

매개변수

이름	타입	설명
`filter` (선택)	`ShapeFilter`	검색 조건 (기본값: 전체 도형)

반환값

Promise<Shape[]> - 조건에 맞는 도형 목록

`findTables(filter)`

조건에 맞는 표를 검색한다.

findTables(filter?: TableFilter): Promise<Table[]>;

매개변수

이름	타입	설명
`filter` (선택)	`TableFilter`	검색 조건 (기본값: 전체 표)

반환값

Promise<Table[]> - 조건에 맞는 표 목록

`findText(query, caseSensitive)`

이 슬라이드에서 텍스트를 검색한다. 매치는 도형 → 표 셀 순서로 반환된다. 병합된 표 셀, 슬라이드 번호·날짜 같은 자동 갱신 필드, 문단 경계를 가로지르는 매치는 검색되지 않는다.

findText(
  query: string,
  caseSensitive?: boolean
): Promise<{ target: (TableCell | Shape); range: { from: number; to: number }; text: string }[]>;

매개변수

이름	타입	설명
`query`	`string`	찾을 텍스트
`caseSensitive` (선택)	`boolean`	대소문자 구분 (기본값: false)

반환값

Promise<{ target: (TableCell | Shape); range: { from: number; to: number }; text: string }[]> - 매치 목록. target 은 표 셀 매치면 TableCell, 아니면 도형 프록시(Shape)이며, range(글자 offset, to 포함)를 그대로 서식 API 에 넘겨 매치 구간만 편집할 수 있다 (예: m.target.setBold(true, m.range)). text 는 검색 시점의 매치 텍스트다.

`getBackgroundFill()`

슬라이드에 명시적으로 설정된 배경 채우기를 반환한다. (setSolidFill/setGradientFill/setImageFill 대칭) 레이아웃/마스터 상속 배경은 포함하지 않으며, 슬라이드 자체 배경이 없으면 \{ type: "none" \}.

getBackgroundFill(): Promise<Fill | null>;

반환값

Promise<Fill | null> - 배경 채우기 정보. 대상 슬라이드가 없으면 null

`getColorScheme()`

이 슬라이드에 적용된 색상 테마를 반환한다. 슬라이드 재정의가 없으면 마스터(문서) 테마가 반환된다.

getColorScheme(): Promise<{ prst: string | null; name: string; colors: Record<string, unknown> } | null>;

반환값

Promise<{ prst: string | null; name: string; colors: Record<string, unknown> } | null> - 색상 테마 (prst: doc.getColorSchemeList() 에 있는 테마일 때만 채워짐, name: 표시 이름, colors: 슬롯 이름 → #RRGGBB). 대상 슬라이드가 없으면 null

`getComments()`

슬라이드의 최상위 댓글(답글 제외) 목록을 반환한다.

getComments(): Promise<Comment[]>;

반환값

Promise<Comment[]> - 댓글 목록

`getDate()`

날짜 머리글/바닥글 설정을 반환한다. (setDate 대칭) 자동갱신 날짜는 { format, language }, 고정 텍스트 날짜는 { text } 로 반환한다.

getDate(): Promise<HeaderFooterDate | null>;

반환값

Promise<HeaderFooterDate | null> - 날짜 설정. 날짜 머리글/바닥글이 없거나 대상 슬라이드가 없으면 null. DateFormat/DateLanguage 밖의 파일 저장값은 해당 필드를 생략한다

`getFooter()`

바닥글 텍스트를 반환한다.

getFooter(): Promise<string | null>;

반환값

Promise<string | null> - 바닥글 텍스트. 바닥글이 없거나 대상 슬라이드가 없으면 null

`getLayoutType()`

슬라이드에 적용된 레이아웃 종류를 반환한다. (setLayout 대칭)

getLayoutType(): Promise<SlideLayoutType | null>;

반환값

Promise<SlideLayoutType | null> - 레이아웃 종류. 없으면 null

`getNextComment(commentProxy)`

UI의 메모 탐색 기준으로 다음 최상위 댓글을 반환한다.

getNextComment(commentProxy: Comment): Promise<Comment>;

매개변수

이름	타입	설명
`commentProxy`	`Comment`	기준 최상위 댓글

반환값

Promise<Comment> - 다음 댓글 (없으면 null)

`getPrevComment(commentProxy)`

UI의 메모 탐색 기준으로 이전 최상위 댓글을 반환한다.

getPrevComment(commentProxy: Comment): Promise<Comment>;

매개변수

이름	타입	설명
`commentProxy`	`Comment`	기준 최상위 댓글

반환값

Promise<Comment> - 이전 댓글 (없으면 null)

`getShape(index)`

인덱스로 도형을 가져온다.

getShape(index: number): Promise<Shape>;

매개변수

이름	타입	설명
`index`	`number`	0-based

반환값

Promise<Shape> - 해당 도형 (범위를 벗어나면 null)

`getShapes()`

슬라이드의 모든 도형을 반환한다.

getShapes(): Promise<Shape[]>;

반환값

Promise<Shape[]> - 도형 목록

`getSlideNoteText()`

슬라이드 노트의 텍스트를 plain text 로 반환한다. 노트 슬라이드가 없으면 생성하지 않고 빈 문자열을 반환한다.

getSlideNoteText(): Promise<string | null>;

반환값

Promise<string | null> - 노트 텍스트. 대상 슬라이드가 없으면 null

`getTransition()`

슬라이드 전환 효과를 setTransition 의 평면 입력 형태로 반환한다. (setTransition 대칭) 표준 효과는 완전 대칭이나, 한쇼 확장 저장 케이스(대각선 wipe/strips 는 wipeout, plus 안쪽은 fourboxwipe)는 부분 복원된다: wipeout 은 type=strips 로 되돌아가며(대각선 wipe 와 strips 는 동일 애니메이션이라 strips 로 통일), dur/spokes 등 setTransition 입력이 아닌 값은 반환하지 않는다.

getTransition(): Promise<Transition | null>;

반환값

Promise<Transition | null> - 전환 효과 설정. 효과가 없거나 대상 슬라이드가 없으면 null

`groupShapes(shapeProxyList)`

여러 도형을 하나의 그룹으로 묶는다. 묶인 도형은 그룹의 자식으로 다시 만들어지므로 넘긴 프록시는 더 이상 유효하지 않다. 자식은 반환된 그룹의 getChildren() 으로 다시 얻는다.

groupShapes(shapeProxyList: (Shape | Image | Line | Group | Chart | Table | Diagram | OleObject | Control)[]): Promise<Group>;

매개변수

이름	타입	설명
`shapeProxyList`	`(Shape \| Image \| Line \| Group \| Chart \| Table \| Diagram \| OleObject \| Control)[]`	그룹화할 도형 Proxy 배열 (2개 미만이면 throw)

반환값

Promise<Group> - 생성된 그룹 도형 (실패 시 null)

`hide(isHidden)`

이 슬라이드의 숨김 상태를 설정한다.

hide(isHidden: boolean): Promise<void>;

매개변수

이름	타입	설명
`isHidden`	`boolean`	true: 슬라이드 숨김, false: 슬라이드 표시

반환값

Promise<void>

`insertComment(text)`

댓글을 추가한다.

insertComment(text: string): Promise<Comment>;

매개변수

이름	타입	설명
`text`	`string`	댓글 텍스트

반환값

Promise<Comment> - 생성된 댓글 (실패 시 null)

`insertImage(url)`

웹 이미지를 삽입한다.

insertImage(url: string): Promise<Image>;

매개변수

이름	타입	설명
`url`	`string`	이미지 URL

반환값

Promise<Image> - 삽입된 이미지 도형 Proxy

`insertShape(presetId, transform)`

도형을 삽입한다.

insertShape(
  presetId?: ShapePreset,
  transform?: { x?: number; y?: number; width?: number; height?: number; angle?: number }
): Promise<Shape>;

매개변수

이름	타입	설명
`presetId` (선택)	`ShapePreset`	도형 프리셋 ID (ShapePreset enum 참조) (기본값: ShapePreset.RECT)
`transform` (선택)	`{ x?: number; y?: number; width?: number; height?: number; angle?: number }`	위치/크기 (px 단위) (기본값: 슬라이드 중앙, 기본 크기)
`transform.x` (선택)	`number`	X 좌표 (px) (기본값: 가로 중앙)
`transform.y` (선택)	`number`	Y 좌표 (px) (기본값: 세로 중앙)
`transform.width` (선택)	`number`	너비 (px) (기본값: 프리셋 기본 크기)
`transform.height` (선택)	`number`	높이 (px) (기본값: 프리셋 기본 크기)
`transform.angle` (선택)	`number`	회전 각도 (degree) (기본값: 0)

반환값

Promise<Shape> - 삽입된 도형

`insertTable(rowNum, colNum, styleName)`

표를 삽입한다.

insertTable(rowNum: number, colNum: number, styleName?: string): Promise<Table>;

매개변수

이름	타입	설명
`rowNum`	`number`	행 수
`colNum`	`number`	열 수
`styleName` (선택)	`string`	표 스타일 이름 (doc.getTableStyleNames() 결과). 목록에 없는 이름이면 throw (기본값: 문서 기본 스타일)

반환값

Promise<Table> - 삽입된 표

`insertTextBox(transform)`

글상자(텍스트박스)를 삽입한다. 삽입 후 반환된 프록시의 setText/insertText 로 텍스트를 넣는다.

insertTextBox(transform?: { x?: number; y?: number; width?: number; height?: number; angle?: number }): Promise<Shape>;

매개변수

이름	타입	설명
`transform` (선택)	`{ x?: number; y?: number; width?: number; height?: number; angle?: number }`	위치/크기 (px 단위) (기본값: 슬라이드 중앙, 기본 크기)
`transform.x` (선택)	`number`	X 좌표 (px) (기본값: 가로 중앙)
`transform.y` (선택)	`number`	Y 좌표 (px) (기본값: 세로 중앙)
`transform.width` (선택)	`number`	너비 (px) (기본값: 기본 크기)
`transform.height` (선택)	`number`	높이 (px) (기본값: 기본 크기)
`transform.angle` (선택)	`number`	회전 각도 (degree) (기본값: 0)

반환값

Promise<Shape>

`insertWebVideo(url)`

웹 동영상(YouTube / 3DS)을 삽입한다.

insertWebVideo(url: string): Promise<Image>;

매개변수

이름	타입	설명
`url`	`string`	웹 동영상 URL (YouTube watch/embed/shorts/youtu.be, 3DS media)

반환값

Promise<Image> - 삽입된 웹 동영상 도형 Proxy

`isHidden()`

슬라이드 숨김 여부를 반환한다.

isHidden(): Promise<boolean | null>;

반환값

Promise<boolean | null> - 숨김 슬라이드면 true. 대상 슬라이드가 없으면 null

`isShowMasterShapes()`

마스터(레이아웃)의 배경 도형 표시 여부를 반환한다. 이 슬라이드에 설정된 값 기준이다.

isShowMasterShapes(): Promise<boolean | null>;

반환값

Promise<boolean | null> - 마스터 도형이 표시 중이면 true. 대상 슬라이드가 없으면 null

`isSlideNumberVisible()`

슬라이드 번호 표시 여부를 반환한다.

isSlideNumberVisible(): Promise<boolean | null>;

반환값

Promise<boolean | null> - 슬라이드 번호가 표시 중이면 true. 대상 슬라이드가 없으면 null

`previewTransition(autoPreview)`

이 슬라이드에 설정된 전환 효과 미리보기를 화면에서 재생한다. 미리보기는 현재 보고 있는 슬라이드에서만 동작하므로, 이 슬라이드가 현재 슬라이드가 아니면 재생하지 않고 예외를 던진다. 다른 슬라이드는 먼저 goToSlide 로 이동한 뒤 호출한다. 문서를 변경하지 않는 표시용 동작이다.

previewTransition(autoPreview?: boolean): Promise<void>;

매개변수

이름	타입	설명
`autoPreview` (선택)	`boolean`	지정하면 재생 대신 '자동 미리보기 설정'을 on/off 로 토글한다 (전환 효과 설정 시 자동으로 미리보기를 재생할지 여부, 앱 전역 설정) (기본값: 없음(즉시 미리보기 재생))

반환값

Promise<void>

`removeDate()`

이 슬라이드의 날짜 머리글/바닥글을 제거한다.

removeDate(): Promise<void>;

반환값

Promise<void>

`removeFill()`

슬라이드 배경 채우기를 제거한다.

removeFill(): Promise<void>;

반환값

Promise<void>

`removeFooter()`

이 슬라이드의 바닥글을 제거한다.

removeFooter(): Promise<void>;

반환값

Promise<void>

`removeSlideNumber()`

이 슬라이드의 슬라이드 번호를 제거한다.

removeSlideNumber(): Promise<void>;

반환값

Promise<void>

`removeTransition()`

전환 효과를 제거한다.

removeTransition(): Promise<void>;

반환값

Promise<void>

`replaceText(query, replacement, caseSensitive)`

이 슬라이드에서 검색 텍스트를 찾아 모두 새 텍스트로 바꾼다. (모두 바꾸기) 병합된 표 셀, 슬라이드 번호·날짜 같은 자동 갱신 필드, 문단 경계를 가로지르는 매치는 바뀌지 않는다. 협업 잠금 등으로 편집할 수 없는 텍스트의 매치도 바꾸지 않고 skippedCount 로 반환한다.

replaceText(
  query: string,
  replacement?: string,
  caseSensitive?: boolean
): Promise<{ replacedCount: number; skippedCount: number }>;

매개변수

이름	타입	설명
`query`	`string`	찾을 텍스트
`replacement` (선택)	`string`	바꿀 텍스트. 빈 문자열이면 매치를 삭제한다 (기본값: "")
`caseSensitive` (선택)	`boolean`	대소문자 구분 (기본값: false)

반환값

Promise<{ replacedCount: number; skippedCount: number }> - 치환한 매치 수 / 제외한 매치 수

`replyComment(commentProxy, text)`

댓글에 답글을 추가한다.

replyComment(commentProxy: Comment, text: string): Promise<Comment>;

매개변수

이름	타입	설명
`commentProxy`	`Comment`	부모 댓글
`text`	`string`	답글 텍스트

반환값

Promise<Comment> - 생성된 답글 (실패 시 null)

`resetBackground()`

슬라이드 배경을 초기화한다.

resetBackground(): Promise<void>;

반환값

Promise<void>

`resetLayout()`

슬라이드 레이아웃을 초기화한다.

resetLayout(): Promise<void>;

반환값

Promise<void>

`saveAsPicture(shapeProxyList)`

슬라이드의 도형들을 하나의 이미지로 저장한다. (기존 UI 동작과 동일)

saveAsPicture(shapeProxyList: (Shape | Image | Line | Group | Chart | Table | Diagram | OleObject | Control)[]): Promise<void>;

매개변수

이름	타입	설명
`shapeProxyList`	`(Shape \| Image \| Line \| Group \| Chart \| Table \| Diagram \| OleObject \| Control)[]`	이미지로 저장할 도형 Proxy 배열

반환값

Promise<void>

`setDate(date)`

이 슬라이드의 날짜 머리글/바닥글을 설정한다. (없으면 생성, 있으면 갱신)

setDate(date?: HeaderFooterDate): Promise<void>;

매개변수

이름	타입	설명
`date` (선택)	`HeaderFooterDate`	날짜 설정 (기본값: 자동갱신 날짜)

반환값

Promise<void>

`setFill(fill)`

getBackgroundFill() 이 반환한 채우기 객체를 그대로 슬라이드 배경에 적용한다. (getBackgroundFill 대칭) type 으로 분기해 대응 setter 를 호출한다. image 는 readback 의 embed 를 재사용해 같은 문서 안에서 복원한다. embed 가 없는 image 입력은 무시된다(새 이미지는 개별 setImageFill 사용).

setFill(fill: Fill): Promise<void>;

매개변수

이름	타입	설명
`fill`	`Fill`	getBackgroundFill() 반환값

반환값

Promise<void>

`setFooter(text)`

이 슬라이드의 바닥글을 설정한다. (없으면 생성, 있으면 갱신)

setFooter(text: string): Promise<void>;

매개변수

이름	타입	설명
`text`	`string`	바닥글 텍스트

반환값

Promise<void>

`setGradientFill(type, stops, angle)`

슬라이드 배경을 그라데이션으로 설정한다.

setGradientFill(
  type?: GradientType,
  stops?: { color: string; pos?: number; alpha?: number }[],
  angle?: number
): Promise<void>;

매개변수

이름	타입	설명
`type` (선택)	`GradientType`	그라데이션 유형 (lin/circle/rect/shape) (기본값: GradientType.LINEAR)
`stops` (선택)	`{ color: string; pos?: number; alpha?: number }[]`	색상 변화점. pos 생략 시 균등 분배, alpha 는 투명도(0~100) (기본값: [{ color: "accent1", pos: 0 }, { color: "bg1", pos: 100 }])
`angle` (선택)	`number`	그라데이션 각도 (lin 일 때만 사용) (기본값: 45)

반환값

Promise<void>

`setImageFill(imageUrl, fillMode, alpha, detail)`

슬라이드 배경을 이미지로 설정한다.

setImageFill(
  imageUrl: string,
  fillMode?: ImageFillMode,
  alpha?: number,
  detail?: ImageFillDetail
): Promise<void>;

매개변수

이름	타입	설명
`imageUrl`	`string`	이미지 URL
`fillMode` (선택)	`ImageFillMode`	이미지 채우기 방식 (기본값: ImageFillMode.STRETCH)
`alpha` (선택)	`number`	투명도 (0~100) (기본값: 0(불투명))
`detail` (선택)	`ImageFillDetail`	세부 옵션. offset/scale/mirror/align 은 fillMode=ImageFillMode.TILE 일 때만 반영 (기본값: {})

반환값

Promise<void> - 이미지 업로드 후 배경 적용이 끝나면 resolve

`setLayout(layoutType)`

슬라이드에 레이아웃을 적용한다. 같은 type 이 여럿이면 마스터 순서상 첫 번째 레이아웃이 선택된다.

setLayout(layoutType: SlideLayoutType): Promise<boolean>;

매개변수

이름	타입	설명
`layoutType`	`SlideLayoutType`	레이아웃 종류. doc.getLayoutList(slide) 로 사용 가능한 type 확인

반환값

Promise<boolean> - 적용 여부 (해당 type 이 이 슬라이드의 마스터에 없으면 false)

`setPatternFill(preset, foreColor, backColor, foreAlpha, backAlpha)`

슬라이드 배경을 패턴(무늬)으로 설정한다. (getBackgroundFill 왕복 대칭 - setFill 의 pattern 경로)

setPatternFill(
  preset: PatternPreset,
  foreColor?: string,
  backColor?: string,
  foreAlpha?: number,
  backAlpha?: number
): Promise<void>;

매개변수

이름	타입	설명
`preset`	`PatternPreset`	무늬 프리셋 (apiConstants.PatternPreset)
`foreColor` (선택)	`string`	전경색 hex (#RRGGBB) 또는 scheme color (기본값: accent1(테마 강조색1))
`backColor` (선택)	`string`	배경색 hex (#RRGGBB) 또는 scheme color (기본값: bg1(테마 배경색1))
`foreAlpha` (선택)	`number`	전경색 투명도 (0~100) (기본값: 0(불투명))
`backAlpha` (선택)	`number`	배경색 투명도 (0~100) (기본값: 0(불투명))

반환값

Promise<void>

`setShowMasterShapes(show)`

마스터(레이아웃)의 배경 도형 표시 여부를 설정한다.

setShowMasterShapes(show: boolean): Promise<void>;

매개변수

이름	타입	설명
`show`	`boolean`	true: 마스터 도형 표시, false: 숨김

반환값

Promise<void>

`setSlideNoteText(text)`

슬라이드 노트 텍스트를 설정한다. (기존 노트 내용은 대체됨)

setSlideNoteText(text: string): Promise<void>;

매개변수

이름	타입	설명
`text`	`string`	노트 텍스트

반환값

Promise<void>

`setSlideNumber()`

이 슬라이드에 슬라이드 번호를 표시한다.

setSlideNumber(): Promise<void>;

반환값

Promise<void>

`setSolidFill(color, alpha)`

슬라이드 배경을 단색으로 설정한다.

setSolidFill(color: string, alpha?: number): Promise<void>;

매개변수

이름	타입	설명
`color`	`string`	hex (#RRGGBB) 또는 scheme color
`alpha` (선택)	`number`	투명도 (0~100) (기본값: 0(불투명))

반환값

Promise<void>

`setTransition(transition)`

슬라이드 전환 효과를 설정한다. 평면 입력을 모델 포맷으로 변환해 적용한다. 효과가 지원하는 옵션만 반영되며, 주지 않은 값은 기본 모델에서 채운다. 효과 제거는 type 으로 하지 않고 removeTransition() 을 사용한다.

setTransition(transition: Transition): Promise<void>;

매개변수

이름	타입	설명
`transition`	`Transition`	전환 효과 설정

반환값

Promise<void>

`ungroupShapes(shapeProxy)`

그룹을 해제해 자식 도형으로 분리한다. 분리된 자식은 새 도형으로 다시 만들어지므로 해제 전에 얻어 둔 자식 프록시는 더 이상 유효하지 않다. 분리된 도형은 반환값으로 받는다.

ungroupShapes(shapeProxy: Group): Promise<Shape[]>;

매개변수

이름	타입	설명
`shapeProxy`	`Group`	그룹 해제할 그룹 도형 Proxy

반환값

Promise<Shape[]> - 분리된 자식 도형 배열

비고
메서드
메서드 상세

비고​

메서드​

메서드 상세​

appendSlideNoteText(text)​

deleteComment(commentProxy)​

deleteComments(commentProxyList)​

deleteShape(shapeProxy)​

deleteShapes(shapeProxyList)​

distributeShapes(shapeProxyList, direction)​

duplicateShape(shapeProxy)​

duplicateShapes(shapeProxyList)​

findCharts(filter)​

findComments(filter)​

findShapes(filter)​

findTables(filter)​

findText(query, caseSensitive)​

getBackgroundFill()​

getColorScheme()​

getComments()​

getDate()​

getFooter()​

getLayoutType()​

getNextComment(commentProxy)​

getPrevComment(commentProxy)​

getShape(index)​

getShapes()​

getSlideNoteText()​

getTransition()​

groupShapes(shapeProxyList)​

hide(isHidden)​

insertComment(text)​

insertImage(url)​

insertShape(presetId, transform)​

insertTable(rowNum, colNum, styleName)​

insertTextBox(transform)​

insertWebVideo(url)​

isHidden()​

isShowMasterShapes()​

isSlideNumberVisible()​

previewTransition(autoPreview)​

removeDate()​

removeFill()​

removeFooter()​

removeSlideNumber()​

removeTransition()​

replaceText(query, replacement, caseSensitive)​

replyComment(commentProxy, text)​

resetBackground()​

resetLayout()​

saveAsPicture(shapeProxyList)​

setDate(date)​

setFill(fill)​

setFooter(text)​

setGradientFill(type, stops, angle)​

setImageFill(imageUrl, fillMode, alpha, detail)​

setLayout(layoutType)​

setPatternFill(preset, foreColor, backColor, foreAlpha, backAlpha)​

setShowMasterShapes(show)​

setSlideNoteText(text)​

setSlideNumber()​

setSolidFill(color, alpha)​

setTransition(transition)​

ungroupShapes(shapeProxy)​

비고

메서드

메서드 상세

`appendSlideNoteText(text)`

`deleteComment(commentProxy)`

`deleteComments(commentProxyList)`

`deleteShape(shapeProxy)`

`deleteShapes(shapeProxyList)`

`distributeShapes(shapeProxyList, direction)`

`duplicateShape(shapeProxy)`

`duplicateShapes(shapeProxyList)`

`findCharts(filter)`

`findComments(filter)`

`findShapes(filter)`

`findTables(filter)`

`findText(query, caseSensitive)`

`getBackgroundFill()`

`getColorScheme()`

`getComments()`

`getDate()`

`getFooter()`

`getLayoutType()`

`getNextComment(commentProxy)`

`getPrevComment(commentProxy)`

`getShape(index)`

`getShapes()`

`getSlideNoteText()`

`getTransition()`

`groupShapes(shapeProxyList)`

`hide(isHidden)`

`insertComment(text)`

`insertImage(url)`

`insertShape(presetId, transform)`

`insertTable(rowNum, colNum, styleName)`

`insertTextBox(transform)`

`insertWebVideo(url)`

`isHidden()`

`isShowMasterShapes()`

`isSlideNumberVisible()`

`previewTransition(autoPreview)`

`removeDate()`

`removeFill()`

`removeFooter()`

`removeSlideNumber()`

`removeTransition()`

`replaceText(query, replacement, caseSensitive)`

`replyComment(commentProxy, text)`

`resetBackground()`

`resetLayout()`

`saveAsPicture(shapeProxyList)`

`setDate(date)`

`setFill(fill)`

`setFooter(text)`

`setGradientFill(type, stops, angle)`

`setImageFill(imageUrl, fillMode, alpha, detail)`

`setLayout(layoutType)`

`setPatternFill(preset, foreColor, backColor, foreAlpha, backAlpha)`

`setShowMasterShapes(show)`

`setSlideNoteText(text)`

`setSlideNumber()`

`setSolidFill(color, alpha)`

`setTransition(transition)`

`ungroupShapes(shapeProxy)`