# VImageEdit

**Hereda de:** [VAbstractBrowser](https://doc.velneo.com/22/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/22/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                                          |
| ------- | ------------------------------------------------ |
| Booelan | [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/22/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/22/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/22/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

#### Booelan 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/22/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 formluario la foto queda guardada.

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


---

# 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://doc.velneo.com/22/velneo-vdevelop/scripts/lenguajes/javascript/clases/vimageedit.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.
