> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reducto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Other classes: Shapes and charts

## `Adjustments`

`PowerPoint.Adjustments`: the shape's `a:avLst` over Appendix D's handles.
As in VBA, a length is a fraction of the shape (50000 → 0.5) and an angle is in degrees.

Import from `@reductoai/pptx/officejs`.

### Adjustments properties

| Name | Type | Description |
| - | - | - |
| `count` | `number` | read-only |

### `Adjustments.get()`

```ts theme={null}
get(index: number): number
```

Office.js returns a ClientResult.

### `Adjustments.set()`

```ts theme={null}
set(index: number, value: number): void
```

## `Border`

`PowerPoint.Border`: one edge of a table cell; `visible` is an extension (VBA `LineFormat.Visible`).

Import from `@reductoai/pptx/officejs`.

### Border properties

| Name | Type | Description |
| - | - | - |
| `brightness` | `number` | Extension (VBA `LineFormat.ForeColor.Brightness`). |
| `capStyle` | `ShapeLineCapStyle` | Extension, as `ShapeLineFormat.capStyle`. |
| `color` | `string` | |
| `dashStyle` | `ShapeLineDashStyle` | |
| `presetDash` | `PresetLineDash` | Extension: the `a:prstDash` value, for Pen Style's dashes Office.js has no name for. |
| `style` | `ShapeLineStyle` | Extension (VBA `LineFormat.Style`): the compound line. |
| `themeColor` | `ShapeThemeColor \| null` | Extension (VBA `LineFormat.ForeColor.ObjectThemeColor`): null for an RGB colour. |
| `transparency` | `number` | |
| `visible` | `boolean` | Extension: false states no border (`a:noFill`), over whatever the table style draws. |
| `weight` | `number` | Line width in points. |

## `Borders`

`PowerPoint.Borders`.

Import from `@reductoai/pptx/officejs`.

### Borders properties

| Name | Type | Description |
| - | - | - |
| `bottom` | `Border` | read-only |
| `diagonalDown` | `Border` | read-only |
| `diagonalUp` | `Border` | read-only |
| `left` | `Border` | read-only |
| `right` | `Border` | read-only |
| `top` | `Border` | read-only |

## `ChartShape`

Extension (VBA `Shape` on a chart): one shape in `c:userShapes`, placed in chart fractions.

Import from `@reductoai/pptx/officejs`.

### ChartShape properties

| Name | Type | Description |
| - | - | - |
| `fill` | `ShapeFill` | read-only |
| `lineFormat` | `ShapeLineFormat` | read-only |
| `textFrame` | `TextFrame` | read-only |
| `geometricShapeType` | `GeometricShapeType \| null` | read-only The preset of a geometric shape; null for text boxes, lines and custom geometry. |
| `height` | `number` | |
| `horizontalFlip` | `boolean` | read-only VBA `Shape.HorizontalFlip`: `a:xfrm@flipH`. |
| `left` | `number` | |
| `name` | `string` | |
| `top` | `number` | |
| `type` | `ChartShapeType` | read-only |
| `verticalFlip` | `boolean` | read-only VBA `Shape.VerticalFlip`: `a:xfrm@flipV`. |
| `width` | `number` | |

### `ChartShape.delete()`

```ts theme={null}
delete(): void
```

### `ChartShape.flip()`

```ts theme={null}
flip(flipCmd: ShapeFlip): void
```

VBA `Shape.Flip`: mirrors the shape in its box; a second flip undoes the first.

## `ChartShapes`

Extension (VBA `Chart.Shapes`): the shapes drawn on a chart, in `c:userShapes`.

Import from `@reductoai/pptx/officejs`.

### ChartShapes properties

| Name | Type | Description |
| - | - | - |
| `count` | `number` | read-only |
| `items` | `ChartShape[]` | read-only |

### `ChartShapes.addGeometricShape()`

```ts theme={null}
addGeometricShape(type: GeometricShapeType, options?: ShapeAddOptions): ChartShape
```

VBA `Shapes.AddShape`.

### `ChartShapes.addLine()`

```ts theme={null}
addLine(options?: ShapeAddOptions): ChartShape
```

VBA `Shapes.AddLine`, as a straight connector over the box.

### `ChartShapes.addTextBox()`

```ts theme={null}
addTextBox(text: string, options?: ShapeAddOptions): ChartShape
```

VBA `Shapes.AddTextbox`; the box is in points from the chart's top-left corner.

### `ChartShapes.getItemAt()`

```ts theme={null}
getItemAt(index: number): ChartShape
```

## `GradientStop`

VBA `GradientStop`: colour, position (0–1) and transparency (0–1) of one stop.

Import from `@reductoai/pptx/officejs`.

### GradientStop properties

| Name | Type | Description |
| - | - | - |
| `color` | `string` | read-only |
| `position` | `number` | read-only |
| `transparency` | `number` | read-only |

## `HyperlinkScopedCollection`

`PowerPoint.HyperlinkScopedCollection`: the links of a text range.

Import from `@reductoai/pptx/officejs`.

### HyperlinkScopedCollection properties

| Name | Type | Description |
| - | - | - |
| `items` | `Hyperlink[]` | read-only |

### `HyperlinkScopedCollection.getCount()`

```ts theme={null}
getCount(): { value: number }
```

### `HyperlinkScopedCollection.getItemAt()`

```ts theme={null}
getItemAt(index: number): Hyperlink
```

## `ShapeScopedCollection`

`PowerPoint.ShapeScopedCollection`: a fixed set of shapes that share one parent.

Import from `@reductoai/pptx/officejs`.

### ShapeScopedCollection properties

| Name | Type | Description |
| - | - | - |
| `items` | `T[]` | read-only |

### `ShapeScopedCollection.getCount()`

```ts theme={null}
getCount(): ClientResult<number>
```

### `ShapeScopedCollection.getItem()`

```ts theme={null}
getItem(key: string): Shape
```

### `ShapeScopedCollection.getItemAt()`

```ts theme={null}
getItemAt(index: number): Shape
```

### `ShapeScopedCollection.getItemOrNullObject()`

```ts theme={null}
getItemOrNullObject(key: string): Shape & { isNullObject: boolean }
```

Office.js null-object variant; inspect `isNullObject` before other members.

### `ShapeScopedCollection.group()`

```ts theme={null}
group(): Shape
```

Groups the shapes of this collection; they must share one parent.
