# Image

<div align="left"><img src="/files/-MIxukResaLJym4SAi5T" alt=""></div>

| Property      | Function                                                                                                                                                                                   | Type     |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- |
| Current label | <p>Current label text<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Current label</code><br><strong>Code:</strong><br><code>widget.content.currentLabel</code></p> | `string` |
| Index         | <p>Current image index<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Index</code><br><strong>Code:</strong><br><code>widget.content.itemIndex</code></p>           | `int`    |

## Style

<div align="left"><img src="/files/-MIxukRhBzsDLpX_Evto" alt=""></div>

| Property    | Function                                                                                                                                                                                                                         | Type                                                                                                                 |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| Style       | <p>Sets gallery style to Slider, Book, Carousel or Magazine<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Style > Style</code><br><strong>Code:</strong><br><code>widget.content.galleryStyle</code></p> | `int`                                                                                                                |
| Orientation | <p>Sets gallery orientation to vertical or horizontal<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Style > Orientation</code><br><strong>Code:</strong><br><code>widget.content.orientation</code></p>  | <p><code>enum</code><br><br><strong>Values:</strong><br><code>Qt::Vertical</code><br><code>Qt::Horizontal</code></p> |
| Snap        | <p>Enable to scroll through one image at a time<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Style > Snap</code><br><strong>Code:</strong><br><code>widget.content.snapOneItem</code></p>               | `bool`                                                                                                               |
| Zoom        | <p>Disable to prevent image zooming<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Style > Zoom</code><br><strong>Code:</strong><br><code>widget.content.enableZoomImage</code></p>                       | `bool`                                                                                                               |
| Spacing     | <p>Spacing between images<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Style > Spacing</code><br><strong>Code:</strong><br><code>widget.content.listSpacing</code></p>                                  | `double`                                                                                                             |
| Carousel    | <p>Carousel effect strength<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Style > Carousel</code><br><strong>Code:</strong><br><code>widget.content.carousel</code></p>                                  | `int`                                                                                                                |
| Two images  | <p>Display two images simultaneously<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Style > Two images</code><br><strong>Code:</strong><br><code>widget.content.twoImagesBook</code></p>                  | `bool`                                                                                                               |
| Background  | <p>Background color<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Style > Background</code><br><strong>Code:</strong><br><code>widget.content.bookPageColor</code></p>                                   | `color`                                                                                                              |
| Shadow      | <p>Display page shadow<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Style > Shadow</code><br><strong>Code:</strong><br><code>widget.content.shadowEffect</code></p>                                     | `bool`                                                                                                               |

## Settings

<div align="left"><img src="/files/-MIxukRgSONFoUwpSdxB" alt=""></div>

| Property              | Function                                                                                                                                                                                                                            | Type                                                                                                                                                                                                                                                           |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Fill mode             | <p>Sets image fill mode<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Settings > Fill mode</code><br><strong>Code:</strong><br><code>widget.content.fillMode</code></p>                                     | <p><code>enum</code><br><br><strong>Values:</strong><br><code>Stretch</code><br><code>PreserveAspectFit</code><br><code>PreserveAspectCrop</code><br><code>Tile</code><br><code>TileVertically</code><br><code>TileHorizontally</code><br><code>Pad</code></p> |
| Radius                | <p>Sets image radius<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Settings > Radius</code><br><strong>Code:</strong><br><code>widget.content.radius</code></p>                                             | `double`                                                                                                                                                                                                                                                       |
| Album                 | <p>Disable to prevent switching into album view<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Settings > Album</code><br><strong>Code:</strong><br><code>widget.content.enableGridView</code></p>           | `bool`                                                                                                                                                                                                                                                         |
| Album on start        | <p>Enable to launch the gallery show with an album<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Settings > Album on start</code><br><strong>Code:</strong><br><code>widget.content.albumOnStart</code></p> | `bool`                                                                                                                                                                                                                                                         |
| Thumbnails            | <p>Determines when to display thumbnails<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Settings > Thumbnails</code><br><strong>Code:</strong><br><code>widget.content.iconsMode</code></p>                  | `int`                                                                                                                                                                                                                                                          |
| Thumbnails background | <p>Display thumbnails background<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Settings > Thumbnails background</code><br><strong>Code:</strong><br><code>widget.content.showIconsBg</code></p>             | `bool`                                                                                                                                                                                                                                                         |
| Buttons               | <p>Display navigation buttons<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Settings > Buttons</code><br><strong>Code:</strong><br><code>widget.content.showControls</code></p>                             | `bool`                                                                                                                                                                                                                                                         |

## Labels

<div align="left"><img src="/files/-MIxukRf4B-6npJ3dFXh" alt=""></div>

| Property          | Function                                                                                                                                                                                                             | Type                                                                                                                                                   |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Labels            | <p>Display labels<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Labels > Labels</code><br><strong>Code:</strong><br><code>widget.content.showLabels</code></p>                               | `bool`                                                                                                                                                 |
| Labels position   | <p>Label vertical alignment<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Labels > Labels position</code><br><strong>Code:</strong><br><code>widget.content.verticalAlignment</code></p>     | <p><code>enum</code><br><br><strong>Values:</strong><br><code>Qt::AlignBottom</code><br><code>Qt::AlignTop</code><br><code>Qt::AlignVCenter</code></p> |
| Labels background | <p>Label background color<br><br><strong>Actions editor:</strong><br><code>Property > Gallery > Labels > Labels background</code><br><strong>Code:</strong><br><code>widget.content.labelsBackgroundColor</code></p> | `color`                                                                                                                                                |

## Actions

| Property     | Function                                                                                                                                                                                                    |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Next         | <p>Open next image<br><br><strong>Actions editor:</strong><br><code>Actions > Common > Next</code><br><strong>Code:</strong><br><code>widget.content.script.actionListForward()</code></p>                  |
| Previous     | <p>Open previous image<br><br><strong>Actions editor:</strong><br><code>Actions > Common > Previous</code><br><strong>Code:</strong><br><code>widget.content.script.actionListBackward()</code></p>         |
| Item index   | <p>Open image by index<br><br><strong>Actions editor:</strong><br><code>Actions > Common > Item index</code><br><strong>Code:</strong><br><code>widget.content.script.actionItemIndex(int index)</code></p> |
| Show album   | <p><strong>Actions editor:</strong><br><code>Actions > Common > Show album</code><br><strong>Code:</strong><br><code>widget.content.script.actionShowAlbum()</code></p>                                     |
| Set image    | <p><strong>Actions editor:</strong><br><code>Actions > Common > Set image</code><br><strong>Code:</strong><br><code>widget.content.script.actionSetImage(QString image)</code></p>                          |
| Add image    | <p><strong>Actions editor:</strong><br><code>Actions > Common > Add image</code><br><strong>Code:</strong><br><code>widget.content.script.actionAddImage(QString image)</code></p>                          |
| Clear images | <p><strong>Actions editor:</strong><br><code>Actions > Common > Clear images</code><br><strong>Code:</strong><br><code>widget.content.script.actionClearImages()</code></p>                                 |

## Events

| Property   | Function                                                                                                                                                                                                 |
| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Next       | <p>Event when next image is displayed<br><br><strong>Actions editor:</strong><br><code>Event > Next</code><br><strong>Code:</strong><br><code>widget.content.script.eventListedForward()</code></p>      |
| Previous   | <p>Event when prev image is displayed<br><br><strong>Actions editor:</strong><br><code>Event > Previous</code><br><strong>Code:</strong><br><code>widget.content.script.eventListedBackward()</code></p> |
| Item index | <p>Event when current image is changed<br><br><strong>Actions editor:</strong><br><code>Event > Item index</code><br><strong>Code:</strong><br><code>widget.content.script.eventItemIndex()</code></p>   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flipabit.dev/api/widget/image.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
