# VImageEdit

**Hereda de:** [VAbstractBrowser](https://doc.velneo.com/23/velneo-vdevelop/scripts/lenguajes/javascript/clases/vabstractbrowser).

Esta clase representa al control editor de imágenes.

## [Propiedades](#documentación-de-propiedades)

| Tipo    | Función               |
| ------- | --------------------- |
| Boolean | [modified](#modified) |
| Boolean | [readOnly](#readonly) |

## Funciones

**Generales**

| [VImage](https://doc.velneo.com/23/velneo-vdevelop/scripts/lenguajes/javascript/clases/vimage) | [image](#image)()                          |
| ---------------------------------------------------------------------------------------------- | ------------------------------------------ |
| void                                                                                           | [setImage](#setimage)( VImage image )      |
| void                                                                                           | [setViewMode](#setviewmode)( Number mode ) |
| Number                                                                                         | [viewMode](#viewmode)()                    |

**De portapapeles**

| Retorno | Función                 |
| ------- | ----------------------- |
| Boolean | [canPaste](#canpaste)() |
| void    | [copy](#copy)()         |
| void    | [cut](#cut)()           |
| void    | [paste](#paste)()       |

**De comandos**

| Retorno | Función                     |
| ------- | --------------------------- |
| void    | [editDialog](#editdialog)() |

**De cámara de fotos**

| Retorno | Función                                          |
| ------- | ------------------------------------------------ |
| Boolean | [isCameraActive](#iscameraactive)()              |
| void    | [startCamera](#startcamera)( String deviceName ) |
| void    | [startDefaultCamera](#startdefaultcamera)()      |
| void    | [stopCamera](#stopcamera)()                      |
| void    | [takePicture](#takepicture)()                    |

## Señales

| Señal         |
| ------------- |
| Value changed |

## Enumeraciones

**View modes**

* ViewModeOriginalCenter
* ViewModeStrechShrink
* ViewModeProportionalNotStrech
* ViewModeProportional
* ViewModeTile
* ViewModeOriginalLeftTop

## Documentación de propiedades

#### modified

Devuelve true si el contenido del control ha sido modificado.

#### readOnly

Permite leer o configurar si el control es de sólo lectura.

## Documentación de funciones

### Funciones generales

#### VImage image() <a href="#image" id="image"></a>

Crea un objeto de la clase [VImage](https://doc.velneo.com/23/velneo-vdevelop/scripts/lenguajes/javascript/clases/vimage) con la imagen contenida en el control.

#### void setImage( VImage image ) <a href="#setimage" id="setimage"></a>

Mueve la imagen del objeto de la clase VImagen al control.

Parámetros:

* image: objeto de la clase [VImage](https://doc.velneo.com/23/velneo-vdevelop/scripts/lenguajes/javascript/clases/vimage) que contiene la imagen a mover al control.

Si el control de edición del campo objeto dibujo (formulario) es de sólo lectura o no cumple la condición de la propiedad de activo, la imagen no se carga en el control. Debemos acceder al registro con la clase [VRegister](https://doc.velneo.com/23/velneo-vdevelop/scripts/lenguajes/javascript/clases/vregister) y usar la función setFieldImage() para introducirlo en el campo y actualizar la vista.

#### void setViewMode( Number mode ) <a href="#setviewmode" id="setviewmode"></a>

Asigna el valor de la propiedad aspecto de dibujo que aplicará el control. Ver enum de View modes.

Parámetros:

* mode: ver enum de View modes.

#### Number viewMode() <a href="#viewmode" id="viewmode"></a>

Devuelve el aspecto del dibujo aplicado en el control. Ver enum View modes.

### Funciones de portapapeles

#### Boolean canPaste() <a href="#canpaste" id="canpaste"></a>

Devuelve true si el control está activo y permite pegar una imagen a través del portapapeles.

#### void copy() <a href="#copy" id="copy"></a>

Copia la imagen del control al portapapeles.

#### void cut() <a href="#cut" id="cut"></a>

Corta la imagen del control y la mueve al portapapeles.

#### void paste() <a href="#paste" id="paste"></a>

Pega una imagen del portapapeles al control.

### Funciones de comandos

#### void editDialog() <a href="#editdialog" id="editdialog"></a>

Abre el cuadro de diálogo con el editor de imágenes de Velneo.

### Funciones de cámara de fotos

#### Boolean isCameraActive() <a href="#iscameraactive" id="iscameraactive"></a>

Devuelve true si el modo cámara está activo y false si está en modo normal.

Esta función ha sido incluida en la versión Velneo 7.17.

#### void startCamera( String deviceName ) <a href="#startcamera" id="startcamera"></a>

Arranca el modo cámara en el control con la cámara especificada en el parámetro.

En la clase [VApp](https://doc.velneo.com/23/velneo-vdevelop/scripts/lenguajes/javascript/clases/vapp) disponemos de la función availableCameras() para obtener un array de los dispositivos de cámara de fotos existentes en el sistema o defaultCamera() para obtener el nombre del dispositivo de cámara por defecto.

Parámetros:

* deviceName: nombre del dispositivo.

Esta función ha sido incluida en la versión Velneo 7.17.

#### void startDefaultCamera() <a href="#startdefaultcamera" id="startdefaultcamera"></a>

Arranca el modo cámara en el control con la cámara por defecto.

Esta función ha sido incluida en la versión Velneo 7.17.

#### void stopCamera() <a href="#stopcamera" id="stopcamera"></a>

Cierra el modo cámara sin hacer foto.

Esta función ha sido incluida en la versión Velneo 7.17.

#### void takePicture() <a href="#takepicture" id="takepicture"></a>

Hace una foto, cierra el modo cámara y deja la foto tomada en el campo y en el control imagen. Si aceptamos el formulario la foto queda guardada.

Esta función ha sido incluida en la versión Velneo 7.17.