Column

A column.

Available for Google Chat apps and Google Workspace add-ons.

```javascript
const columnWidget = CardService.newTextParagraph();
const column =
    CardService.newColumn()
        .setHorizontalSizeStyle(
            CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE)
        .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER)
        .setVerticalAlignment(CardService.VerticalAlignment.CENTER)
        .addWidget(columnWidget);
```

### Methods

| Method | Return type | Brief description |
|---|---|---|
| `https://developers.google.com/apps-script/reference/card-service/column#addWidget(Widget)` | `https://developers.google.com/apps-script/reference/card-service/column#` | Adds a widget to the column. |
| `https://developers.google.com/apps-script/reference/card-service/column#setHorizontalAlignment(HorizontalAlignment)` | `https://developers.google.com/apps-script/reference/card-service/column#` | Sets the `https://developers.google.com/apps-script/reference/card-service/horizontal-alignment` of the `https://developers.google.com/apps-script/reference/card-service/column#`. |
| `https://developers.google.com/apps-script/reference/card-service/column#setHorizontalSizeStyle(HorizontalSizeStyle)` | `https://developers.google.com/apps-script/reference/card-service/column#` | Sets the `https://developers.google.com/apps-script/reference/card-service/horizontal-size-style` of the Column. |
| `https://developers.google.com/apps-script/reference/card-service/column#setVerticalAlignment(VerticalAlignment)` | `https://developers.google.com/apps-script/reference/card-service/column#` | Sets the `https://developers.google.com/apps-script/reference/card-service/vertical-alignment` of the `https://developers.google.com/apps-script/reference/card-service/column#`. |

## Detailed documentation

### `addWidget(widget)`

Adds a widget to the column.

Widgets are displayed in the order they are added. You can add the following widgets to a
column:

- `https://developers.google.com/apps-script/reference/card-service/text-paragraph`
- `https://developers.google.com/apps-script/reference/card-service/image`
- `https://developers.google.com/apps-script/reference/card-service/decorated-text`
- `https://developers.google.com/apps-script/reference/card-service/button-set`
- `https://developers.google.com/apps-script/reference/card-service/text-input`
- `https://developers.google.com/apps-script/reference/card-service/selection-input`
- `https://developers.google.com/apps-script/reference/card-service/date-time-picker`

```javascript
const column = CardService.newColumn().addWidget(
    CardService.newTextParagraph().setText('This is a text paragraph widget'),
);
```

#### Parameters

| Name | Type | Description |
|---|---|---|
| `widget` | `https://developers.google.com/apps-script/reference/card-service/widget` | The widget to add to the column. |

#### Return


`https://developers.google.com/apps-script/reference/card-service/column#` --- This object, for chaining.

*** ** * ** ***

### `setHorizontalAlignment(horizontalAlignment)`

Sets the `https://developers.google.com/apps-script/reference/card-service/horizontal-alignment` of the `https://developers.google.com/apps-script/reference/card-service/column#`. Optional.

```javascript
const column = CardService.newColumn().setHorizontalAlignment(
    CardService.HorizontalAlignment.CENTER,
);
```

#### Parameters

| Name | Type | Description |
|---|---|---|
| `horizontalAlignment` | `https://developers.google.com/apps-script/reference/card-service/horizontal-alignment` | The horizontal alignment of the column. |

#### Return


`https://developers.google.com/apps-script/reference/card-service/column#` --- This object, for chaining.

*** ** * ** ***

### `setHorizontalSizeStyle(horizontalSizeStyle)`

Sets the `https://developers.google.com/apps-script/reference/card-service/horizontal-size-style` of the Column. Optional.

```javascript
const column = CardService.newColumn().setHorizontalSizeStyle(
    CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE,
);
```

#### Parameters

| Name | Type | Description |
|---|---|---|
| `horizontalSizeStyle` | `https://developers.google.com/apps-script/reference/card-service/horizontal-size-style` | The horizontal size of the column. |

#### Return


`https://developers.google.com/apps-script/reference/card-service/column#` --- This object, for chaining.

*** ** * ** ***

### `setVerticalAlignment(verticalAlignment)`

Sets the `https://developers.google.com/apps-script/reference/card-service/vertical-alignment` of the `https://developers.google.com/apps-script/reference/card-service/column#`. Optional.

```javascript
const column = CardService.newColumn().setVerticalAlignment(
    CardService.VerticalAlignment.CENTER,
);
```

#### Parameters

| Name | Type | Description |
|---|---|---|
| `verticalAlignment` | `https://developers.google.com/apps-script/reference/card-service/vertical-alignment` | The vertical alignment of the column. |

#### Return


`https://developers.google.com/apps-script/reference/card-service/column#` --- This object, for chaining.