본문으로 건너뛰기

Cell.Name

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

비고​

메서드​

메서드설명
delete()정의된 이름을 삭제한다.
getFormula()이 이름이 가리키는 수식을 반환한다.
getInfo()이름과 사용 범위 시트, 수식, 가리키는 영역을 한 번에 반환한다.
getName()이름을 반환한다.
getRanges()이 이름이 실제로 가리키는 영역을 반환한다.
getSheetName()이 이름의 사용 범위인 시트 이름을 반환한다.
setFormula(formula)정의된 이름이 가리킬 수식을 바꾼다.
setName(newName)정의된 이름의 이름을 바꾼다.
update(fields)정의된 이름의 이름과 수식을 한 번에 바꾼다.

메서드 상세​

delete()​

정의된 이름을 삭제한다.

delete(): Promise<void>;

반환값

none

getFormula()​

이 이름이 가리키는 수식을 반환한다. 수식의 상대 참조는 활성 시트의 활성 셀을 기준으로 풀어 쓰므로, 같은 이름이라도 활성 셀이 달라지면 반환값이 달라질 수 있다.

getFormula(): Promise<string>;

반환값

Promise<string> - = 로 시작하는 수식

getInfo()​

이름과 사용 범위 시트, 수식, 가리키는 영역을 한 번에 반환한다. 각 값은 getName()·getSheetName()·getFormula()·getRanges() 와 같다.

getInfo(): Promise<NameInfo>;

반환값

Promise<NameInfo> - 수식은 = 로 시작한다

getName()​

이름을 반환한다.

getName(): Promise<string>;

반환값

Promise<string>

getRanges()​

이 이름이 실제로 가리키는 영역을 반환한다. 영역이 여럿이면 콤마로 이어 붙이고, 각 영역에는 시트 이름을 항상 붙인다.

getRanges(): Promise<string>;

반환값

Promise<string> - 상수나 오류를 가리키는 이름, 지원하지 않는 함수를 쓴 이름이면 빈 문자열

getSheetName()​

이 이름의 사용 범위인 시트 이름을 반환한다.

getSheetName(): Promise<string | null>;

반환값

Promise<string | null> - 특정 시트에서만 쓰는 이름이면 그 시트 이름, 문서 전체에서 쓰는 이름이면 null

setFormula(formula)​

정의된 이름이 가리킬 수식을 바꾼다. 수식에 시트를 적지 않은 참조는 이름의 사용 범위와 무관하게 활성 시트 기준으로 해석한다.

setFormula(formula: string): Promise<void>;

매개변수

이름타입설명
formulastring새 수식 또는 참조

반환값

none

setName(newName)​

정의된 이름의 이름을 바꾼다. 같은 사용 범위에 이미 있는 이름이나 표 이름으로는 바꿀 수 없다.

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

매개변수

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

반환값

none

update(fields)​

정의된 이름의 이름과 수식을 한 번에 바꾼다. 바꿀 항목을 하나도 주지 않으면 오류가 난다.

update(fields: NameUpdate): Promise<void>;

매개변수

이름타입설명
fieldsNameUpdate바꿀 항목

반환값

none