Show.TableCell

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

Generated from the SDK type definitions

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

비고

모듈: Presentation · Office.show(iframe) · 네임스페이스 Show
얻는 방법: Table.findCells(filter), Table.getCell(row, col), Table.getCells(), Table.getColumn(colIndex), Table.getRow(rowIndex)
모든 메서드는 Promise를 반환하며, 시그니처는 TypeScript 표기입니다.

메서드

메서드	설명
`deleteText()`	셀 안의 모든 텍스트를 제거한다.
`getAlignH(range)`	대표 단락의 가로 정렬을 반환한다.
`getAlignV()`	텍스트 세로 정렬을 반환한다.
`getBold(range)`	대표 run 의 굵게 여부를 반환한다.
`getBorderStyle(position)`	지정 위치의 셀 테두리 스타일을 반환한다.
`getBulletStyle(range)`	대표 단락의 글머리 기호 스타일을 반환한다.
`getColIndex()`	셀의 열 인덱스를 반환한다.
`getColSpan()`	셀이 가로로 차지하는 열 수를 반환한다.
`getFill()`	셀에 명시적으로 설정된 배경 채우기를 반환한다.
`getFirstLineIndent(range)`	대표 단락의 첫 줄 들여쓰기(UI "첫 줄")를 반환한다.
`getFontFamily(range)`	대표 run 의 글꼴 이름을 반환한다.
`getFontSize(range)`	대표 run 의 글자 크기(pt)를 반환한다.
`getFontStyle(range)`	대표 run(range 가 걸친 첫 run)의 글꼴 스타일을 반환한다.
`getItalic(range)`	대표 run 의 기울임 여부를 반환한다.
`getLevel(range)`	대표 단락의 목록 수준을 반환한다.
`getLineSpacing(range)`	대표 단락의 줄 간격 값을 반환한다.
`getLineSpacingType(range)`	대표 단락의 줄 간격 유형을 반환한다.
`getMarginLeft(range)`	대표 단락의 왼쪽 여백(UI "텍스트 앞")을 반환한다.
`getParagraphStyle(range)`	대표 단락(range 가 걸친 첫 단락)의 단락 서식을 반환한다.
`getRowIndex()`	셀의 행 인덱스를 반환한다.
`getRowSpan()`	셀이 세로로 차지하는 행 수를 반환한다.
`getSpaceAfter(range)`	대표 단락의 단락 뒤 간격(UI "문단 아래")을 반환한다.
`getSpaceBefore(range)`	대표 단락의 단락 앞 간격(UI "문단 위")을 반환한다.
`getStrike(range)`	대표 run 의 취소선 유형을 반환한다.
`getText(range)`	텍스트를 plain text로 반환한다.
`getTextboxAutoFit()`	텍스트 상자 자동 맞춤 유형을 반환한다.
`getTextColor(range)`	대표 run 의 글자 색상을 반환한다.
`getTextHyperlink(range)`	텍스트 구간의 하이퍼링크를 반환한다.
`getUnderline(range)`	대표 run 의 밑줄 유형을 반환한다.
`insertSymbol(textOffset, symbol)`	지정한 offset 위치에 특수문자(symbol)를 삽입한다.
`insertText(text, textOffset)`	텍스트를 삽입한다.
`isShape()`	이 핸들이 Shape 인지 판별한다 (union 좁히기용 type guard).
`removeTextHyperlink(range)`	텍스트의 하이퍼링크를 제거한다.
`setAlignH(align, range)`	텍스트 가로 정렬을 설정한다.
`setAlignV(align)`	텍스트 세로 정렬을 설정한다.
`setBold(enabled, range)`	글자를 굵게 설정한다.
`setBorderStyle(position, color, width, lineDash)`	셀 테두리 스타일을 설정한다.
`setBulletStyle(bulletType, subType, startAt, range)`	글머리 기호 스타일을 설정한다.
`setFill(fill)`	getFill() 이 반환한 채우기 객체를 그대로 적용한다.
`setFirstLineIndent(firstLineIndent, range)`	단락 첫 줄의 들여쓰기(UI "첫 줄")를 설정한다.
`setFontFamily(fontFamily, range)`	글꼴을 설정한다.
`setFontSize(fontSize, range)`	글자 크기를 설정한다.
`setFontStyle(style, range)`	글꼴 스타일을 설정한다.
`setItalic(enabled, range)`	글자 기울임을 설정한다.
`setLevel(level, range)`	목록 수준(개요 계층 깊이)을 설정한다.
`setLineSpacing(lineSpacing, type, range)`	줄 간격을 설정한다.
`setMarginLeft(marginLeft, range)`	단락 전체의 왼쪽 여백(UI "텍스트 앞")을 설정한다.
`setParagraphStyle(style, range)`	단락 서식을 한 번에 설정한다.
`setSolidFill(color, alpha)`	셀 배경을 단색으로 채운다.
`setSpaceAfter(spaceAfter, range)`	단락 뒤 간격(UI "문단 아래")을 설정한다.
`setSpaceBefore(spaceBefore, range)`	단락 앞 간격(UI "문단 위")을 설정한다.
`setStrike(strike, range)`	글자 취소선을 설정한다.
`setText(text, range)`	텍스트를 설정한다.
`setTextboxAutoFit(autoAlignType)`	텍스트 상자 자동 맞춤 유형을 설정한다.
`setTextColor(color, range)`	글자 색상을 설정한다.
`setTextHyperlink(hyperlink, range)`	텍스트에 하이퍼링크를 설정한다.
`setUnderline(underline, range)`	글자 밑줄을 설정한다.

메서드 상세

`deleteText()`

셀 안의 모든 텍스트를 제거한다.

deleteText(): Promise<void>;

반환값

Promise<void>

`getAlignH(range)`

대표 단락의 가로 정렬을 반환한다. (setAlignH 대칭)

getAlignH(range?: TextRange): Promise<TextAlignH | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<TextAlignH | null> - 가로 정렬. 텍스트/단락 없으면 null

`getAlignV()`

텍스트 세로 정렬을 반환한다. (setAlignV 대칭) TextAlignV 는 TOP 이 0 인 숫자 enum 이라, 값이 있는지는 truthy 검사가 아니라 null 비교로 본다.

getAlignV(): Promise<TextAlignV | null>;

반환값

Promise<TextAlignV | null> - 세로 정렬. 대상 텍스트가 없으면 null

`getBold(range)`

대표 run 의 굵게 여부를 반환한다. (setBold 대칭 - 상속까지 반영된 실제 적용값)

getBold(range?: TextRange): Promise<boolean | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<boolean | null> - 굵게 여부. 대상 텍스트가 없거나 유효하지 않은 구간이면 null

`getBorderStyle(position)`

지정 위치의 셀 테두리 스타일을 반환한다. (setBorderStyle 대칭) ALL 일괄 조회는 지원하지 않는다 - 한 변씩 조회한다.

getBorderStyle(position: Exclude<BorderPosition, "all">): Promise<BorderStyle | null>;

매개변수

이름	타입	설명
`position`	`Exclude<BorderPosition, "all">`	테두리 위치

반환값

Promise<BorderStyle | null> - 테두리 스타일. 해당 위치에 명시적 테두리가 없으면 null

`getBulletStyle(range)`

대표 단락의 글머리 기호 스타일을 반환한다. 반환 필드를 풀어서 setBulletStyle(type, subType, startAt) 에 넘길 수 있다. 값은 레이아웃/마스터 상속까지 반영해 실제 적용된 값이고, 없는 값(시작 번호)과 되넘길 수 없는 값(프리셋 밖 번호 유형)은 키를 담지 않는다. 그림 글머리·프리셋 밖 문자는 조회 전용이라 그대로는 적용되지 않는다. (제약은 setBulletStyle 참조)

getBulletStyle(range?: TextRange): Promise<BulletStyle | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<BulletStyle | null> - 글머리 기호 스타일. 텍스트/단락 없으면 null

`getColIndex()`

셀의 열 인덱스를 반환한다.

getColIndex(): Promise<number>;

반환값

Promise<number> - 열 인덱스 (0-based)

`getColSpan()`

셀이 가로로 차지하는 열 수를 반환한다. 병합되지 않았으면 1 이다.

getColSpan(): Promise<number | null>;

반환값

Promise<number | null> - 열 병합 수. 표가 없거나 해당 위치에 셀이 없으면 null

`getFill()`

셀에 명시적으로 설정된 배경 채우기를 반환한다. (setSolidFill 대칭) 스타일 상속분은 포함하지 않으며(셀에 직접 지정한 채우기만), alpha 는 setSolidFill 과 같은 투명도(0~100, 0=불투명)로 반환한다.

getFill(): Promise<Fill | null>;

반환값

Promise<Fill | null> - 채우기 정보. 명시적 fill 없으면 \{ type: FillType.NONE \}, 표가 없으면 null

`getFirstLineIndent(range)`

대표 단락의 첫 줄 들여쓰기(UI "첫 줄")를 반환한다. (setFirstLineIndent 대칭)

getFirstLineIndent(range?: TextRange): Promise<number | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<number | null> - 첫 줄 들여쓰기 (pt, 음수는 내어쓰기). 텍스트/단락 없으면 null

`getFontFamily(range)`

대표 run 의 글꼴 이름을 반환한다. (setFontFamily 대칭 - 상속까지 반영된 실제 적용값)

getFontFamily(range?: TextRange): Promise<string | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<string | null> - 글꼴 이름. 대상 텍스트가 없거나 유효하지 않은 구간이면 null

`getFontSize(range)`

대표 run 의 글자 크기(pt)를 반환한다. (setFontSize 대칭 - 상속까지 반영된 실제 적용값)

getFontSize(range?: TextRange): Promise<number | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<number | null> - 글자 크기 (pt). 대상 텍스트가 없거나 유효하지 않은 구간이면 null

`getFontStyle(range)`

대표 run(range 가 걸친 첫 run)의 글꼴 스타일을 반환한다. (setFontStyle 대칭) 반환 객체를 그대로 다른 개체의 setFontStyle 에 넘길 수 있다. 값이 없는 속성은 키를 담지 않는다. 값은 레이아웃/마스터/표 스타일 상속까지 반영해 실제 적용된 값이라 run 이 직접 지정한 값만 골라낼 수는 없다.

getFontStyle(range?: TextRange): Promise<FontStyle | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<FontStyle | null> - 글꼴 스타일. run/스타일 없으면 빈 객체 \{\}, 대상 텍스트가 없거나(협업 중 삭제 등) 유효하지 않은 구간이면 null

`getItalic(range)`

대표 run 의 기울임 여부를 반환한다. (setItalic 대칭 - 상속까지 반영된 실제 적용값)

getItalic(range?: TextRange): Promise<boolean | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<boolean | null> - 기울임 여부. 대상 텍스트가 없거나 유효하지 않은 구간이면 null

`getLevel(range)`

대표 단락의 목록 수준을 반환한다. (setLevel 대칭)

getLevel(range?: TextRange): Promise<number | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<number | null> - 목록 수준 (1~9). 텍스트/단락 없으면 null

`getLineSpacing(range)`

대표 단락의 줄 간격 값을 반환한다. (setLineSpacing 대칭)

getLineSpacing(range?: TextRange): Promise<number | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<number | null> - 줄 간격 값 (MULTIPLE: 배수%, EXACT: pt). 텍스트/단락 없으면 null

`getLineSpacingType(range)`

대표 단락의 줄 간격 유형을 반환한다. (setLineSpacing 의 type 대칭)

getLineSpacingType(range?: TextRange): Promise<LineSpacingType | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<LineSpacingType | null> - 줄 간격 유형. 텍스트/단락 없으면 null

`getMarginLeft(range)`

대표 단락의 왼쪽 여백(UI "텍스트 앞")을 반환한다. (setMarginLeft 대칭)

getMarginLeft(range?: TextRange): Promise<number | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<number | null> - 왼쪽 여백 (pt). 텍스트/단락 없으면 null

`getParagraphStyle(range)`

대표 단락(range 가 걸친 첫 단락)의 단락 서식을 반환한다. (setParagraphStyle 대칭) 반환 객체를 그대로 다른 개체의 setParagraphStyle 에 넘길 수 있다. 값이 없는 속성은 키를 담지 않는다. 값은 레이아웃/마스터 상속까지 반영해 실제 적용된 값이라 단락이 직접 지정한 값만 골라낼 수는 없고, 같은 단락에 그대로 다시 넘기면 상속값과 같은 속성은 직접 지정으로 남지 않는다. 목록 수준은 서식 값이 아니라 상속 프리셋이라 담지 않는다. (getLevel 대칭)

getParagraphStyle(range?: TextRange): Promise<ParagraphStyle | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<ParagraphStyle | null> - 단락 서식. 텍스트/단락 없으면 null

`getRowIndex()`

셀의 행 인덱스를 반환한다.

getRowIndex(): Promise<number>;

반환값

Promise<number> - 행 인덱스 (0-based)

`getRowSpan()`

셀이 세로로 차지하는 행 수를 반환한다. 병합되지 않았으면 1 이다.

getRowSpan(): Promise<number | null>;

반환값

Promise<number | null> - 행 병합 수. 표가 없거나 해당 위치에 셀이 없으면 null

`getSpaceAfter(range)`

대표 단락의 단락 뒤 간격(UI "문단 아래")을 반환한다. (setSpaceAfter 대칭)

getSpaceAfter(range?: TextRange): Promise<number | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<number | null> - 단락 뒤 간격 (pt). 배수(%) 저장/텍스트 없음이면 null

`getSpaceBefore(range)`

대표 단락의 단락 앞 간격(UI "문단 위")을 반환한다. (setSpaceBefore 대칭)

getSpaceBefore(range?: TextRange): Promise<number | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<number | null> - 단락 앞 간격 (pt). 배수(%) 저장/텍스트 없음이면 null

`getStrike(range)`

대표 run 의 취소선 유형을 반환한다. (setStrike 대칭 - 상속까지 반영된 실제 적용값)

getStrike(range?: TextRange): Promise<Strike | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<Strike | null> - 취소선 유형. 대상 텍스트가 없거나 유효하지 않은 구간이면 null

`getText(range)`

텍스트를 plain text로 반환한다. 문단 사이의 개행은 그대로 들어가지만, 마지막 문단을 끝맺는 개행은 글자가 아니라 담지 않는다 (빈 텍스트는 "").

getText(range?: TextRange): Promise<string>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (UTF-16 코드 단위 offset) (기본값: 전체 텍스트)

반환값

Promise<string> - 해당 구간의 텍스트 (plain text). 텍스트 모델이 없거나 빈 구간이면 ""

`getTextboxAutoFit()`

텍스트 상자 자동 맞춤 유형을 반환한다. (setTextboxAutoFit 대칭)

getTextboxAutoFit(): Promise<AutoFitType | null>;

반환값

Promise<AutoFitType | null> - 자동 맞춤 유형. 대상 텍스트가 없으면 null

`getTextColor(range)`

대표 run 의 글자 색상을 반환한다. (setTextColor 대칭 - 상속까지 반영된 실제 적용값)

getTextColor(range?: TextRange): Promise<string | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<string | null> - 글자 색상 (hex "#RRGGBB" - scheme color 도 hex 로 풀려서 나온다). solid 채우기가 아니거나 대상 텍스트가 없거나 유효하지 않은 구간이면 null

`getTextHyperlink(range)`

텍스트 구간의 하이퍼링크를 반환한다. (setTextHyperlink 대칭 - 반환 객체를 그대로 넘겨 복사할 수 있다) range 를 주면 그 구간의 첫 글자, range 가 없으면 텍스트의 첫 글자가 속한 run 을 기준으로 한다. 도형 자체에 걸린 하이퍼링크는 getHyperlink 로 읽는다.

getTextHyperlink(range?: TextRange): Promise<Hyperlink | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	조회할 텍스트 구간 (기본값: 텍스트 첫 글자)

반환값

Promise<Hyperlink | null> - 하이퍼링크 정보 (getHyperlink 와 같은 Hyperlink 객체). 링크 없음/텍스트 없음/미노출 action 이면 null

`getUnderline(range)`

대표 run 의 밑줄 유형을 반환한다. (setUnderline 대칭 - 상속까지 반영된 실제 적용값)

getUnderline(range?: TextRange): Promise<Underline | null>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	읽을 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<Underline | null> - 밑줄 유형. 대상 텍스트가 없거나 유효하지 않은 구간이면 null

`insertSymbol(textOffset, symbol)`

지정한 offset 위치에 특수문자(symbol)를 삽입한다.

insertSymbol(textOffset: number, symbol: string): Promise<void>;

매개변수

이름	타입	설명
`textOffset`	`number`	삽입 위치 offset
`symbol`	`string`	삽입할 특수문자 (개행 불가 - 문단을 나누려면 insertText)

반환값

Promise<void>

`insertText(text, textOffset)`

텍스트를 삽입한다. 삽입한 글자의 서식은 삽입 지점 바로 앞 글자의 런 서식을 따른다.

insertText(text: string, textOffset?: number): Promise<void>;

매개변수

이름	타입	설명
`text`	`string`	삽입할 텍스트
`textOffset` (선택)	`number`	삽입 위치 offset (기본값: 텍스트 끝)

반환값

Promise<void>

`isShape()`

이 핸들이 Shape 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 - postMessage 왕복 없음, await 불필요.

isShape(): Promise<this is Shape>;

반환값

Promise<this is Shape>

`removeTextHyperlink(range)`

텍스트의 하이퍼링크를 제거한다. (도형 자체에 걸린 하이퍼링크는 removeHyperlink)

removeTextHyperlink(range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`range` (선택)	`TextRange`	제거할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setAlignH(align, range)`

텍스트 가로 정렬을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다.

setAlignH(align: TextAlignH, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`align`	`TextAlignH`	가로 정렬
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setAlignV(align)`

텍스트 세로 정렬을 설정한다. (getAlignV 대칭)

setAlignV(align: TextAlignV): Promise<void>;

매개변수

이름	타입	설명
`align`	`TextAlignV`	세로 정렬

반환값

Promise<void>

`setBold(enabled, range)`

글자를 굵게 설정한다.

setBold(enabled: boolean, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`enabled`	`boolean`	true: 굵게, false: 해제
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setBorderStyle(position, color, width, lineDash)`

셀 테두리 스타일을 설정한다. 생략한 속성은 유지되지 않고 기본값이 되므로, 일부만 바꾸려면 getBorderStyle() 반환값에 바꿀 속성을 덮어 함께 넘긴다. 셋을 모두 생략하면 아무것도 바꾸지 않는다. ALL 은 위/아래/왼쪽/오른쪽 4변만 설정한다 - 대각선은 포함하지 않는다. 색상은 hex / scheme color 모두 자동 판정.

setBorderStyle(
  position: BorderPosition,
  color?: string,
  width?: number,
  lineDash?: LineDash
): Promise<void>;

매개변수

이름	타입	설명
`position`	`BorderPosition`	테두리 위치
`color` (선택)	`string`	hex (#RRGGBB) 또는 scheme color name
`width` (선택)	`number`	선 두께 (pt 단위)
`lineDash` (선택)	`LineDash`	선 대시 유형

반환값

Promise<void>

`setBulletStyle(bulletType, subType, startAt, range)`

글머리 기호 스타일을 설정한다. (getBulletStyle 대칭) 그림 글머리(BulletType.BLIP)는 적용을 지원하지 않는 조회 전용 유형이라 거부한다. CharType 프리셋 밖의 문자도 적용할 수 없다 (조회 전용이라 받을 인자가 없다).

setBulletStyle(
  bulletType: Exclude<BulletType, "buBlip">,
  subType?: NumberedType | CharType,
  startAt?: number,
  range?: TextRange
): Promise<void>;

매개변수

이름	타입	설명
`bulletType`	`Exclude<BulletType, "buBlip">`	글머리 기호 유형
`subType` (선택)	`NumberedType \| CharType`	BulletType.AUTO_NUM: 번호 매기기 유형 (기본값 NumberedType.NUMBER_WITH_DOT), BulletType.CHAR: 글머리 문자 유형 (기본값 CharType.DOT)
`startAt` (선택)	`number`	시작 번호 (BulletType.AUTO_NUM 일 때만 사용) (기본값: 1)
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setFill(fill)`

getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 - 셀 채우기 복사) 셀 채우기 설정은 단색만 지원한다 - getFill() 이 다른 타입(none/gradient 등)을 돌려준 셀의 값은 되넘길 수 없다.

setFill(fill: Fill & { type: "solidFill" }): Promise<void>;

매개변수

이름	타입	설명
`fill`	`Fill & { type: "solidFill" }`	적용할 단색 채우기

반환값

Promise<void>

`setFirstLineIndent(firstLineIndent, range)`

단락 첫 줄의 들여쓰기(UI "첫 줄")를 설정한다. 둘째 줄부터는 marginLeft 를 따른다. 양수는 들여쓰기, 음수는 내어쓰기, 0 은 들여쓰기 없음이다. 글머리 기호 목록의 계층 깊이를 바꾸려면 setLevel 을 사용한다.

setFirstLineIndent(firstLineIndent: number, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`firstLineIndent`	`number`	첫 줄 들여쓰기 (pt)
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setFontFamily(fontFamily, range)`

글꼴을 설정한다.

setFontFamily(fontFamily: string, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`fontFamily`	`string`	글꼴 이름
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setFontSize(fontSize, range)`

글자 크기를 설정한다.

setFontSize(fontSize: number, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`fontSize`	`number`	pt 단위
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setFontStyle(style, range)`

글꼴 스타일을 설정한다. 단일 속성은 setBold/setItalic/setFontSize/setFontFamily/setTextColor 사용 권장.

setFontStyle(style: FontStyle, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`style`	`FontStyle`	글꼴 스타일 설정
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setItalic(enabled, range)`

글자 기울임을 설정한다.

setItalic(enabled: boolean, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`enabled`	`boolean`	true: 기울임, false: 해제
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setLevel(level, range)`

목록 수준(개요 계층 깊이)을 설정한다. range 가 걸친 단락을 모두 같은 수준으로 맞춘다. pt 단위 들여쓰기(setFirstLineIndent/setMarginLeft)와 달리 수준은 상속 프리셋 선택이라, 바꾸면 그 수준의 글머리 기호·글자 크기가 따라오고 marginLeft 는 새 수준의 값으로 덮인다. setMarginLeft 로 지정한 값도 버려지므로 둘을 함께 쓸 때는 setLevel 을 먼저 호출한다. (firstLineIndent 는 유지) 대상 텍스트가 허용하는 범위(제목 개체는 1 수준뿐)로 제한한다.

setLevel(level: number, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`level`	`number`	목록 수준 (1=최상위 ~ 9)
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setLineSpacing(lineSpacing, type, range)`

줄 간격을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. lineSpacing 의 단위는 유형에 따라 다르다 - MULTIPLE 이면 배수 백분율(150=1.5배), EXACT 이면 pt 다.

setLineSpacing(lineSpacing: number, type?: LineSpacingType, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`lineSpacing`	`number`	줄 간격 값 (MULTIPLE: 배수%, EXACT: pt)
`type` (선택)	`LineSpacingType`	줄 간격 유형 (기본값: LineSpacingType.MULTIPLE)
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setMarginLeft(marginLeft, range)`

단락 전체의 왼쪽 여백(UI "텍스트 앞")을 설정한다. 첫 줄만 들여쓰려면 setFirstLineIndent 를 사용한다.

setMarginLeft(marginLeft: number, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`marginLeft`	`number`	왼쪽 여백 (pt)
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setParagraphStyle(style, range)`

단락 서식을 한 번에 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. 값을 준 속성만 바뀐다. null/undefined 는 "변경 없음"으로 무시하며, 지정한 값을 상속 상태로 되돌리는 방법은 아직 없다. 단일 속성은 setLineSpacing/setMarginLeft/setFirstLineIndent/setSpaceBefore/setSpaceAfter 사용 권장. 목록 수준은 바꿀 때 딸려오는 부수 효과(글머리 기호·글자 크기)가 있어 여기 담지 않는다. (setLevel 참고)

setParagraphStyle(style: ParagraphStyle, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`style`	`ParagraphStyle`	단락 서식 설정
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setSolidFill(color, alpha)`

셀 배경을 단색으로 채운다.

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

매개변수

이름	타입	설명
`color`	`string`	hex (#RRGGBB) 또는 scheme color
`alpha` (선택)	`number`	투명도 (0~100, 0=불투명, 100=완전 투명). 생략하면 기존 투명도 유지

반환값

Promise<void>

`setSpaceAfter(spaceAfter, range)`

단락 뒤 간격(UI "문단 아래")을 설정한다.

setSpaceAfter(spaceAfter: number, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`spaceAfter`	`number`	단락 뒤 간격 (pt)
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setSpaceBefore(spaceBefore, range)`

단락 앞 간격(UI "문단 위")을 설정한다.

setSpaceBefore(spaceBefore: number, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`spaceBefore`	`number`	단락 앞 간격 (pt)
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setStrike(strike, range)`

글자 취소선을 설정한다.

setStrike(strike: Strike, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`strike`	`Strike`	취소선 유형
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setText(text, range)`

텍스트를 설정한다. 인자 조합에 따라 다음과 같이 동작한다.
range 없음: 전체 텍스트를 text 로 교체
range 있음: 지정한 구간만 text 로 교체
text 가 빈 문자열("")이면 교체 대신 해당 범위를 삭제

setText(text: string, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`text`	`string`	설정할 텍스트. 빈 문자열("")이면 삭제로 동작
`range` (선택)	`TextRange`	교체할 텍스트 구간 to = from + 글자수 - 1 (0-based) 예: "가나다" 전체 = {from: 0, to: 2}, "가나다" 중 "가" = {from: 0, to: 0} offset 은 UTF-16 코드 단위라 서로게이트 페어를 가르는 range 는 반쪽이 아니라 그 글자 전체가 대상이 된다 (range 를 받는 서식 setter 도 같다) (기본값: 전체 텍스트)

반환값

Promise<void>

`setTextboxAutoFit(autoAlignType)`

텍스트 상자 자동 맞춤 유형을 설정한다. 이미 같은 유형이면 아무것도 하지 않는다.

setTextboxAutoFit(autoAlignType: AutoFitType): Promise<void>;

매개변수

이름	타입	설명
`autoAlignType`	`AutoFitType`	자동 맞춤 유형

반환값

Promise<void>

`setTextColor(color, range)`

글자 색상을 설정한다.

setTextColor(color: string, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`color`	`string`	hex (#RRGGBB) 또는 scheme color
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setTextHyperlink(hyperlink, range)`

텍스트에 하이퍼링크를 설정한다. (getTextHyperlink 대칭 - 반환 객체를 그대로 넘겨 링크를 복사할 수 있다) 도형 전체에 링크를 거는 setHyperlink 와 달리 링크가 글자(run) 단위로 걸리며 하이퍼링크 서식으로 표시된다. 지원하지 않는 종류나 유효하지 않은 대상(삭제된 슬라이드 등)은 무시한다.

setTextHyperlink(hyperlink: Hyperlink, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`hyperlink`	`Hyperlink`	getTextHyperlink() 반환값과 같은 Hyperlink 객체. type 이 없으면 무시한다
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

`setUnderline(underline, range)`

글자 밑줄을 설정한다.

setUnderline(underline: Underline, range?: TextRange): Promise<void>;

매개변수

이름	타입	설명
`underline`	`Underline`	밑줄 유형
`range` (선택)	`TextRange`	적용할 텍스트 구간 (기본값: 전체 텍스트)

반환값

Promise<void>

비고
메서드
메서드 상세

비고​

메서드​

메서드 상세​

deleteText()​

getAlignH(range)​

getAlignV()​

getBold(range)​

getBorderStyle(position)​

getBulletStyle(range)​

getColIndex()​

getColSpan()​

getFill()​

getFirstLineIndent(range)​

getFontFamily(range)​

getFontSize(range)​

getFontStyle(range)​

getItalic(range)​

getLevel(range)​

getLineSpacing(range)​

getLineSpacingType(range)​

getMarginLeft(range)​

getParagraphStyle(range)​

getRowIndex()​

getRowSpan()​

getSpaceAfter(range)​

getSpaceBefore(range)​

getStrike(range)​

getText(range)​

getTextboxAutoFit()​

getTextColor(range)​

getTextHyperlink(range)​

getUnderline(range)​

insertSymbol(textOffset, symbol)​

insertText(text, textOffset)​

isShape()​

removeTextHyperlink(range)​

setAlignH(align, range)​

setAlignV(align)​

setBold(enabled, range)​

setBorderStyle(position, color, width, lineDash)​

setBulletStyle(bulletType, subType, startAt, range)​

setFill(fill)​

setFirstLineIndent(firstLineIndent, range)​

setFontFamily(fontFamily, range)​

setFontSize(fontSize, range)​

setFontStyle(style, range)​

setItalic(enabled, range)​

setLevel(level, range)​

setLineSpacing(lineSpacing, type, range)​

setMarginLeft(marginLeft, range)​

setParagraphStyle(style, range)​

setSolidFill(color, alpha)​

setSpaceAfter(spaceAfter, range)​

setSpaceBefore(spaceBefore, range)​

setStrike(strike, range)​

setText(text, range)​

setTextboxAutoFit(autoAlignType)​

setTextColor(color, range)​

setTextHyperlink(hyperlink, range)​

setUnderline(underline, range)​

비고

메서드

메서드 상세

`deleteText()`

`getAlignH(range)`

`getAlignV()`

`getBold(range)`

`getBorderStyle(position)`

`getBulletStyle(range)`

`getColIndex()`

`getColSpan()`

`getFill()`

`getFirstLineIndent(range)`

`getFontFamily(range)`

`getFontSize(range)`

`getFontStyle(range)`

`getItalic(range)`

`getLevel(range)`

`getLineSpacing(range)`

`getLineSpacingType(range)`

`getMarginLeft(range)`

`getParagraphStyle(range)`

`getRowIndex()`

`getRowSpan()`

`getSpaceAfter(range)`

`getSpaceBefore(range)`

`getStrike(range)`

`getText(range)`

`getTextboxAutoFit()`

`getTextColor(range)`

`getTextHyperlink(range)`

`getUnderline(range)`

`insertSymbol(textOffset, symbol)`

`insertText(text, textOffset)`

`isShape()`

`removeTextHyperlink(range)`

`setAlignH(align, range)`

`setAlignV(align)`

`setBold(enabled, range)`

`setBorderStyle(position, color, width, lineDash)`

`setBulletStyle(bulletType, subType, startAt, range)`

`setFill(fill)`

`setFirstLineIndent(firstLineIndent, range)`

`setFontFamily(fontFamily, range)`

`setFontSize(fontSize, range)`

`setFontStyle(style, range)`

`setItalic(enabled, range)`

`setLevel(level, range)`

`setLineSpacing(lineSpacing, type, range)`

`setMarginLeft(marginLeft, range)`

`setParagraphStyle(style, range)`

`setSolidFill(color, alpha)`

`setSpaceAfter(spaceAfter, range)`

`setSpaceBefore(spaceBefore, range)`

`setStrike(strike, range)`

`setText(text, range)`

`setTextboxAutoFit(autoAlignType)`

`setTextColor(color, range)`

`setTextHyperlink(hyperlink, range)`

`setUnderline(underline, range)`