FORM SCREENSHOT
FORM SCREENSHOT ( {{tabla ;} nomForm ;} imagForm {; pagNum} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| tabla | Table | → | Tabla del formulario |
| nomForm | Text | → | Nombre del formulario |
| imagForm | Picture | ← | Imagen del formulario en ejecución si el primer parámetro se omite, o Imagen del formulario en el editor de formularios si se pasa un nombre de formulario |
| pagNum | Integer | → | Número de página del formulario |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando FORM SCREENSHOT devuelve un formulario en forma de imagen. Este comando admite dos sintaxis diferentes: en función de la sintaxis utilizada, puede obtener la imagen de un formulario ejecutado, o la imagen del formulario en el editor de formularios.
- FORM SCREENSHOT ( imagF orm )
Esta sintaxis permite obtener una captura de pantalla de la página actual del formulario en ejecución o cargado vía el comando FORM LOAD: la imagen devuelta en el parámetro imagenForm contiene todos los objetos visibles del formulario con los valores actuales de los campos y de las variables del formulario, subformulario, etc. El formulario es devuelto en su totalidad, sin tener en cuenta el tamaño de la ventana que lo contiene.
Tenga en cuenta que esta sintaxis sólo funciona con formularios de entrada. - FORM SCREENSHOT ( {tabla ;} nomForm; imagForm{; pagNum} )
Esta sintaxis permite obtener una captura de pantalla de una "plantilla" de formulario como la que se muestra en el editor de formularios. Todos los objetos visibles se dibujan como en el editor, el comando tiene en cuenta los formularios heredados y los objetos ubicados en la página 0.
Si desea una captura de pantalla de un formulario tabla, pase la tabla del formulario en el parámetro tabla y luego su nombre como una cadena en nomForm. Para un formulario proyecto, pase directamente el nombre del formulario en nomForm.
Por defecto, el comando devuelve una captura de pantalla de la página 1 del formulario. Si sólo desea una imagen de la página 0, o de cualquier otra página del formulario, pase el número de página en el parámetro pagNum.
Notas:
- Las áreas web no se dibujan en la captura de pantalla devuelta.
- Los dos primeros parámetros de este comando son opcionales, no puede pasar directamente como un argumento una función que devuelva un puntero como Current form table-> o Table->. Aunque esta sintaxis funcionaría en modo interpretado, sería rechazada durante la compilación, así que es necesario en este caso utilizar una variable puntero intermediaria. Para obtener más información, consulte "Uso directo de los comandos que devuelven punteros".