Word.Paragraph

Word.Paragraph은 Word 모듈(Office.word(iframe))의 객체 타입입니다. 메서드 44개.

Generated from the SDK type definitions

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

비고

모듈: Word · Office.word(iframe) · 네임스페이스 Word
얻는 방법: Document.getParagraph(paragraphId), Body.getParagraph(index), Body.getParagraphs(), Body.insertParagraph(text, options), Range.getParagraph(), Range.insertParagraph(text, options), TableCell.getParagraph(index), TableCell.getParagraphs()
모든 메서드는 Promise를 반환하며, 시그니처는 TypeScript 표기입니다.

메서드

메서드	설명
`acceptChangeTrackings()`	이 단락과 겹치는 모든 변경 추적 항목을 수락한다.
`clearFormat()`	단락 전체의 글자 서식과 단락 서식을 초기화한다.
`clearList()`	이 단락의 목록을 해제한다.
`delete()`	단락을 삭제한다.
`getChangeTrackings()`	이 단락과 겹치는 변경 추적 항목 목록을 반환한다.
`getComments()`	이 단락 범위와 겹치는 댓글 목록을 반환한다.
`getContentHtml()`	이 단락의 내용을 서식이 포함된 HTML로 반환한다.
`getEndnotes()`	이 단락 안의 미주 목록을 반환한다.
`getFootnotes()`	이 단락 안의 각주 목록을 반환한다.
`getId()`	단락 ID를 반환한다.
`getList()`	이 단락의 목록을 반환한다.
`getNextSibling()`	바로 뒤에 있는 단락을 반환한다.
`getNotes()`	이 단락 안의 각주/미주 목록을 반환한다.
`getParentBody()`	이 단락이 속한 영역(본문/머리글/바닥글 등)을 반환한다.
`getParentTable()`	이 단락이 속한 가장 가까운 표를 반환한다.
`getParentTableCell()`	이 단락이 속한 가장 가까운 표 셀을 반환한다.
`getPreviousSibling()`	바로 앞에 있는 단락을 반환한다.
`getRange(startOffset, endOffset)`	이 단락에서 지정한 글자 위치 구간의 범위를 반환한다.
`getStructure()`	이 단락의 구조 정보를 반환한다.
`getText()`	단락의 텍스트를 반환한다.
`insertColumnBreak(options)`	단락 안에 단 나누기를 삽입한다.
`insertEndnote(text, options)`	단락 위치에 미주를 삽입한다.
`insertFootnote(text, options)`	단락 위치에 각주를 삽입한다.
`insertImage(options)`	단락 안에 이미지를 글자처럼 배치해 삽입한다.
`insertLineBreak(options)`	단락 안에 줄 나누기를 삽입한다.
`insertPageBreak(options)`	단락 안에 페이지 나누기를 삽입한다.
`insertParagraph(text, options)`	이 단락의 위·아래에 새 단락을 삽입하거나 지정한 글자 위치에서 단락을 나눈다.
`insertSectionBreak(type, options)`	단락 위치에 구역 나누기를 삽입해 새 구역을 만든다.
`insertShape(preset, options)`	단락 안에 지정한 모양의 도형을 삽입한다.
`insertSymbol(charCode, options)`	단락 안에 기호를 삽입한다.
`insertTab(options)`	단락 안에 탭 문자를 삽입한다.
`insertTable(rows, columns, options)`	이 단락 위/아래에 표를 삽입하거나, 단락 안 글자 위치에서 나눠 그 사이에 삽입한다.
`insertText(text, options)`	단락 안에 텍스트를 삽입하거나 단락 전체 내용을 교체한다.
`insertTextbox(options)`	단락 안에 텍스트박스를 삽입한다.
`insertWebVideo(url, options)`	단락 안에 웹 동영상을 글자처럼 배치해 삽입한다.
`rejectChangeTrackings()`	이 단락과 겹치는 모든 변경 추적 항목을 거부한다.
`select(mode)`	이 단락을 화면 선택 영역으로 지정한다.
`setIndent(type)`	들여쓰기/내어쓰기를 한 단계 조정한다.
`setList(listType)`	이 단락에 지정한 목록 서식을 적용한다.
`setParagraphBorder(border)`	이 단락에 테두리를 설정한다.
`setParagraphFormat(options)`	이 단락에 지정한 단락 서식을 적용한다.
`setStyle(style)`	이 단락에 스타일을 적용한다.
`setTabs(tabs)`	이 단락의 탭 정지 위치를 설정한다.
`setTextFormat(options)`	단락 전체 텍스트에 글자 서식을 적용한다.

메서드 상세

`acceptChangeTrackings()`

이 단락과 겹치는 모든 변경 추적 항목을 수락한다.

acceptChangeTrackings(): Promise<{ processedCount: number; remainingCount: number; failedIds: string[] }>;

반환값

Promise<{ processedCount: number; remainingCount: number; failedIds: string[] }> - 처리 결과

`clearFormat()`

단락 전체의 글자 서식과 단락 서식을 초기화한다.

clearFormat(): Promise<void>;

반환값

Promise<void>

`clearList()`

이 단락의 목록을 해제한다. - 여러 단락을 한 번에 해제하려면 WordRange 의 clearList 를 쓴다.

clearList(): Promise<void>;

반환값

Promise<void>

`delete()`

단락을 삭제한다. - 뒤에 다른 단락이 없으면 단락을 유지하고 글자만 삭제한다.

delete(): Promise<void>;

반환값

Promise<void>

`getChangeTrackings()`

이 단락과 겹치는 변경 추적 항목 목록을 반환한다.

getChangeTrackings(): Promise<WordChangeTracking[]>;

반환값

Promise<WordChangeTracking[]> - 변경 추적 목록

`getComments()`

이 단락 범위와 겹치는 댓글 목록을 반환한다.

getComments(): Promise<WordComment[]>;

반환값

Promise<WordComment[]> - 댓글 목록

`getContentHtml()`

이 단락의 내용을 서식이 포함된 HTML로 반환한다. - 단락은 <p> 요소로 표현한다.

getContentHtml(): Promise<{ html: string; paragraphCount: number }>;

반환값

Promise<{ html: string; paragraphCount: number }> - 이 단락 HTML·단락 수

`getEndnotes()`

이 단락 안의 미주 목록을 반환한다.

getEndnotes(): Promise<WordNote[]>;

반환값

Promise<WordNote[]> - 미주 목록

`getFootnotes()`

이 단락 안의 각주 목록을 반환한다.

getFootnotes(): Promise<WordNote[]>;

반환값

Promise<WordNote[]> - 각주 목록

`getId()`

단락 ID를 반환한다.

getId(): Promise<string>;

반환값

Promise<string> - 단락 ID

`getList()`

이 단락의 목록을 반환한다. - 목록 단계 변경과 번호 다시 매기기에 사용한다.

getList(): Promise<List>;

반환값

Promise<List> - 목록 핸들, 목록이 아닌 단락이면 null

`getNextSibling()`

바로 뒤에 있는 단락을 반환한다. - 뒤 요소가 표 등 단락이 아니거나 존재하지 않으면 null을 반환한다. 구역 경계는 넘지 않는다.

getNextSibling(): Promise<Paragraph>;

반환값

Promise<Paragraph> - 다음 단락. 없거나 뒤 요소가 단락이 아니면 null

`getNotes()`

이 단락 안의 각주/미주 목록을 반환한다.

getNotes(): Promise<WordNote[]>;

반환값

Promise<WordNote[]> - 각주·미주 목록

`getParentBody()`

이 단락이 속한 영역(본문/머리글/바닥글 등)을 반환한다.

getParentBody(): Promise<Body>;

반환값

Promise<Body> - 이 단락이 속한 영역

`getParentTable()`

이 단락이 속한 가장 가까운 표를 반환한다. - 표 밖의 단락은 null을 반환한다. 중첩 표에서는 안쪽 표를 반환한다.

getParentTable(): Promise<Table>;

반환값

Promise<Table> - 상위 표 객체, 표 밖이면 null

`getParentTableCell()`

이 단락이 속한 가장 가까운 표 셀을 반환한다. - 셀 밖의 단락은 null을 반환한다. 중첩 표에서는 안쪽 셀을 반환한다.

getParentTableCell(): Promise<TableCell>;

반환값

Promise<TableCell> - 상위 셀 객체, 셀 밖이면 null

`getPreviousSibling()`

바로 앞에 있는 단락을 반환한다. - 앞 요소가 표 등 단락이 아니거나 존재하지 않으면 null을 반환한다. 구역 경계는 넘지 않는다.

getPreviousSibling(): Promise<Paragraph>;

반환값

Promise<Paragraph> - 이전 단락. 없거나 앞 요소가 단락이 아니면 null

`getRange(startOffset, endOffset)`

이 단락에서 지정한 글자 위치 구간의 범위를 반환한다.

getRange(startOffset?: number, endOffset?: number): Promise<Range>;

매개변수

이름	타입	설명
`startOffset` (선택)	`number`	시작 글자 위치(0부터 시작하는). 기본값은 단락 시작 (기본값: paragraph start)
`endOffset` (선택)	`number`	끝 글자 위치. 기본값은 단락 끝 (기본값: paragraph end)

반환값

Promise<Range> - 단락 내 offset 범위에 바인딩된 범위 객체

`getStructure()`

이 단락의 구조 정보를 반환한다. - 인덱스·종류·단락 ID·영역 ID·텍스트를 포함한다.

getStructure(): Promise<{ paragraphs: { index: number; type: string; id: string; storyId: string; text: string }[] }>;

반환값

Promise<{ paragraphs: { index: number; type: string; id: string; storyId: string; text: string }[] }> - 이 단락 항목 하나를 담은 목록

`getText()`

단락의 텍스트를 반환한다.
반환된 텍스트에서 계산한 글자 위치는 insertText()의 offset 또는 getRange()의 글자 위치로 사용한다.
탭은 "\t", 줄·페이지·단 나누기는 "\n", 각주·도형 등의 개체는 "\uFFFC" 한 글자로 표현한다.
단락 끝을 나타내는 개행은 포함하지 않는다.

getText(): Promise<string>;

반환값

Promise<string> - 단락 안 글자들을 이은 텍스트 (없으면 "")

`insertColumnBreak(options)`

단락 안에 단 나누기를 삽입한다. - 뒤 내용은 다음 단에서 시작하며, 구역이 1단이면 다음 페이지에서 시작한다. 본문에만 삽입할 수 있다.

insertColumnBreak(options?: { offset?: number; position?: InsertAt }): Promise<void>;

매개변수

이름	타입	설명
`options` (선택)	`{ offset?: number; position?: InsertAt }`	삽입 위치 옵션
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). position 보다 우선
`options.position` (선택)	`InsertAt`	삽입 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)

반환값

Promise<void>

`insertEndnote(text, options)`

단락 위치에 미주를 삽입한다.

insertEndnote(
  text?: string,
  options?: { offset?: number; position?: InsertAt }
): Promise<WordNote>;

매개변수

이름	타입	설명
`text` (선택)	`string`	미주 내용 초기 텍스트. 기본값은 빈 미주 (기본값: empty endnote)
`options` (선택)	`{ offset?: number; position?: InsertAt }`	삽입 위치 옵션
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). position 보다 우선
`options.position` (선택)	`InsertAt`	삽입 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)

반환값

Promise<WordNote> - 생성된 미주 객체

`insertFootnote(text, options)`

단락 위치에 각주를 삽입한다.

insertFootnote(
  text?: string,
  options?: { offset?: number; position?: InsertAt }
): Promise<WordNote>;

매개변수

이름	타입	설명
`text` (선택)	`string`	각주 내용 초기 텍스트. 기본값은 빈 각주 (기본값: empty footnote)
`options` (선택)	`{ offset?: number; position?: InsertAt }`	삽입 위치 옵션
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). position 보다 우선
`options.position` (선택)	`InsertAt`	삽입 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)

반환값

Promise<WordNote> - 생성된 각주 객체

`insertImage(options)`

단락 안에 이미지를 글자처럼 배치해 삽입한다. - 이미지 출처와 관계없이 비동기로 처리한다.

insertImage(options: { src?: string; url?: string; base64?: string; width?: number; height?: number; offset?: number; position?: InsertAt }): Promise<Image>;

매개변수

이름	타입	설명
`options`	`{ src?: string; url?: string; base64?: string; width?: number; height?: number; offset?: number; position?: InsertAt }`	이미지 삽입 옵션 (출처 src/url/base64 중 정확히 하나 필수)
`options.src` (선택)	`string`	이미 업로드된 이미지 경로
`options.url` (선택)	`string`	이미지 URL (선업로드 후 삽입)
`options.base64` (선택)	`string`	base64 데이터 (선업로드 후 삽입)
`options.width` (선택)	`number`	너비(pt). 기본값은 원본 크기 (기본값: original size)
`options.height` (선택)	`number`	높이(pt). 기본값은 원본 크기 (기본값: original size)
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). position 보다 우선
`options.position` (선택)	`InsertAt`	삽입 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)

반환값

Promise<Image> - 삽입된 이미지

`insertLineBreak(options)`

단락 안에 줄 나누기를 삽입한다. - Shift+Enter처럼 단락을 유지하면서 줄만 바꾼다.

insertLineBreak(options?: { offset?: number; position?: InsertAt }): Promise<void>;

매개변수

이름	타입	설명
`options` (선택)	`{ offset?: number; position?: InsertAt }`	삽입 위치 옵션
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). 단락 끝을 넘는 위치는 단락 끝으로 보정한다. position 보다 우선
`options.position` (선택)	`InsertAt`	삽입 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)

반환값

Promise<void>

`insertPageBreak(options)`

단락 안에 페이지 나누기를 삽입한다. - 뒤 내용은 다음 페이지에서 시작한다. 본문에만 삽입할 수 있다.

insertPageBreak(options?: { offset?: number; position?: InsertAt }): Promise<void>;

매개변수

이름	타입	설명
`options` (선택)	`{ offset?: number; position?: InsertAt }`	삽입 위치 옵션
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). position 보다 우선
`options.position` (선택)	`InsertAt`	삽입 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)

반환값

Promise<void>

`insertParagraph(text, options)`

이 단락의 위·아래에 새 단락을 삽입하거나 지정한 글자 위치에서 단락을 나눈다.
새 단락은 이 단락의 정렬·여백·들여쓰기 등 직접 단락 서식을 상속한다.
상속한 직접 서식을 초기화하려면 반환된 단락의 clearFormat()을 호출한다.

insertParagraph(
  text: string,
  options?: { offset?: number; position?: InsertAt }
): Promise<Paragraph>;

매개변수

이름	타입	설명
`text`	`string`	새 단락 텍스트 (빈 문자열이면 빈 단락 - offset 지정 시엔 순수 나누기)
`options` (선택)	`{ offset?: number; position?: InsertAt }`	삽입 옵션
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는)에서 나누기(뒤 내용은 새 단락으로 보존). 단락 끝을 넘는 위치는 단락 끝으로 보정한다. 지정 시 position 무시
`options.position` (선택)	`InsertAt`	형제 삽입 시 이 단락 기준 "before"(위)/"after"(아래) (기본값: InsertAt.AFTER)

반환값

Promise<Paragraph> - 새로 생성된 단락 객체

`insertSectionBreak(type, options)`

단락 위치에 구역 나누기를 삽입해 새 구역을 만든다. - 구역 나누기는 본문에만 삽입할 수 있다(머리글/바닥글/텍스트박스에는 불가).

insertSectionBreak(
  type: SectionBreakType,
  options?: { offset?: number; position?: InsertAt }
): Promise<void>;

매개변수

이름	타입	설명
`type`	`SectionBreakType`	새 구역의 시작 유형 (continuous: 이어서 / nextPage: 다음 페이지부터 / evenPage: 짝수 페이지부터 / oddPage: 홀수 페이지부터)
`options` (선택)	`{ offset?: number; position?: InsertAt }`	삽입 위치 옵션
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). position 보다 우선
`options.position` (선택)	`InsertAt`	삽입 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)

반환값

Promise<void>

`insertShape(preset, options)`

단락 안에 지정한 모양의 도형을 삽입한다. - 삽입 후 반환된 도형으로 서식과 배치를 설정한다.

insertShape(
  preset: ShapePreset,
  options?: { width?: number; height?: number; offset?: number; position?: InsertAt }
): Promise<Shape>;

매개변수

이름	타입	설명
`preset`	`ShapePreset`	도형의 기본 모양 (예: "rect", "ellipse", "roundRect")
`options` (선택)	`{ width?: number; height?: number; offset?: number; position?: InsertAt }`	도형 삽입 옵션
`options.width` (선택)	`number`	너비(pt) (기본값: 75)
`options.height` (선택)	`number`	높이(pt) (기본값: 75)
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). position 보다 우선
`options.position` (선택)	`InsertAt`	삽입 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)

반환값

Promise<Shape> - 삽입된 도형

`insertSymbol(charCode, options)`

단락 안에 기호를 삽입한다.
font 미지정: 해당 유니코드 문자를 일반 텍스트로 삽입한다.
font 지정: 그 글꼴의 기호 글리프로 삽입한다.

insertSymbol(
  charCode: string | number,
  options?: { font?: string; offset?: number; position?: InsertAt }
): Promise<void>;

매개변수

이름	타입	설명
`charCode`	`string \| number`	유니코드 코드포인트(16진 문자열 "2605" \| "0x2605" \| 숫자 0x2605)
`options` (선택)	`{ font?: string; offset?: number; position?: InsertAt }`	기호 삽입 옵션
`options.font` (선택)	`string`	지정 시 그 글꼴의 기호 글리프로 삽입
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). position 보다 우선
`options.position` (선택)	`InsertAt`	삽입 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)

반환값

Promise<void>

`insertTab(options)`

단락 안에 탭 문자를 삽입한다. - 탭 정지 위치는 setTabs()로 별도 설정한다.

insertTab(options?: { offset?: number; position?: InsertAt }): Promise<void>;

매개변수

이름	타입	설명
`options` (선택)	`{ offset?: number; position?: InsertAt }`	삽입 위치 옵션
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). 단락 끝을 넘는 위치는 단락 끝으로 보정한다. position 보다 우선
`options.position` (선택)	`InsertAt`	삽입 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)

반환값

Promise<void>

`insertTable(rows, columns, options)`

이 단락 위/아래에 표를 삽입하거나, 단락 안 글자 위치에서 나눠 그 사이에 삽입한다. - 표 셀 안에는 삽입할 수 없다(중첩 표 미지원 - 삽입 지점이 셀 안이면 오류 발생).

insertTable(
  rows: number,
  columns: number,
  options?: { offset?: number; position?: InsertAt; values?: string[][] }
): Promise<Table>;

매개변수

이름	타입	설명
`rows`	`number`	행 수
`columns`	`number`	열 수
`options` (선택)	`{ offset?: number; position?: InsertAt; values?: string[][] }`	삽입 옵션
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는)에서 나누고 그 사이에 표 삽입(뒤 내용은 새 단락으로 보존). 지정 시 position 무시
`options.position` (선택)	`InsertAt`	형제 삽입 시 이 단락 기준 "before"(위)/"after"(아래) (기본값: InsertAt.AFTER)
`options.values` (선택)	`string[][]`	생성 직후 채울 셀 값(2차원 배열, 표 크기 초과 시 발행 전 오류 발생)

반환값

Promise<Table> - 삽입된 표 객체

`insertText(text, options)`

단락 안에 텍스트를 삽입하거나 단락 전체 내용을 교체한다. - 서식은 유지한다. 서식을 변경하거나 초기화하려면 반환된 범위의 setTextFormat()·clearFormat()·setStyle()을 사용한다.

insertText(
  text: string,
  options?: { offset?: number; position?: InsertAt; replace?: boolean }
): Promise<Range>;

매개변수

이름	타입	설명
`text`	`string`	넣을 텍스트
`options` (선택)	`{ offset?: number; position?: InsertAt; replace?: boolean }`	삽입/교체 옵션
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). position 보다 우선
`options.position` (선택)	`InsertAt`	추가 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)
`options.replace` (선택)	`boolean`	true 면 단락 전체 내용을 새 텍스트로 전체 교체(위치 인자 무시) (기본값: false)

반환값

Promise<Range> - 방금 넣은(교체 시 교체된) 텍스트 범위

`insertTextbox(options)`

단락 안에 텍스트박스를 삽입한다.

insertTextbox(options?: { width?: number; height?: number; text?: string; offset?: number; position?: InsertAt }): Promise<{ shape: WordShape; storyId: string; paragraphId: string }>;

매개변수

이름	타입	설명
`options` (선택)	`{ width?: number; height?: number; text?: string; offset?: number; position?: InsertAt }`	텍스트박스 삽입 옵션
`options.width` (선택)	`number`	너비(pt) (기본값: 75)
`options.height` (선택)	`number`	높이(pt) (기본값: 75)
`options.text` (선택)	`string`	초기 내용 텍스트
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). position 보다 우선
`options.position` (선택)	`InsertAt`	삽입 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)

반환값

Promise<{ shape: WordShape; storyId: string; paragraphId: string }> - 생성 결과 (shape: 도형 객체 / storyId: 텍스트박스 영역 ID / paragraphId: 첫 단락 ID)

`insertWebVideo(url, options)`

단락 안에 웹 동영상을 글자처럼 배치해 삽입한다.
YouTube와 3DS 3DEXPERIENCE 주소를 지원하며 비동기로 처리한다.
미리보기 이미지를 가져올 수 없으면 대체 이미지를 사용한다.

insertWebVideo(
  url: string,
  options?: { width?: number; height?: number; offset?: number; position?: InsertAt }
): Promise<Image>;

매개변수

이름	타입	설명
`url`	`string`	웹 동영상 URL (YouTube / 3DS 3DEXPERIENCE)
`options` (선택)	`{ width?: number; height?: number; offset?: number; position?: InsertAt }`	웹 동영상 삽입 옵션
`options.width` (선택)	`number`	너비(pt). 기본값은 썸네일 원본 크기 (기본값: original thumbnail size)
`options.height` (선택)	`number`	높이(pt). 기본값은 썸네일 원본 크기 (기본값: original thumbnail size)
`options.offset` (선택)	`number`	단락 내 글자 위치(0부터 시작하는). position 보다 우선
`options.position` (선택)	`InsertAt`	삽입 위치(offset 없을 때). start(단락 시작) \| end(단락 끝) (기본값: InsertAt.START)

반환값

Promise<Image> - 삽입된 웹 동영상 이미지 객체

`rejectChangeTrackings()`

이 단락과 겹치는 모든 변경 추적 항목을 거부한다.

rejectChangeTrackings(): Promise<{ processedCount: number; remainingCount: number; failedIds: string[] }>;

반환값

Promise<{ processedCount: number; remainingCount: number; failedIds: string[] }> - 처리 결과

`select(mode)`

이 단락을 화면 선택 영역으로 지정한다. - 문서 내용은 변경하지 않는다.

select(mode?: SelectionMode): Promise<void>;

매개변수

이름	타입	설명
`mode` (선택)	`SelectionMode`	"select"(단락 전체) / "start"(단락 시작에 커서) / "end"(단락 끝에 커서) (기본값: SelectionMode.SELECT)

반환값

Promise<void>

`setIndent(type)`

들여쓰기/내어쓰기를 한 단계 조정한다.
목록 단락이면 목록 단계가, 목록이 아니면 단락 좌여백이 움직인다.
목록 첫 항목이어도 그 항목의 단계만 움직인다.

setIndent(type: IndentType): Promise<void>;

매개변수

이름	타입	설명
`type`	`IndentType`	"indent"(들여쓰기)\|"outdent"(내어쓰기)

반환값

Promise<void>

`setList(listType)`

이 단락에 지정한 목록 서식을 적용한다.
기존 목록에 적용하면 같은 목록의 같은 단계 항목도 함께 바뀐다.
다단계 목록을 적용하면 목록 전체에 반영한다.
목록 단계는 적용 후 getList()로 얻은 목록의 setLevel()로 변경한다.

setList(listType: ListType): Promise<void>;

매개변수

이름	타입	설명
`listType`	`ListType`	적용할 목록 종류. 기본 제공 글머리 기호·번호·다단계 목록 중 선택한다.

반환값

Promise<void>

`setParagraphBorder(border)`

이 단락에 테두리를 설정한다. - 셀 테두리와 같은 Border 형식을 사용한다.

setParagraphBorder(border: Border): Promise<void>;

매개변수

이름	타입	설명
`border`	`Border`	테두리 값

반환값

Promise<void>

`setParagraphFormat(options)`

이 단락에 지정한 단락 서식을 적용한다. - 지정한 필드만 변경한다. 글자 서식은 setTextFormat()으로 설정한다.

setParagraphFormat(options: ParagraphFormat): Promise<void>;

매개변수

이름	타입	설명
`options`	`ParagraphFormat`	적용할 단락 서식

반환값

Promise<void>

`setStyle(style)`

이 단락에 스타일을 적용한다.
스타일을 적용하면 기존 직접 서식을 초기화한다.
단락 스타일은 단락에, 글자 스타일은 단락 전체 텍스트에 적용한다.

setStyle(style: Style | string | null): Promise<void>;

매개변수

이름	타입	설명
`style`	`Style \| string \| null`	내장 스타일은 Style enum(값=키), 커스텀 문서 스타일은 getStyles() 의 style 값. null 이면 스타일 제거(기본으로 복귀)

반환값

Promise<void>

`setTabs(tabs)`

이 단락의 탭 정지 위치를 설정한다. - 지정한 배열로 기존 설정을 교체하며, 빈 배열은 모든 탭 정지 위치를 제거한다.

setTabs(tabs: TabStop[]): Promise<void>;

매개변수

이름	타입	설명
`tabs`	`TabStop[]`	탭 스톱 배열

반환값

Promise<void>

`setTextFormat(options)`

단락 전체 텍스트에 글자 서식을 적용한다.

setTextFormat(options: TextFormat): Promise<void>;

매개변수

이름	타입	설명
`options`	`TextFormat`	적용할 글자 서식

반환값

Promise<void>

비고
메서드
메서드 상세

비고​

메서드​

메서드 상세​

acceptChangeTrackings()​

clearFormat()​

clearList()​

delete()​

getChangeTrackings()​

getComments()​

getContentHtml()​

getEndnotes()​

getFootnotes()​

getId()​

getList()​

getNextSibling()​

getNotes()​

getParentBody()​

getParentTable()​

getParentTableCell()​

getPreviousSibling()​

getRange(startOffset, endOffset)​

getStructure()​

getText()​

insertColumnBreak(options)​

insertEndnote(text, options)​

insertFootnote(text, options)​

insertImage(options)​

insertLineBreak(options)​

insertPageBreak(options)​

insertParagraph(text, options)​

insertSectionBreak(type, options)​

insertShape(preset, options)​

insertSymbol(charCode, options)​

insertTab(options)​

insertTable(rows, columns, options)​

insertText(text, options)​

insertTextbox(options)​

insertWebVideo(url, options)​

rejectChangeTrackings()​

select(mode)​

setIndent(type)​

setList(listType)​

setParagraphBorder(border)​

setParagraphFormat(options)​

setStyle(style)​

setTabs(tabs)​

setTextFormat(options)​

비고

메서드

메서드 상세

`acceptChangeTrackings()`

`clearFormat()`

`clearList()`

`delete()`

`getChangeTrackings()`

`getComments()`

`getContentHtml()`

`getEndnotes()`

`getFootnotes()`

`getId()`

`getList()`

`getNextSibling()`

`getNotes()`

`getParentBody()`

`getParentTable()`

`getParentTableCell()`

`getPreviousSibling()`

`getRange(startOffset, endOffset)`

`getStructure()`

`getText()`

`insertColumnBreak(options)`

`insertEndnote(text, options)`

`insertFootnote(text, options)`

`insertImage(options)`

`insertLineBreak(options)`

`insertPageBreak(options)`

`insertParagraph(text, options)`

`insertSectionBreak(type, options)`

`insertShape(preset, options)`

`insertSymbol(charCode, options)`

`insertTab(options)`

`insertTable(rows, columns, options)`

`insertText(text, options)`

`insertTextbox(options)`

`insertWebVideo(url, options)`

`rejectChangeTrackings()`

`select(mode)`

`setIndent(type)`

`setList(listType)`

`setParagraphBorder(border)`

`setParagraphFormat(options)`

`setStyle(style)`

`setTabs(tabs)`

`setTextFormat(options)`