본문으로 건너뛰기

Cell.Table

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

비고​

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

메서드​

메서드설명
delete()표를 삭제한다.
getFilter()이 표의 자동 필터를 다루는 Filter 를 반환한다.
getInfo()표의 이름·위치·영역과 표시 옵션을 한 번에 반환한다.
getName()표 이름을 반환한다.
getOptions()표의 표시 옵션을 한 번에 반환한다.
getRange()머리글 행과 요약 행을 포함한 표 전체 영역의 Range 를 반환한다.
resize(range)표 영역을 새 범위로 변경한다.
setBandedColumns(isOn)열을 한 줄씩 번갈아 다른 색으로 칠할지를 변경한다.
setBandedRows(isOn)행을 한 줄씩 번갈아 다른 색으로 칠할지를 변경한다.
setFirstColumn(isOn)첫 열에 강조 서식을 줄지를 변경한다.
setHeaderRow(isOn)머리글 행 표시 여부를 변경한다.
setLastColumn(isOn)끝 열에 강조 서식을 줄지를 변경한다.
setName(name)표 이름을 변경한다.
setOptions(options)표의 표시 옵션을 변경한다.
setTotalsRow(isOn)요약 행 표시 여부를 변경한다.

메서드 상세​

delete()​

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

delete(): Promise<void>;

반환값

none

getFilter()​

이 표의 자동 필터를 다루는 Filter 를 반환한다. 표의 필터링은 표 구조에 내재하므로 아직 필터가 만들어지지 않았어도 Filter 를 반환하며, 필터가 있는지는 Filter 의 getInfo() 로 확인한다. 표 이름을 바꾸면 그 전에 받은 Filter 는 쓸 수 없다.

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")

반환값

none

setBandedColumns(isOn)​

열을 한 줄씩 번갈아 다른 색으로 칠할지를 변경한다.

setBandedColumns(isOn: boolean): Promise<void>;

매개변수

이름타입설명
isOnbooleantrue 면 켜고 false 면 끈다

반환값

none

setBandedRows(isOn)​

행을 한 줄씩 번갈아 다른 색으로 칠할지를 변경한다.

setBandedRows(isOn: boolean): Promise<void>;

매개변수

이름타입설명
isOnbooleantrue 면 켜고 false 면 끈다

반환값

none

setFirstColumn(isOn)​

첫 열에 강조 서식을 줄지를 변경한다.

setFirstColumn(isOn: boolean): Promise<void>;

매개변수

이름타입설명
isOnbooleantrue 면 켜고 false 면 끈다

반환값

none

setHeaderRow(isOn)​

머리글 행 표시 여부를 변경한다. 켤 때 표 바로 바깥의 인접한 행이 비어 있지 않으면 시트에 행을 새로 삽입해 아래 내용을 밀어내고, 끌 때는 그 행의 셀 값을 지운다. 머리글 행을 켜면 표의 자동 필터가 함께 만들어지고, 끄면 제거된다.

setHeaderRow(isOn: boolean): Promise<void>;

매개변수

이름타입설명
isOnbooleantrue 면 켜고 false 면 끈다

반환값

none

setLastColumn(isOn)​

끝 열에 강조 서식을 줄지를 변경한다.

setLastColumn(isOn: boolean): Promise<void>;

매개변수

이름타입설명
isOnbooleantrue 면 켜고 false 면 끈다

반환값

none

setName(name)​

표 이름을 변경한다. 이 Table 은 새 이름을 가리키므로 계속 쓸 수 있지만, 같은 표를 가리키던 다른 Table 과 이 표에서 미리 받아 둔 Filter 는 더 이상 쓸 수 없다. 같은 이름의 표나 정의된 이름이 이미 있으면 변경할 수 없으며, 이때 대소문자는 구분하지 않는다.

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

매개변수

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

반환값

none

setOptions(options)​

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

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

매개변수

이름타입설명
optionsTableOptionUpdate바꿀 옵션

반환값

none

setTotalsRow(isOn)​

요약 행 표시 여부를 변경한다. 켤 때 표 바로 바깥의 인접한 행이 비어 있지 않으면 시트에 행을 새로 삽입해 아래 내용을 밀어내고, 끌 때는 그 행의 셀 값을 지운다.

setTotalsRow(isOn: boolean): Promise<void>;

매개변수

이름타입설명
isOnbooleantrue 면 켜고 false 면 끈다

반환값

none