ExcelScript.AllowEditRange interface

Paket:

ExcelScript

Stellt ein AllowEditRange Objekt dar, das in einem Arbeitsblatt gefunden wurde. Dieses Objekt funktioniert mit Arbeitsblattschutzeigenschaften. Wenn der Arbeitsblattschutz aktiviert ist, kann ein AllowEditRange -Objekt verwendet werden, um die Bearbeitung eines bestimmten Bereichs zu ermöglichen, während der Schutz für den Rest des Arbeitsblatts beibehalten wird.

Methoden

delete()	Löscht das -Objekt aus der AllowEditRangeCollection. Der Arbeitsblattschutz muss deaktiviert oder angehalten werden, damit diese Methode ordnungsgemäß funktioniert. Wenn der Arbeitsblattschutz aktiviert und nicht angehalten ist, löst diese Methode einen Fehler aus AccessDenied und schlägt den Löschvorgang fehl.
getAddress()	Gibt den Bereich an, der dem -Objekt zugeordnet ist.
getIsPasswordProtected()	Gibt an, ob das Objekt kennwortsicher ist.
getTitle()	Gibt den Titel des Objekts an.
pauseProtection(password)	Hält den Arbeitsblattschutz für das Objekt für den Benutzer in der aktuellen Sitzung an. Diese Methode führt keine Aktion aus, wenn der Arbeitsblattschutz nicht aktiviert oder bereits angehalten ist. Wenn der Arbeitsblattschutz nicht angehalten werden kann, löst diese Methode einen Fehler aus UnsupportedOperation und kann den Schutz für das Objekt nicht anhalten. Wenn das Kennwort falsch ist, löst diese Methode einen Fehler aus BadPassword und kann den Schutz für das Objekt nicht anhalten. Wenn ein Kennwort angegeben wird, das Objekt aber kein Kennwort erfordert, wird das eingegebene Kennwort ignoriert, und der Vorgang wird erfolgreich ausgeführt.
setAddress(address)	Gibt den Bereich an, der dem -Objekt zugeordnet ist. Der Arbeitsblattschutz muss deaktiviert oder angehalten werden, damit diese Methode ordnungsgemäß funktioniert. Wenn der Arbeitsblattschutz aktiviert und nicht angehalten ist, löst diese Methode einen Fehler aus AccessDenied und kann den Bereich nicht festlegen.
setPassword(password)	Ändert das Kennwort, das dem -Objekt zugeordnet ist. Wenn Sie die Kennwortzeichenfolge als leer ("") oder null festlegen, wird der Kennwortschutz für das -Objekt entfernt. Der Arbeitsblattschutz muss deaktiviert oder angehalten werden, damit diese Methode ordnungsgemäß funktioniert. Wenn der Arbeitsblattschutz aktiviert und nicht angehalten ist, löst diese Methode einen Fehler aus AccessDenied , und der Set-Vorgang schlägt fehl.
setTitle(title)	Gibt den Titel des Objekts an. Der Arbeitsblattschutz muss deaktiviert oder angehalten werden, damit diese Methode ordnungsgemäß funktioniert. Wenn der Arbeitsblattschutz aktiviert und nicht angehalten ist, löst diese Methode einen Fehler aus AccessDenied und kann den Titel nicht festlegen. Wenn bereits eine mit derselben Zeichenfolge vorhanden AllowEditRange ist oder die Zeichenfolge leer ist null (""), löst diese Methode einen Fehler aus InvalidArgument und kann den Titel nicht festlegen.

Details zur Methode

delete()

Löscht das -Objekt aus der AllowEditRangeCollection. Der Arbeitsblattschutz muss deaktiviert oder angehalten werden, damit diese Methode ordnungsgemäß funktioniert. Wenn der Arbeitsblattschutz aktiviert und nicht angehalten ist, löst diese Methode einen Fehler aus AccessDenied und schlägt den Löschvorgang fehl.

delete(): void;

Gibt zurück

void

getAddress()

Gibt den Bereich an, der dem -Objekt zugeordnet ist.

getAddress(): string;

Gibt zurück

string

getIsPasswordProtected()

Gibt an, ob das Objekt kennwortsicher ist.

getIsPasswordProtected(): boolean;

Gibt zurück

boolean

getTitle()

Gibt den Titel des Objekts an.

getTitle(): string;

Gibt zurück

string

pauseProtection(password)

Hält den Arbeitsblattschutz für das Objekt für den Benutzer in der aktuellen Sitzung an. Diese Methode führt keine Aktion aus, wenn der Arbeitsblattschutz nicht aktiviert oder bereits angehalten ist. Wenn der Arbeitsblattschutz nicht angehalten werden kann, löst diese Methode einen Fehler aus UnsupportedOperation und kann den Schutz für das Objekt nicht anhalten. Wenn das Kennwort falsch ist, löst diese Methode einen Fehler aus BadPassword und kann den Schutz für das Objekt nicht anhalten. Wenn ein Kennwort angegeben wird, das Objekt aber kein Kennwort erfordert, wird das eingegebene Kennwort ignoriert, und der Vorgang wird erfolgreich ausgeführt.

pauseProtection(password?: string): void;

Parameter

password

string

Das Kennwort, das dem AllowEditRange -Objekt zugeordnet ist.

Gibt zurück

void

setAddress(address)

Gibt den Bereich an, der dem -Objekt zugeordnet ist. Der Arbeitsblattschutz muss deaktiviert oder angehalten werden, damit diese Methode ordnungsgemäß funktioniert. Wenn der Arbeitsblattschutz aktiviert und nicht angehalten ist, löst diese Methode einen Fehler aus AccessDenied und kann den Bereich nicht festlegen.

setAddress(address: string): void;

Parameter

address

string

Gibt zurück

void

setPassword(password)

Ändert das Kennwort, das dem -Objekt zugeordnet ist. Wenn Sie die Kennwortzeichenfolge als leer ("") oder null festlegen, wird der Kennwortschutz für das -Objekt entfernt. Der Arbeitsblattschutz muss deaktiviert oder angehalten werden, damit diese Methode ordnungsgemäß funktioniert. Wenn der Arbeitsblattschutz aktiviert und nicht angehalten ist, löst diese Methode einen Fehler aus AccessDenied , und der Set-Vorgang schlägt fehl.

setPassword(password?: string): void;

Parameter

password

string

Das Kennwort, das dem AllowEditRange -Objekt zugeordnet ist.

Gibt zurück

void

setTitle(title)

Gibt den Titel des Objekts an. Der Arbeitsblattschutz muss deaktiviert oder angehalten werden, damit diese Methode ordnungsgemäß funktioniert. Wenn der Arbeitsblattschutz aktiviert und nicht angehalten ist, löst diese Methode einen Fehler aus AccessDenied und kann den Titel nicht festlegen. Wenn bereits eine mit derselben Zeichenfolge vorhanden AllowEditRange ist oder die Zeichenfolge leer ist null (""), löst diese Methode einen Fehler aus InvalidArgument und kann den Titel nicht festlegen.

setTitle(title: string): void;

Parameter

title

string

Gibt zurück

void