ExcelScript.AllowEditRange interface

Представляет объект, AllowEditRange найденный на листе. Этот объект работает со свойствами защиты листа. Если включена защита листа, AllowEditRange объект можно использовать для разрешения редактирования определенного диапазона, сохраняя при этом защиту остальной части листа.

Методы

delete()

Удаляет объект из AllowEditRangeCollection. Чтобы этот метод работал правильно, защита листа должна быть отключена или приостановлена. Если защита листа включена и не приостановлена, этот метод выдает ошибку AccessDenied и завершается сбоем операции удаления.

getAddress()

Указывает диапазон, связанный с объектом .

getIsPasswordProtected()

Указывает, защищен ли объект паролем.

getTitle()

Задает заголовок объекта.

pauseProtection(password)

Приостанавливает защиту листа для объекта для пользователя в текущем сеансе. Этот метод ничего не делает, если защита листа не включена или уже приостановлена. Если не удается приостановить защиту листа, этот метод выдает ошибку UnsupportedOperation и не приостанавливает защиту для объекта . Если пароль неверный, этот метод выдает ошибку BadPassword и не приостанавливает защиту для объекта. Если пароль указан, но объекту не требуется пароль, введенный пароль будет игнорироваться, и операция будет выполнена успешно.

setAddress(address)

Указывает диапазон, связанный с объектом . Чтобы этот метод работал правильно, защита листа должна быть отключена или приостановлена. Если защита листа включена и не приостановлена, этот метод выдает ошибку AccessDenied и не задает диапазон.

setPassword(password)

Изменяет пароль, связанный с объектом . Установка строки пароля как пустой ("") или null приведет к удалению защиты паролем для объекта. Чтобы этот метод работал правильно, защита листа должна быть отключена или приостановлена. Если защита листа включена и не приостановлена, этот метод выдает ошибку AccessDenied и операция установки завершается сбоем.

setTitle(title)

Задает заголовок объекта. Чтобы этот метод работал правильно, защита листа должна быть отключена или приостановлена. Если защита листа включена и не приостановлена, этот метод выдает ошибку AccessDenied и не удается задать заголовок. Если уже существует AllowEditRange объект с той же строкой или строка пуста null (""), этот метод выдает ошибку InvalidArgument и не удается задать заголовок.

Сведения о методе

delete()

Удаляет объект из AllowEditRangeCollection. Чтобы этот метод работал правильно, защита листа должна быть отключена или приостановлена. Если защита листа включена и не приостановлена, этот метод выдает ошибку AccessDenied и завершается сбоем операции удаления.

delete(): void;

Возвращаемое значение

void

getAddress()

Указывает диапазон, связанный с объектом .

getAddress(): string;

Возвращаемое значение

string

getIsPasswordProtected()

Указывает, защищен ли объект паролем.

getIsPasswordProtected(): boolean;

Возвращаемое значение

boolean

getTitle()

Задает заголовок объекта.

getTitle(): string;

Возвращаемое значение

string

pauseProtection(password)

Приостанавливает защиту листа для объекта для пользователя в текущем сеансе. Этот метод ничего не делает, если защита листа не включена или уже приостановлена. Если не удается приостановить защиту листа, этот метод выдает ошибку UnsupportedOperation и не приостанавливает защиту для объекта . Если пароль неверный, этот метод выдает ошибку BadPassword и не приостанавливает защиту для объекта. Если пароль указан, но объекту не требуется пароль, введенный пароль будет игнорироваться, и операция будет выполнена успешно.

pauseProtection(password?: string): void;

Параметры

password

string

Пароль, связанный AllowEditRange с объектом .

Возвращаемое значение

void

setAddress(address)

Указывает диапазон, связанный с объектом . Чтобы этот метод работал правильно, защита листа должна быть отключена или приостановлена. Если защита листа включена и не приостановлена, этот метод выдает ошибку AccessDenied и не задает диапазон.

setAddress(address: string): void;

Параметры

address

string

Возвращаемое значение

void

setPassword(password)

Изменяет пароль, связанный с объектом . Установка строки пароля как пустой ("") или null приведет к удалению защиты паролем для объекта. Чтобы этот метод работал правильно, защита листа должна быть отключена или приостановлена. Если защита листа включена и не приостановлена, этот метод выдает ошибку AccessDenied и операция установки завершается сбоем.

setPassword(password?: string): void;

Параметры

password

string

Пароль, связанный AllowEditRange с объектом .

Возвращаемое значение

void

setTitle(title)

Задает заголовок объекта. Чтобы этот метод работал правильно, защита листа должна быть отключена или приостановлена. Если защита листа включена и не приостановлена, этот метод выдает ошибку AccessDenied и не удается задать заголовок. Если уже существует AllowEditRange объект с той же строкой или строка пуста null (""), этот метод выдает ошибку InvalidArgument и не удается задать заголовок.

setTitle(title: string): void;

Параметры

title

string

Возвращаемое значение

void