Show.Table
Show.Table은 Presentation 모듈(Office.show(iframe))의 객체 타입입니다. 메서드 56개.
Presentation · 객체 타입 10개 · 메서드 586개 · 네임스페이스 Show. 이 레퍼런스는 SDK 빌드와 함께 생성된 API 문서 아티팩트(sdk-api-doc.html)에서 생성됩니다. 설명은 게시된 편집기 API 주석 그대로입니다. SDK와 Office 버전을 함께 고정하고, 둘 중 하나가 바뀌면 다시 생성하십시오.
비고
- 모듈: Presentation ·
Office.show(iframe)· 네임스페이스Show - 얻는 방법:
Document.findTables(slides, filter),Slide.findTables(filter),Slide.insertTable(rowNum, colNum, styleName) - 모든 메서드는
Promise를 반환하며, 시그니처는 TypeScript 표기입니다.
메서드
| 메서드 | 설명 |
|---|---|
align(alignType) | 도형을 슬라이드 기준으로 정렬한다. |
deleteCol(startCol, endCol) | 지정 범위의 열을 삭제한다. |
deleteRow(startRow, endRow) | 지정 범위의 행을 삭제한다. |
findCells(filter) | 조건에 맞는 셀 배열을 반환한다. |
flip(direction) | 도형을 상하 또는 좌우로 반전한다. |
getCell(row, col) | 지정 좌표의 셀을 반환한다. |
getCells() | 모든 셀을 배열로 반환한다. |
getColCount() | 표의 열 개수를 반환한다. |
getColumn(colIndex) | 지정 열의 셀 배열을 반환한다. |
getColWidth(colIndex) | 지정 열의 너비를 반환한다. |
getHeight() | 도형의 높이를 반환한다. |
getHyperlink() | 도형에 설정된 하이퍼링크를 반환한다. |
getPlaceholderType() | 도형의 placeholder 종류를 반환한다. |
getPresetId() | 도형의 OOXML preset id (prst) 를 반환한다. |
getRotation() | 도형의 회전 각도를 반환한다. |
getRow(rowIndex) | 지정 행의 셀 배열을 반환한다. |
getRowCount() | 표의 행 개수를 반환한다. |
getRowHeight(rowIndex) | 지정 행의 높이를 반환한다. |
getStyleName() | 표에 적용된 스타일 이름을 반환한다. |
getStyleOption(option) | 표 스타일 옵션(머리글 행, 줄무늬 행 등)의 활성화 여부를 반환한다. |
getTransform() | 도형의 위치, 크기, 회전 정보를 반환한다. |
getWidth() | 도형의 너비를 반환한다. |
getX() | 도형의 X 좌표를 반환한다. |
getY() | 도형의 Y 좌표를 반환한다. |
getZOrderIndex() | 부모(슬라이드, 그룹 자식이면 그 그룹) 안에서 도형의 z-order 순번을 반환한다. |
hasText() | 도형이 텍스트를 담고 있는지 반환한다. |
insertCol(baseColIndex, position, insertNum) | 기준 열의 왼쪽 또는 오른쪽에 열을 삽입한다. |
insertRow(baseRowIndex, position, insertNum) | 기준 행의 위 또는 아래에 행을 삽입한다. |
isChart() | 이 핸들이 Chart 인지 판별한다 (union 좁히기용 type guard). |
isControl() | 이 핸들이 Control 인지 판별한다 (union 좁히기용 type guard). |
isDiagram() | 이 핸들이 Diagram 인지 판별한다 (union 좁히기용 type guard). |
isFlippedH() | 도형이 좌우로 반전된 상태인지 반환한다. |
isFlippedV() | 도형이 상하로 반전된 상태인지 반환한다. |
isGroup() | 이 핸들이 Group 인지 판별한다 (union 좁히기용 type guard). |
isImage() | 이 핸들이 Image 인지 판별한다 (union 좁히기용 type guard). |
isLine() | 이 핸들이 Line 인지 판별한다 (union 좁히기용 type guard). |
isOleObject() | 이 핸들이 OleObject 인지 판별한다 (union 좁히기용 type guard). |
isPlaceholder() | 도형이 placeholder(제목 · 본문 틀 등)인지 반환한다. |
isShape() | 이 핸들이 Shape 인지 판별한다 (union 좁히기용 type guard). |
isTable() | 이 핸들이 Table 인지 판별한다 (union 좁히기용 type guard). |
mergeCell(startRow, startCol, endRow, endCol) | 지정 범위의 셀을 병합한다. |
moveBy(distance) | 도형을 현재 위치 기준으로 x, y 만큼 상대 이동한다. |
removeHyperlink() | 도형의 하이퍼링크를 제거한다. |
reorder(order) | 도형의 정렬 순서(앞으로/뒤로)를 변경한다. |
setColWidth(colIndex, newWidth) | 지정 열의 너비를 변경한다. |
setHeight(height) | 도형의 높이를 설정한다. |
setHyperlink(hyperlink) | 도형에 하이퍼링크를 설정한다. |
setRotation(rotation) | 도형의 회전 각도를 절대값으로 설정한다. |
setRowHeight(rowIndex, newHeight) | 지정 행의 높이를 변경한다. |
setStyle(styleName) | 표 스타일을 변경한다. |
setStyleOption(option, enabled) | 표 스타일 옵션(머리글 행, 줄무늬 행 등)을 변경한다. |
setTransform(transform) | 도형의 위치·크기·회전을 한 번에 설정한다. |
setWidth(width) | 도형의 너비를 설정한다. |
setX(x) | 도형의 X 좌표를 절대값으로 설정한다. |
setY(y) | 도형의 Y 좌표를 절대값으로 설정한다. |
unmergeCell(startRow, startCol, endRow, endCol) | 지정 범위의 병합된 셀을 해제한다. |
메서드 상세
align(alignType)
도형을 슬라이드 기준으로 정렬한다. 이동이 불가능한 도형이면 무시된다. 그룹 자식도 그룹 안이 아니라 슬라이드를 기준으로 움직인다(에디터와 같다). 자식이 그룹 밖으로 나가면 그룹이 자식을 담도록 함께 넓어진다.
align(alignType: AlignType): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
alignType | AlignType | 정렬 타입 |
반환값
Promise<void>
deleteCol(startCol, endCol)
지정 범위의 열을 삭제한다. 모든 열을 지울 수는 없다 - 한 열짜리 표에서 그 열을 지우려 하면 오류가 난다. 표 자체를 없애려면 Slide.deleteShape 를 쓴다.
deleteCol(startCol: number, endCol: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
startCol | number | 삭제 시작 열 인덱스 (0-based) |
endCol | number | 삭제 끝 열 인덱스 (0-based, inclusive) |
반환값
Promise<void>
deleteRow(startRow, endRow)
지정 범위의 행을 삭제한다. 모든 행을 지울 수는 없다 - 한 행짜리 표에서 그 행을 지우려 하면 오류가 난다. 표 자체를 없애려면 Slide.deleteShape 를 쓴다.
deleteRow(startRow: number, endRow: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
startRow | number | 삭제 시작 행 인덱스 (0-based) |
endRow | number | 삭제 끝 행 인덱스 (0-based, inclusive) |
반환값
Promise<void>
findCells(filter)
조건에 맞는 셀 배열을 반환한다. 복수 조건은 AND 로 결합한다. range 는 셀 본체가 범위와 겹치면 매칭된다 (병합 대표 셀이 범위 밖에 있어도 셀 일부가 범위 안이면 결과에 포함된다). 그 외 조건은 병합된 셀의 대표 셀 좌표/속성 기준으로 평가한다.
findCells(filter?: CellFilter): Promise<TableCell[]>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
filter (선택) | CellFilter | 검색 조건. null 도 조건 없음으로 본다 (기본값: 전체 셀) |
반환값
Promise<TableCell[]> - 조건에 맞는 셀 목록
flip(direction)
도형을 상하 또는 좌우로 반전한다. 현재 반전 상태를 뒤집는 토글이며, 지금 반전돼 있는지는 isFlippedH()/isFlippedV() 로 읽는다. 회전이 불가능한 도형에서는 반전도 무시된다. 회전된 도형은 각도도 거울상으로 함께 바뀐다 (getRotation() 값이 360 - 기존 각도 로 바뀐다).
flip(direction: FlipDirection): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
direction | FlipDirection | 반전 방향 |
반환값
Promise<void>
getCell(row, col)
지정 좌표의 셀을 반환한다. 병합 영역 내부 좌표를 지정하면 그 병합 영역의 대표 셀을 반환한다.
getCell(row: number, col: number): Promise<TableCell>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
row | number | 행 인덱스 (0-based) |
col | number | 열 인덱스 (0-based) |
반환값
Promise<TableCell> - 해당 셀 (범위를 벗어나면 null)
getCells()
모든 셀을 배열로 반환한다. 병합된 셀은 대표 셀 하나만 포함한다.
getCells(): Promise<TableCell[]>;
반환값
Promise<TableCell[]> - 셀 목록
getColCount()
표의 열 개수를 반환한다.
getColCount(): Promise<number>;
반환값
Promise<number> - 열 개수. 표가 없으면 0
getColumn(colIndex)
지정 열의 셀 배열을 반환한다. 병합된 셀은 대표 셀 하나만 포함한다.
getColumn(colIndex: number): Promise<TableCell[]>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
colIndex | number | 0-based 열 인덱스 |
반환값
Promise<TableCell[]> - 해당 열의 셀 목록
getColWidth(colIndex)
지정 열의 너비를 반환한다. (setColWidth 대칭)
getColWidth(colIndex: number): Promise<number | null>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
colIndex | number | 열 인덱스 (0-based) |
반환값
Promise<number | null> - 너비 (px 단위), 범위 밖이면 null
getHeight()
도형의 높이를 반환한다. (setHeight 대칭)
getHeight(): Promise<number | null>;
반환값
Promise<number | null> - 높이 (px 단위). 대상 도형이 없으면 null
getHyperlink()
도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다. 지원하지 않는 종류(프로그램 실행·매크로 등)가 걸려 있으면 null 이다.
getHyperlink(): Promise<Hyperlink | null>;
반환값
Promise<Hyperlink | null> - 하이퍼링크 정보. 하이퍼링크(action)가 없으면 null
getPlaceholderType()
도형의 placeholder 종류를 반환한다.
getPlaceholderType(): Promise<PlaceholderType | null>;
반환값
Promise<PlaceholderType | null> - placeholder 종류. placeholder 가 아니거나 대상 도형이 없으면 null
getPresetId()
도형의 OOXML preset id (prst) 를 반환한다.
getPresetId(): Promise<string | null>;
반환값
Promise<string | null> - preset id (prst), 없으면 null
getRotation()
도형의 회전 각도를 반환한다. (setRotation 대칭)
getRotation(): Promise<number | null>;
반환값
Promise<number | null> - 회전 각도 (degree). 대상 도형이 없으면 null
getRow(rowIndex)
지정 행의 셀 배열을 반환한다. 병합된 셀은 대표 셀 하나만 포함한다.
getRow(rowIndex: number): Promise<TableCell[]>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
rowIndex | number | 0-based 행 인덱스 |
반환값
Promise<TableCell[]> - 해당 행의 셀 목록
getRowCount()
표의 행 개수를 반환한다.
getRowCount(): Promise<number>;
반환값
Promise<number> - 행 개수. 표가 없으면 0
getRowHeight(rowIndex)
지정 행의 높이를 반환한다. (setRowHeight 대칭)
getRowHeight(rowIndex: number): Promise<number | null>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
rowIndex | number | 행 인덱스 (0-based) |
반환값
Promise<number | null> - 높이 (px 단위), 범위 밖이면 null
getStyleName()
표에 적용된 스타일 이름을 반환한다. (setStyle 대칭) 반환한 이름은 그대로 setStyle 에 되먹일 수 있다. 다만 문서에만 실려 있고 편집기 갤러리에는 없는 스타일이면 doc.getTableStyleNames() 목록에는 나오지 않는다.
getStyleName(): Promise<string | null>;
반환값
Promise<string | null> - 표 스타일 이름. 스타일이 없거나 이름이 없는 스타일(문서가 이름을 싣지 않은 경우)이면 null
getStyleOption(option)
표 스타일 옵션(머리글 행, 줄무늬 행 등)의 활성화 여부를 반환한다. (setStyleOption 대칭)
getStyleOption(option: TableStyleOption): Promise<boolean | null>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
option | TableStyleOption | 옵션 유형 (apiConstants.TableStyleOption) |
반환값
Promise<boolean | null> - 활성화 여부. 표나 표 속성을 읽을 수 없으면 null
getTransform()
도형의 위치, 크기, 회전 정보를 반환한다. x/y 는 반전(flip) 여부와 무관하게 도형의 좌상단이라, 반환값을 다른 도형의 setTransform 에 그대로 넘기면 두 도형이 같은 자리에 놓인다. 값은 에디터 입력 단위로 반올림해 반환한다 - 크기는 소수 한 자리, 위치는 정수. setter 도 같은 단위로 넣으므로, 임포트 문서처럼 더 잘게 놓인 도형은 되넘길 때 그만큼 움직인다.
getTransform(): Promise<ShapeTransform | null>;
반환값
Promise<ShapeTransform | null> - 도형의 위치·크기·회전 정보. 대상 도형이 없으면(협업 중 삭제 등) null
getWidth()
도형의 너비를 반환한다. (setWidth 대칭)
getWidth(): Promise<number | null>;
반환값
Promise<number | null> - 너비 (px 단위). 대상 도형이 없으면 null
getX()
도형의 X 좌표를 반환한다. (setX 대칭)
getX(): Promise<number | null>;
반환값
Promise<number | null> - X 좌표 (px 단위). 대상 도형이 없으면 null
getY()
도형의 Y 좌표를 반환한다. (setY 대칭)
getY(): Promise<number | null>;
반환값
Promise<number | null> - Y 좌표 (px 단위). 대상 도형이 없으면 null
getZOrderIndex()
부모(슬라이드, 그룹 자식이면 그 그룹) 안에서 도형의 z-order 순번을 반환한다. 0 이 맨 뒤이며, 클수록 앞이다.
getZOrderIndex(): Promise<number | null>;
반환값
Promise<number | null> - z-order 순번. 대상 도형이 없으면 null
hasText()
도형이 텍스트를 담고 있는지 반환한다. 에디터가 텍스트를 비었다고 보는 기준과 같다 - 공백만 있거나 빈 문단이 둘 이상(개행만 넣은 상태)이면 true, 빈 문단 하나뿐이면 false 다. 도형 레벨 텍스트가 없는 종류(표·그룹·차트)는 항상 false 다. (표는 셀 단위로 조회)
hasText(): Promise<boolean | null>;
반환값
Promise<boolean | null> - 텍스트 존재 여부. 대상 도형이 없으면 null
insertCol(baseColIndex, position, insertNum)
기준 열의 왼쪽 또는 오른쪽에 열을 삽입한다. 새 열은 기준 열의 서식을 상속한다.
insertCol(baseColIndex: number, position: InsertPosition, insertNum: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
baseColIndex | number | 삽입 기준 열 인덱스 (0-based) |
position | InsertPosition | InsertPosition.LEFT | InsertPosition.RIGHT |
insertNum | number | 삽입할 열 개수 |
반환값
Promise<void>
insertRow(baseRowIndex, position, insertNum)
기준 행의 위 또는 아래에 행을 삽입한다. 새 행은 기준 행의 서식을 상속한다.
insertRow(baseRowIndex: number, position: InsertPosition, insertNum: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
baseRowIndex | number | 삽입 기준 행 인덱스 (0-based) |
position | InsertPosition | InsertPosition.ABOVE | InsertPosition.BELOW |
insertNum | number | 삽입할 행 개수 |
반환값
Promise<void>
isChart()
이 핸들이 Chart 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 - postMessage 왕복 없음, await 불필요.
isChart(): Promise<this is Chart>;
반환값
Promise<this is Chart>
isControl()
이 핸들이 Control 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 - postMessage 왕복 없음, await 불필요.
isControl(): Promise<this is Control>;
반환값
Promise<this is Control>
isDiagram()
이 핸들이 Diagram 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 - postMessage 왕복 없음, await 불필요.
isDiagram(): Promise<this is Diagram>;
반환값
Promise<this is Diagram>
isFlippedH()
도형이 좌우로 반전된 상태인지 반환한다. (flip(FlipDirection.HORIZONTAL) 을 호출하면 이 값이 뒤집힌다)
isFlippedH(): Promise<boolean | null>;
반환값
Promise<boolean | null> - 좌우 반전 여부. 대상 도형이 없으면 null
isFlippedV()
도형이 상하로 반전된 상태인지 반환한다. (flip(FlipDirection.VERTICAL) 을 호출하면 이 값이 뒤집힌다)
isFlippedV(): Promise<boolean | null>;
반환값
Promise<boolean | null> - 상하 반전 여부. 대상 도형이 없으면 null
isGroup()
이 핸들이 Group 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 - postMessage 왕복 없음, await 불필요.
isGroup(): Promise<this is Group>;
반환값
Promise<this is Group>
isImage()
이 핸들이 Image 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 - postMessage 왕복 없음, await 불필요.
isImage(): Promise<this is Image>;
반환값
Promise<this is Image>
isLine()
이 핸들이 Line 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 - postMessage 왕복 없음, await 불필요.
isLine(): Promise<this is Line>;
반환값
Promise<this is Line>
isOleObject()
이 핸들이 OleObject 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 - postMessage 왕복 없음, await 불필요.
isOleObject(): Promise<this is OleObject>;
반환값
Promise<this is OleObject>
isPlaceholder()
도형이 placeholder(제목 · 본문 틀 등)인지 반환한다.
isPlaceholder(): Promise<boolean | null>;
반환값
Promise<boolean | null> - placeholder 여부. 대상 도형이 없으면 null
isShape()
이 핸들이 Shape 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 - postMessage 왕복 없음, await 불필요.
isShape(): Promise<this is Shape>;
반환값
Promise<this is Shape>
isTable()
이 핸들이 Table 인지 판별한다 (union 좁히기용 type guard). SDK 핸들의 내부 판별값을 동기 검사한다 - postMessage 왕복 없음, await 불필요.
isTable(): Promise<this is Table>;
반환값
Promise<this is Table>
mergeCell(startRow, startCol, endRow, endCol)
지정 범위의 셀을 병합한다.
mergeCell(startRow: number, startCol: number, endRow: number, endCol: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
startRow | number | 병합 시작 행 인덱스 (0-based) |
startCol | number | 병합 시작 열 인덱스 (0-based) |
endRow | number | 병합 끝 행 인덱스 (0-based, inclusive) |
endCol | number | 병합 끝 열 인덱스 (0-based, inclusive) |
반환값
Promise<void>
moveBy(distance)
도형을 현재 위치 기준으로 x, y 만큼 상대 이동한다. (절대 좌표 설정은 setX / setY)
moveBy(distance: ShapeMoveDistance): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
distance | ShapeMoveDistance | 이동량 (px 단위) |
반환값
Promise<void>
removeHyperlink()
도형의 하이퍼링크를 제거한다.
removeHyperlink(): Promise<void>;
반환값
Promise<void>
reorder(order)
도형의 정렬 순서(앞으로/뒤로)를 변경한다. 이미 목표 위치라 바뀔 것이 없으면 무시된다.
reorder(order: ShapeZOrder): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
order | ShapeZOrder | 순서 변경 타입 |
반환값
Promise<void>
setColWidth(colIndex, newWidth)
지정 열의 너비를 변경한다.
setColWidth(colIndex: number, newWidth: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
colIndex | number | 열 인덱스 (0-based) |
newWidth | number | 새 너비 (px 단위). colIndex 가 표의 열 수를 벗어나면 무시된다 |
반환값
Promise<void>
setHeight(height)
도형의 높이를 설정한다. 크기 조정이 불가능한 도형이면 무시된다.
setHeight(height: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
height | number | 높이 (px 단위, 소수 한 자리로 반올림) |
반환값
Promise<void>
setHyperlink(hyperlink)
도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 - 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다) 지원하지 않는 종류나 유효하지 않은 대상(삭제된 슬라이드 등)은 무시한다.
setHyperlink(hyperlink: Hyperlink): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
hyperlink | Hyperlink | getHyperlink() 반환값과 같은 Hyperlink 객체. type 이 없으면 무시한다 |
반환값
Promise<void>
setRotation(rotation)
도형의 회전 각도를 절대값으로 설정한다. 회전이 불가능한 도형이면 무시된다. (getRotation 대칭)
setRotation(rotation: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
rotation | number | 회전 각도 (degree) |
반환값
Promise<void>
setRowHeight(rowIndex, newHeight)
지정 행의 높이를 변경한다.
setRowHeight(rowIndex: number, newHeight: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
rowIndex | number | 행 인덱스 (0-based) |
newHeight | number | 새 높이 (px 단위). rowIndex 가 표의 행 수를 벗어나면 무시된다 |
반환값
Promise<void>
setStyle(styleName)
표 스타일을 변경한다. (getStyleName 대칭)
setStyle(styleName: string): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
styleName | string | 표 스타일 이름 (doc.getTableStyleNames() 결과) |
반환값
Promise<void>
setStyleOption(option, enabled)
표 스타일 옵션(머리글 행, 줄무늬 행 등)을 변경한다. (getStyleOption 대칭)
setStyleOption(option: TableStyleOption, enabled: boolean): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
option | TableStyleOption | 옵션 유형 (apiConstants.TableStyleOption) |
enabled | boolean | 활성화 여부 |
반환값
Promise<void>
setTransform(transform)
도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭) 값을 준 필드만 크기→위치→회전 순으로 적용하고, 생략한 필드는 현재 값을 유지한다. 각 필드는 개별 setter 와 같이 해당 조작(크기/이동/회전)이 불가능한 도형에서 무시된다.
setTransform(transform?: Partial<ShapeTransform>): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
transform (선택) | Partial<ShapeTransform> | 위치/크기 (px) · 회전 (degree) |
반환값
Promise<void>
setWidth(width)
도형의 너비를 설정한다. 크기 조정이 불가능한 도형이면 무시된다.
setWidth(width: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
width | number | 너비 (px 단위, 소수 한 자리로 반올림) |
반환값
Promise<void>
setX(x)
도형의 X 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다. (상대 이동은 moveBy)
setX(x: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
x | number | X 좌표 (px 단위, 정수로 반올림) |
반환값
Promise<void>
setY(y)
도형의 Y 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다.
setY(y: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
y | number | Y 좌표 (px 단위, 정수로 반올림) |
반환값
Promise<void>
unmergeCell(startRow, startCol, endRow, endCol)
지정 범위의 병합된 셀을 해제한다.
unmergeCell(startRow: number, startCol: number, endRow: number, endCol: number): Promise<void>;
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
startRow | number | 해제 시작 행 인덱스 (0-based) |
startCol | number | 해제 시작 열 인덱스 (0-based) |
endRow | number | 해제 끝 행 인덱스 (0-based, inclusive) |
endCol | number | 해제 끝 열 인덱스 (0-based, inclusive) |
반환값
Promise<void>