Class

# DBKit.ImageViewer

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

## Description

Displays and edits the image stored in a column of the current row of the database table to which it has been assigned.

Only the members declared by <span class="title-ref">DBKit.ImageViewer</span> itself are described here; for the inherited members, see `the parent classes<dbkit.imageviewer.seealso>`.

## Properties

<div class="rst-class">

table-centered_columns_3_and_4

</div>

| Name                                                           | Type                                                       | Read-Only | Shared |
|----------------------------------------------------------------|------------------------------------------------------------|-----------|--------|
| `ColumnName<dbkit.imageviewer.columnname>`                     | `String</api/data_types/string>`                           |           |        |
| `CopyMenuItemCaption<dbkit.imageviewer.copymenuitemcaption>`   | `String</api/data_types/string>`                           |           |        |
| `CutMenuItemCaption<dbkit.imageviewer.cutmenuitemcaption>`     | `String</api/data_types/string>`                           |           |        |
| `DisplayName<dbkit.imageviewer.displayname>`                   | `String</api/data_types/string>`                           |           |        |
| `Editable<dbkit.imageviewer.editable>`                         | `Boolean</api/data_types/boolean>`                         |           |        |
| `Image<dbkit.imageviewer.image>`                               | `Picture</api/graphics/picture>`                           |           |        |
| `ImageFormat<dbkit.imageviewer.imageformat>`                   | `ImageFormats<dbkit.imageviewer.imageformats>`             |           |        |
| `ImageQuality<dbkit.imageviewer.imagequality>`                 | `ImageQualityLevels<dbkit.imageviewer.imagequalitylevels>` |           |        |
| `InvalidValueMessage<dbkit.imageviewer.invalidvaluemessage>`   | `String</api/data_types/string>`                           |           |        |
| `Mandatory<dbkit.imageviewer.mandatory>`                       | `Boolean</api/data_types/boolean>`                         |           |        |
| `PasteMenuItemCaption<dbkit.imageviewer.pastemenuitemcaption>` | `String</api/data_types/string>`                           |           |        |

## Methods

<div class="rst-class">

table-centered_column_4

</div>

| Name                                                             | Parameters                                                                                                  | Returns                                                    | Shared |
|------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------|------------------------------------------------------------|--------|
| `Clear<dbkit.imageviewer.clear-method>`                          |                                                                                                             |                                                            |        |
| `Copy<dbkit.imageviewer.copy-method>`                            |                                                                                                             |                                                            |        |
| `Cut<dbkit.imageviewer.cut-method>`                              |                                                                                                             |                                                            |        |
| `ImageFormatForColumn<dbkit.imageviewer.imageformatforcolumn>`   | Parent As `Object</api/data_types/additional_types/object>`, columnName As `String</api/data_types/string>` | `ImageFormats<dbkit.imageviewer.imageformats>`             | ✓      |
| `ImageQualityForColumn<dbkit.imageviewer.imagequalityforcolumn>` | Parent As `Object</api/data_types/additional_types/object>`, columnName As `String</api/data_types/string>` | `ImageQualityLevels<dbkit.imageviewer.imagequalitylevels>` | ✓      |
| `Paste<dbkit.imageviewer.paste-method>`                          |                                                                                                             |                                                            |        |
| `PictureFormat<dbkit.imageviewer.pictureformat>`                 |                                                                                                             | `Picture.Formats<picture.formats>`                         |        |
| `PictureQuality<dbkit.imageviewer.picturequality>`               |                                                                                                             | `Integer</api/data_types/integer>`                         |        |
| `TableName<dbkit.imageviewer.tablename>`                         |                                                                                                             | `String</api/data_types/string>`                           |        |

## Events

<div class="rst-class">

table-centered_column_4

</div>

| Name                                               | Parameters                                   | Returns |
|----------------------------------------------------|----------------------------------------------|---------|
| `RowChanged<dbkit.imageviewer.rowchanged>`         | row As `DBKit.Row</api/databases/dbkit/row>` |         |
| `RowCreated<dbkit.imageviewer.rowcreated>`         | row As `DBKit.Row</api/databases/dbkit/row>` |         |
| `RowDeleted<dbkit.imageviewer.rowdeleted>`         | row As `DBKit.Row</api/databases/dbkit/row>` |         |
| `RowEditing<dbkit.imageviewer.rowediting>`         | row As `DBKit.Row</api/databases/dbkit/row>` |         |
| `RowLoaded<dbkit.imageviewer.rowloaded>`           | row As `DBKit.Row</api/databases/dbkit/row>` |         |
| `RowNotSelected<dbkit.imageviewer.rownotselected>` |                                              |         |
| `RowSaved<dbkit.imageviewer.rowsaved>`             | row As `DBKit.Row</api/databases/dbkit/row>` |         |
| `RowSaving<dbkit.imageviewer.rowsaving>`           | row As `DBKit.Row</api/databases/dbkit/row>` |         |
| `RowUndone<dbkit.imageviewer.rowundone>`           | row As `DBKit.Row</api/databases/dbkit/row>` |         |

## Enumerations

<div id="dbkit.imageviewer.imageformats">

<div class="rst-class">

forsearch

</div>

</div>

DBKit.ImageViewer.ImageFormats

### ImageFormats

> Specifies the format used when saving the image.
>
> | Formats |
> |---------|
> | BMP     |
> | GIF     |
> | JPEG    |
> | PNG     |
> | TIFF    |

<div id="dbkit.imageviewer.imagequalitylevels">

<div class="rst-class">

forsearch

</div>

</div>

DBKit.ImageViewer.ImageQualityLevels

### ImageQualityLevels

> Specifies the quality level used when saving the image.
>
> | Levels  |
> |---------|
> | Default |
> | Maximum |
> | High    |
> | Medium  |
> | Low     |
> | Minimum |

## Property descriptions

<div id="dbkit.imageviewer.columnname">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.ColumnName

**ColumnName** As `String</api/data_types/string>`

> The name of the database column whose value this control displays and edits.
>
> If blank, the control's name is used as the column name. The name may be qualified with a table name (for example "tablename.columnname") when the control shows a column from a related table.
>
> <div class="tip">
>
> <div class="title">
>
> Tip
>
> </div>
>
> Instead of setting this property, you can name the control the same as the database column. DBKit first looks at the ColumnName property; if it is blank, it then uses the name of the control itself.
>
> </div>

<div id="dbkit.imageviewer.copymenuitemcaption">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.CopyMenuItemCaption

**CopyMenuItemCaption** As `String</api/data_types/string>`

> The caption of the Copy item in the control's contextual menu.
>
> The default is "Copy".

<div id="dbkit.imageviewer.cutmenuitemcaption">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.CutMenuItemCaption

**CutMenuItemCaption** As `String</api/data_types/string>`

> The caption of the Cut item in the control's contextual menu.
>
> The default is "Cut".

<div id="dbkit.imageviewer.displayname">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.DisplayName

**DisplayName** As `String</api/data_types/string>`

> A user-friendly name for the control, shown to the user in place of the column name (for example in the `InvalidValueMessage<dbkit.imageviewer.invalidvaluemessage>`).
>
> If blank, the column name is de-camelcased automatically (for example "FirstName" becomes "First Name").

<div id="dbkit.imageviewer.editable">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.Editable

**Editable** As `Boolean</api/data_types/boolean>`

> If `True</api/language/true>`, the user can change the image displayed by the control, for example by dragging and dropping an image onto it.

<div id="dbkit.imageviewer.image">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.Image

**Image** As `Picture</api/graphics/picture>`

> The image displayed by the control.

<div id="dbkit.imageviewer.imageformat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.ImageFormat

**ImageFormat** As `ImageFormats<dbkit.imageviewer.imageformats>`

> The format used when saving the image.
>
> The default is BMP.

<div id="dbkit.imageviewer.imagequality">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.ImageQuality

**ImageQuality** As `ImageQualityLevels<dbkit.imageviewer.imagequalitylevels>`

> The quality level used when saving the image.
>
> The default is Default.

<div id="dbkit.imageviewer.invalidvaluemessage">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.InvalidValueMessage

**InvalidValueMessage** As `String</api/data_types/string>`

> The message displayed when the control is mandatory but has no image. Use \<\$1\> as a placeholder for the control's display name.
>
> The default is "\<\$1\> must have an image."

<div id="dbkit.imageviewer.mandatory">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.Mandatory

**Mandatory** As `Boolean</api/data_types/boolean>`

> If `True</api/language/true>`, the control must contain an image before the row can be saved. When a row with an empty mandatory control is saved, the `InvalidValueMessage<dbkit.imageviewer.invalidvaluemessage>` is displayed and the save is cancelled.
>
> The default is `False</api/language/false>`.

<div id="dbkit.imageviewer.pastemenuitemcaption">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.PasteMenuItemCaption

**PasteMenuItemCaption** As `String</api/data_types/string>`

> The caption of the Paste item in the control's contextual menu.
>
> The default is "Paste".

## Method descriptions

<div id="dbkit.imageviewer.clear-method">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.Clear

**Clear**()

> Clears the image displayed by the control.
>
> This method is only supported while the row is being edited by the user.

<div id="dbkit.imageviewer.copy-method">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.Copy

**Copy**()

> Copies the image to the clipboard.

<div id="dbkit.imageviewer.cut-method">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.Cut

**Cut**()

> Copies the image to the clipboard and clears it.
>
> This method is only supported while the row is being edited by the user.

<div id="dbkit.imageviewer.imageformatforcolumn">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.ImageFormatForColumn

**ImageFormatForColumn**(Parent As `Object</api/data_types/additional_types/object>`, columnName As `String</api/data_types/string>`) As `ImageFormats<dbkit.imageviewer.imageformats>`

> Returns the `ImageFormat<dbkit.imageviewer.imageformat>` of the <span class="title-ref">DBKit.ImageViewer</span> on *Parent* (a `DesktopWindow</api/user_interface/desktop/desktopwindow>` or `DesktopContainer</api/user_interface/desktop/desktopcontainer>`) whose `ColumnName<dbkit.imageviewer.columnname>` matches *columnName*.
>
> <div class="important">
>
> <div class="title">
>
> Important
>
> </div>
>
> This method is only available in desktop projects.
>
> </div>

<div id="dbkit.imageviewer.imagequalityforcolumn">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.ImageQualityForColumn

**ImageQualityForColumn**(Parent As `Object</api/data_types/additional_types/object>`, columnName As `String</api/data_types/string>`) As `ImageQualityLevels<dbkit.imageviewer.imagequalitylevels>`

> Returns the `ImageQuality<dbkit.imageviewer.imagequality>` of the <span class="title-ref">DBKit.ImageViewer</span> on *Parent* (a `DesktopWindow</api/user_interface/desktop/desktopwindow>` or `DesktopContainer</api/user_interface/desktop/desktopcontainer>`) whose `ColumnName<dbkit.imageviewer.columnname>` matches *columnName*.
>
> <div class="important">
>
> <div class="title">
>
> Important
>
> </div>
>
> This method is only available in desktop projects.
>
> </div>

<div id="dbkit.imageviewer.paste-method">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.Paste

**Paste**()

> Pastes the image from the clipboard.
>
> This method is only supported while the row is being edited by the user.

<div id="dbkit.imageviewer.pictureformat">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.PictureFormat

**PictureFormat**() As `Picture.Formats<picture.formats>`

> Returns the `Picture.Formats<picture.formats>` value corresponding to the control's `ImageFormat<dbkit.imageviewer.imageformat>`.

<div id="dbkit.imageviewer.picturequality">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.PictureQuality

**PictureQuality**() As `Integer</api/data_types/integer>`

> Returns the picture quality constant (such as Picture.QualityDefault) corresponding to the control's `ImageQuality<dbkit.imageviewer.imagequality>`.

<div id="dbkit.imageviewer.tablename">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.TableName

**TableName**() As `String</api/data_types/string>`

> Returns the name of the database table for this control: the table name of the control's layout.

## Event descriptions

<div id="dbkit.imageviewer.rowchanged">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.RowChanged

**RowChanged**(row As `DBKit.Row</api/databases/dbkit/row>`)

> The current row (passed to the event) has been changed.

<div id="dbkit.imageviewer.rowcreated">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.RowCreated

**RowCreated**(row As `DBKit.Row</api/databases/dbkit/row>`)

> A new row (passed to the event) was just created and is now the current row.

<div id="dbkit.imageviewer.rowdeleted">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.RowDeleted

**RowDeleted**(row As `DBKit.Row</api/databases/dbkit/row>`)

> The current row (passed to the event) has been deleted.

<div id="dbkit.imageviewer.rowediting">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.RowEditing

**RowEditing**(row As `DBKit.Row</api/databases/dbkit/row>`)

> The current row (passed to the event) is being edited by the user.

<div id="dbkit.imageviewer.rowloaded">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.RowLoaded

**RowLoaded**(row As `DBKit.Row</api/databases/dbkit/row>`)

> The current row (passed to the event) has been loaded.

<div id="dbkit.imageviewer.rownotselected">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.RowNotSelected

**RowNotSelected**

> There is no row currently selected.

<div id="dbkit.imageviewer.rowsaved">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.RowSaved

**RowSaved**(row As `DBKit.Row</api/databases/dbkit/row>`)

> The current row (passed to the event) has been saved.

<div id="dbkit.imageviewer.rowsaving">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.RowSaving

**RowSaving**(row As `DBKit.Row</api/databases/dbkit/row>`)

> The current row (passed to this event) is about to be saved.

<div id="dbkit.imageviewer.rowundone">

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

</div>

<div class="rst-class">

forsearch

</div>

DBKit.ImageViewer.RowUndone

**RowUndone**(row As `DBKit.Row</api/databases/dbkit/row>`)

> The changes made to the current row (passed to this event) have been undone.

## Notes

#### Choosing an image by clicking in web projects

In web projects, when `Editable<dbkit.imageviewer.editable>` is True, clicking the control opens a file dialog so the user can choose an image to upload. Editable is True while the row is being edited.

#### Localization

Localize the control's user-facing text (`InvalidValueMessage<dbkit.imageviewer.invalidvaluemessage>`) the standard Xojo way: assign a dynamic constant to each property and provide translations for as many languages as you need, or localize the property values directly.

## Compatibility

|                       |              |
|-----------------------|--------------|
| **Project Types**     | Desktop, Web |
| **Operating Systems** | All          |

<div id="dbkit.imageviewer.seealso">

<div class="seealso">

`DesktopImageViewer</api/user_interface/desktop/desktopimageviewer>` (desktop) and `WebImageViewer</api/user_interface/web/webimageviewer>` (web) parent classes; `DBKit.Row</api/databases/dbkit/row>` class.

</div>

</div>