본문으로 건너뛰기

Cell.Table

Cell.Table은 Spreadsheet 모듈(Office.cell(iframe))의 객체 타입입니다. 메서드 9개.

Generated from the SDK type definitions

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

비고​

  • 모듈: Spreadsheet · Office.cell(iframe) · 네임스페이스 Cell
  • 얻는 방법: Workbook.getTable(name), Worksheet.addTable(dataRange, hasHeaders)
  • 네비게이션 메서드(getFilter(), getRange())는 왕복 없이 하위 핸들을 동기 반환하고, 요청은 다음 터미널 호출에서 보냅니다. 그 외 모든 메서드는 Promise를 반환합니다.

메서드​

메서드설명
delete()표를 삭제한다.
getFilter()이 표의 자동 필터 핸들을 반환한다.
getInfo()표의 이름·위치·영역과 표시 옵션을 한 번에 반환한다.
getName()지정된 표 이름을 반환한다.
getOptions()표의 표시 옵션을 한 번에 반환한다.
getRange()머리글 행과 요약 행을 포함한 표 전체 영역의 Range 핸들을 반환한다.
resize(range)표 영역을 새 범위로 변경한다.
setName(name)표 이름을 변경한다.
setOptions(options)표의 표시 옵션을 변경한다.

메서드 상세​

delete()​

표를 삭제한다. 표 정의와 표에 딸린 자동 필터를 없애고 표 영역의 셀 내용까지 지운다.

delete(): Promise<void>;

반환값

Promise<void>

getFilter()​

이 표의 자동 필터 핸들을 반환한다. 표의 필터링은 표 구조에 내재하므로 아직 필터가 만들어지지 않았어도 핸들을 반환하며, 필터가 있는지는 Filter 의 getInfo() 로 확인한다.

getFilter(): Filter;

반환값

Filter

getInfo()​

표의 이름·위치·영역과 표시 옵션을 한 번에 반환한다.

getInfo(): Promise<TableInfo>;

반환값

Promise<TableInfo>

getName()​

지정된 표 이름을 반환한다.

getName(): Promise<string>;

반환값

Promise<string>

getOptions()​

표의 표시 옵션을 한 번에 반환한다.

getOptions(): Promise<TableOptions>;

반환값

Promise<TableOptions>

getRange()​

머리글 행과 요약 행을 포함한 표 전체 영역의 Range 핸들을 반환한다. 반환한 Range 는 호출 시점의 좌표를 담고 있어, 이후 표 영역이 바뀌어도 따라가지 않는다.

getRange(): Range;

반환값

Range

resize(range)​

표 영역을 새 범위로 변경한다. 새 영역은 머리글 행 위치를 그대로 두면서 현재 표 영역과 겹쳐야 하고 두 셀 이상이어야 하며, 전체 행이나 전체 열은 지정할 수 없다. 현재 영역과 같은 영역을 넘기면 아무것도 바꾸지 않는다.

resize(range: string | RangeCoords): Promise<void>;

매개변수

이름타입설명
rangestring | RangeCoords새 표 영역. A1 표기 문자열로도 지정할 수 있다("A1:B2", 단일 셀은 "E10")

반환값

Promise<void>

setName(name)​

표 이름을 변경한다. 표 이름을 참조하는 수식은 새 이름으로 함께 갱신된다. 이 핸들은 새 이름을 가리키므로 계속 쓸 수 있지만, 같은 표를 가리키던 다른 핸들과 이 표에서 미리 받아 둔 Filter 핸들은 더 이상 쓸 수 없다. 다른 표가 같은 이름을 쓰고 있으면 변경할 수 없으며, 이때 대소문자는 구분하지 않는다.

setName(name: string): Promise<void>;

매개변수

이름타입설명
namestring새 표 이름. 공백이나 허용되지 않는 문자를 쓸 수 없고, 셀 참조로 읽히는 이름이나 최대 길이를 넘는 이름도 받지 않는다

반환값

Promise<void>

setOptions(options)​

표의 표시 옵션을 변경한다. 지정한 옵션만 적용하고 나머지는 현재 값을 그대로 둔다. 머리글 행이나 요약 행을 켤 때 표 바로 바깥의 인접한 행이 비어 있지 않으면 시트에 행을 새로 삽입해 아래 내용을 밀어내고, 끌 때는 그 행의 셀 값을 지운다. 머리글 행을 켜면 표의 자동 필터가 함께 만들어지고, 끄면 제거된다. 표 스타일은 이 메서드로 바꿀 수 없다.

setOptions(options: TableOptionUpdate): Promise<void>;

매개변수

이름타입설명
optionsTableOptionUpdate바꿀 옵션

반환값

Promise<void>