# VImageWidget

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

Esta clase representa al control dibujo estático.

## Indice de funciones

### **Funciones generales**

void [setImage](#void-setimage-string-urlimagen-vimage-loadingimage)( String urlImagen, VImage loadingImage )

void [setViewMode](#setviewmode)( Number mode )

Number [viewMode](#viewmode)()

## Enumeraciones

**View modes**

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

## Documentación de funciones

### Funciones generales

#### void setImage( String urlImagen, VImage loadingImage )

Asigna a un control de formulario de tipo [dibujo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario/controles-de-visualizacion/dibujo-control) una imagen externa.

Parámetros:

* urlImagen: especificaremos la URL del dibujo que queremos mostrar en el control. Puede tratarse tanto de una senda de disco como de una url.
* loadingImage: este parámetro es opcional. Permite mostrar en el control un objeto [VImage](https://doc.velneo.com/velneo-vdevelop/scripts/lenguajes/javascript/clases/vimage) temporal mientras se carga la imagen especificada en el otro parámetro. 

#### 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.

## Ejemplo

### Cambiar el modo de visualización de un dibujo estático en un formulario

```javascript
//Obtenemos el formulario
var formulario = theRoot.dataView();

//Obtenemos el control
var control = formulario.control("DIB");

//Cambiamos el modo de visualización a mosáico
control.setViewMode(VImageWidget.ViewModeTile);
```

### Cargar una imagen externa en un control de tipo dibujo de un formulario

```javascript
importClass("VImage");

// Preparar variables de trabajo
var senda   = "https://velneo.es/imagen.svg";

//Obtenemos el control de tipo Dibujo del formulario
var ctrlDib = theRoot.dataView().control("DIB_JS");

//Añadimos la imagen externa al control
ctrlDib.setImage(senda);
```