## ProtectedRange class

A specified range to be allowed to edit when the sheet protection is ON.

```javascript
class ProtectedRange;
```


## Properties

| Property | Type | Description |
| --- | --- | --- |
| [name](#name--)| string | Gets the Range title. This is used as a descriptor, not as a named range definition. |
| [cellArea](#cellArea--)| CellArea | Readonly. Gets the [CellArea](../cellarea/) object represents the cell area to be protected. |
| [isProtectedWithPassword](#isProtectedWithPassword--)| boolean | Readonly. Indicates whether the worksheets is protected with password. |
| [password](#password--)| string | Represents the password to protect the range. |
| [securityDescriptor](#securityDescriptor--)| string | The security descriptor defines user accounts who may edit this range without providing a password to access the range. |

## Methods

| Method | Description |
| --- | --- |
| [getName()](#getName--)| <b>@deprecated.</b> Please use the 'name' property instead. Gets the Range title. This is used as a descriptor, not as a named range definition. |
| [setName(string)](#setName-string-)| <b>@deprecated.</b> Please use the 'name' property instead. Gets the Range title. This is used as a descriptor, not as a named range definition. |
| [getCellArea()](#getCellArea--)| <b>@deprecated.</b> Please use the 'cellArea' property instead. Gets the [CellArea](../cellarea/) object represents the cell area to be protected. |
| [isProtectedWithPassword()](#isProtectedWithPassword--)| <b>@deprecated.</b> Please use the 'isProtectedWithPassword' property instead. Indicates whether the worksheets is protected with password. |
| [getPassword()](#getPassword--)| <b>@deprecated.</b> Please use the 'password' property instead. Represents the password to protect the range. |
| [setPassword(string)](#setPassword-string-)| <b>@deprecated.</b> Please use the 'password' property instead. Represents the password to protect the range. |
| [getSecurityDescriptor()](#getSecurityDescriptor--)| <b>@deprecated.</b> Please use the 'securityDescriptor' property instead. The security descriptor defines user accounts who may edit this range without providing a password to access the range. |
| [setSecurityDescriptor(string)](#setSecurityDescriptor-string-)| <b>@deprecated.</b> Please use the 'securityDescriptor' property instead. The security descriptor defines user accounts who may edit this range without providing a password to access the range. |
| [getAreas()](#getAreas--)| Gets all referred areas. |
| [addArea(number, number, number, number)](#addArea-number-number-number-number-)| Adds a referred area to this |
| [isNull()](#isNull--)| Checks whether the implementation object is null. |


### name {#name--}

Gets the Range title. This is used as a descriptor, not as a named range definition.

```javascript
name : string;
```


### cellArea {#cellArea--}

Readonly. Gets the [CellArea](../cellarea/) object represents the cell area to be protected.

```javascript
cellArea : CellArea;
```


### isProtectedWithPassword {#isProtectedWithPassword--}

Readonly. Indicates whether the worksheets is protected with password.

```javascript
isProtectedWithPassword : boolean;
```


### password {#password--}

Represents the password to protect the range.

```javascript
password : string;
```


### securityDescriptor {#securityDescriptor--}

The security descriptor defines user accounts who may edit this range without providing a password to access the range.

```javascript
securityDescriptor : string;
```


### getName() {#getName--}

<b>@deprecated.</b> Please use the 'name' property instead. Gets the Range title. This is used as a descriptor, not as a named range definition.

```javascript
getName() : string;
```


### setName(string) {#setName-string-}

<b>@deprecated.</b> Please use the 'name' property instead. Gets the Range title. This is used as a descriptor, not as a named range definition.

```javascript
setName(value: string) : void;
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | string | The value to set. |

### getCellArea() {#getCellArea--}

<b>@deprecated.</b> Please use the 'cellArea' property instead. Gets the [CellArea](../cellarea/) object represents the cell area to be protected.

```javascript
getCellArea() : CellArea;
```


**Returns**

[CellArea](../cellarea/)

### isProtectedWithPassword() {#isProtectedWithPassword--}

<b>@deprecated.</b> Please use the 'isProtectedWithPassword' property instead. Indicates whether the worksheets is protected with password.

```javascript
isProtectedWithPassword() : boolean;
```


### getPassword() {#getPassword--}

<b>@deprecated.</b> Please use the 'password' property instead. Represents the password to protect the range.

```javascript
getPassword() : string;
```


### setPassword(string) {#setPassword-string-}

<b>@deprecated.</b> Please use the 'password' property instead. Represents the password to protect the range.

```javascript
setPassword(value: string) : void;
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | string | The value to set. |

### getSecurityDescriptor() {#getSecurityDescriptor--}

<b>@deprecated.</b> Please use the 'securityDescriptor' property instead. The security descriptor defines user accounts who may edit this range without providing a password to access the range.

```javascript
getSecurityDescriptor() : string;
```


### setSecurityDescriptor(string) {#setSecurityDescriptor-string-}

<b>@deprecated.</b> Please use the 'securityDescriptor' property instead. The security descriptor defines user accounts who may edit this range without providing a password to access the range.

```javascript
setSecurityDescriptor(value: string) : void;
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| value | string | The value to set. |

### getAreas() {#getAreas--}

Gets all referred areas.

```javascript
getAreas() : CellArea[];
```


**Returns**

Returns all referred areas.

### addArea(number, number, number, number) {#addArea-number-number-number-number-}

Adds a referred area to this

```javascript
addArea(startRow: number, startColumn: number, endRow: number, endColumn: number) : void;
```

**Parameters:**
| Parameter | Type | Description |
| --- | --- | --- |
| startRow | number | The start row. |
| startColumn | number | The start column. |
| endRow | number | The end row. |
| endColumn | number | The end column. |

### isNull() {#isNull--}

Checks whether the implementation object is null.

```javascript
isNull() : boolean;
```