VClipboard

Esta clase nos permite acceder al portapapeles tanto para leer su contenido como para escribir en él. Dispone de funciones básicas que permiten establecer contenido tipo texto e imágenes, y funciones más avanzadas que nos permiten gestionar múltiples tipos MIME con la clase VMimeData.

Estas funciones solamente pueden ser usada en Velneo vClient.

Funciones

Retorno	Función
void	clear()
void	image( VImage imgImagen )
VMimeData	mimeData()
VMimeData	newMimeData()
void	setImage( VImage imgImagen )
void	setMimeData( VMimeData mimeData )
void	setText( String szTexto )
String	text()

Documentación de funciones

void clear()

Limpia el portapapeles.

void image( VImage imgImagen )

Devuelve el contenido de imagen y lo guarda en el objeto imagen que pasamos como parámetro. Equivalente al tipo mime "image/*" siendo el asterisco el tipo de imagen.

No es funcional ni en Android ni en iOS.

VMimeData mimeData()

Devuelve un objeto de tipo VMimeData en modo sólo lectura, que permite acceder al contenido del portapapeles en curso. No podemos hacer uso de setMimeData con el objeto devuelto por esta función.

No es funcional ni en Android ni en iOS.

VMimeData newMimeData()

Crea un nuevo objeto de tipo VMimeData que permite incluir el contenido que se llevará al portapapeles.

No es funcional ni en Android ni en iOS.

void setImage( VImage imgImagen )

Establece en un objeto VImage la imagen como contenido del portapapeles. Equivalente al tipo mime "image/*" siendo el asterisco el tipo de imagen.

No es funcional ni en Android ni en iOS.

void setMimeData( VMimeData mimeData )

Permite establecer el contenido del objeto VMimeData que llevaremos al portapapeles para cada tipo Mime que indiquemos como parámetro, permitiendo múltiples mimetypes en el mismo contenido.

No es funcional ni en Android ni en iOS.

void setText( String szTexto )

Establece el contenido texto del portapapeles. Equivalente al tipo mime "text/plain".

String text()

Devuelve el contenido texto del portapapeles. Equivalente al tipo mime "text/plain".

Ejemplos

1. En un manejador de evento de un formulario de ficha, copiar el contenido del campo NAME en el portapapeles

//Creamos el objeto para poder acceder al portapapeles
var pp = theApp.clipboard();

//Movemos al portapapeles el contenido del campo NAME
pp.setText(theRegisterIn.fieldToString("NAME"));

2. En un manejador de evento de un formulario de ficha, asignar al campo NAME el copiar el contenido del portapapeles

//Creamos el objeto para poder acceder al portapapeles
var pp = theApp.clipboard();

//Modificamos el contenido del campo NAME con el texto guardado en el portapapeles
theRegisterIn.setField("NAME", pp.text());

//Forzamos el refresco de los controles del formulario
theRoot.dataView().updateControls();

3. En un manejador de evento de un formulario de ficha, copiar el contenido del un control objeto dibujo en el portapapeles

//Se importa la clase VImage para poder manejar imágenes en el script
importClass( "VImage" );

//Creamos el objeto para poder acceder al portapapeles
var pp = theApp.clipboard();

//Inicializamos un objeto de tipo imagen
var img = new VImage();

//Accedemos al control objeto dibujo y leemos la imagen que contiene
var edFoto = theRoot.dataView().control( "ED_FOTO" );
img = edFoto.image();

//Guardamos la imagen leída en el portapapeles
pp.setImage(img);

4. En un manejador de evento de un formulario de ficha, pegar en un control objeto dibujo la imagen contenida en el portapapeles

//Se importa la clase VImage para poder manejar imágenes en el script
importClass( "VImage" );

//Inicializamos un objeto de tipo imagen
var img = new VImage();

//Creamos el objeto para poder acceder al portapapeles
var pp = theApp.clipboard();

//Obtenemos el control objeto dibujo del formulario
var edFoto = theRoot.dataView().control( "ED_FOTO" );

//Leemos la imagen del portapapeles y la pegamos en el control objeto dibujo
pp.image(img);
edFoto.setImage(img);