# RowChangeAlertDefinition

Canonical page: https://www.adaptabletools.com/docs/reference/rowchangealertdefinition

Alert that fires when a row is added to or removed from the grid.

Set `Type` to `'RowChange'` and `RowChangeTrigger` to `'Added'` or `'Removed'`. `Scope` is `{ All: true }`. `Rule` is an optional per-row boolean expression (`[make] = 'Toyota'`); when it is omitted every matching row event fires.

```ts title="TypeScript"
export interface RowChangeAlertDefinition extends AlertDefinitionBase 
```

###### Extends

[`AlertDefinitionBase`](https://www.adaptabletools.com/docs/reference/alertdefinitionbase.md)

## Properties

| Property | Type | Description |
| --- | --- | --- |
| [AlertForm](https://www.adaptabletools.com/docs/reference/rowchangealertdefinition.md#alertform) | `string \| `[`AlertButtonForm`](https://www.adaptabletools.com/docs/reference/alertbuttonform.md) | Form to display in Alert with buttons and inputs |
| [AlertProperties](https://www.adaptabletools.com/docs/reference/rowchangealertdefinition.md#alertproperties) | [`RuleAlertProperties`](https://www.adaptabletools.com/docs/reference/rulealertproperties.md) | Properties which set what happens when the Alert is triggered (notification and grid behaviours) |
| [RowChangeTrigger](https://www.adaptabletools.com/docs/reference/rowchangealertdefinition.md#rowchangetrigger) | `'Added' \| 'Removed'` | Which row event fires the Alert. |
| [Rule](https://www.adaptabletools.com/docs/reference/rowchangealertdefinition.md#rule) | `string` | Optional boolean expression evaluated on the added / removed row; when<br/>absent every row event fires. |
| [Scope](https://www.adaptabletools.com/docs/reference/rowchangealertdefinition.md#scope) | [`ColumnScope`](https://www.adaptabletools.com/docs/reference/columnscope.md) | Kept for uniformity with the other grid Alerts; Row Change Alerts apply<br/>to the whole row (`{ All: true }`). |
| [Type](https://www.adaptabletools.com/docs/reference/rowchangealertdefinition.md#type) | `'RowChange'` |   |
| [IsReadOnly](https://www.adaptabletools.com/docs/reference/rowchangealertdefinition.md#isreadonly) | `boolean` | Sets Entity to ReadOnly (overwriting a Strategy Entitlement of &#39;Full&#39;) |
| [IsSuspended](https://www.adaptabletools.com/docs/reference/rowchangealertdefinition.md#issuspended) | `boolean` | Suspends (i.e. turns off) an Adaptable Object |

## Property Details

### AlertForm

Form to display in Alert with buttons and inputs

```ts title="TypeScript"
AlertForm?: string | AlertButtonForm;
```

###### Property Value

`string | `[`AlertButtonForm`](https://www.adaptabletools.com/docs/reference/alertbuttonform.md)

### AlertProperties

Properties which set what happens when the Alert is triggered (notification and grid behaviours)

```ts title="TypeScript"
AlertProperties?: RuleAlertProperties;
```

###### Property Value

[`RuleAlertProperties`](https://www.adaptabletools.com/docs/reference/rulealertproperties.md)

### RowChangeTrigger

Which row event fires the Alert.

```ts title="TypeScript"
RowChangeTrigger: 'Added' | 'Removed';
```

###### Property Value

`'Added' | 'Removed'`

### Rule

Optional boolean expression evaluated on the added / removed row; when
absent every row event fires.

```ts title="TypeScript"
Rule?: string;
```

###### Property Value

`string`

### Scope

Kept for uniformity with the other grid Alerts; Row Change Alerts apply
to the whole row (`{ All: true }`).

```ts title="TypeScript"
Scope: ColumnScope;
```

###### Property Value

[`ColumnScope`](https://www.adaptabletools.com/docs/reference/columnscope.md)

### Type

```ts title="TypeScript"
Type: 'RowChange';
```

###### Property Value

`'RowChange'`

### IsSuspended

> *Inherited from [SuspendableObject](https://www.adaptabletools.com/docs/reference/suspendableobject.md)*

Suspends (i.e. turns off) an Adaptable Object

```ts title="TypeScript"
IsSuspended?: boolean;
```

###### Property Value

`boolean`

### IsReadOnly

> *Inherited from [AdaptableObject](https://www.adaptabletools.com/docs/reference/adaptableobject.md)*

Sets Entity to ReadOnly (overwriting a Strategy Entitlement of &#39;Full&#39;)

```ts title="TypeScript"
IsReadOnly?: boolean;
```

###### Property Value

`boolean`
