4D View v14

Utilizar las áreas 4D View

Inicio

 
4D View v14
Utilizar las áreas 4D View

Utilizar las áreas 4D View  


 

 

Puede trabajar por programación con 4D View en los siguientes entornos:

  • Áreas 4D View incluidas en los formularios
  • Ventanas externas 4D View
  • Áreas 4D View fuera de la pantalla

Para trabajar en un documento 4D View, debe crear un área de plug-in en un formulario o abrir una ventana externa.

Para crear un área de plug-in en un formulario, dibújela en el editor de formularios de 4D en el entorno Diseño.

Para abrir una ventana externa, elija el comando 4D View en el menú Herramientas de 4D o ejecute el comando 4D Open external window.

Además de las áreas visibles, 4D View permite la creación de áreas fuera de la pantalla, es decir, áreas invisibles. Para más información, consulte la sección "Áreas fuera de la pantalla de 4D View".

Una vez modificado un documento 4D View mediante rutinas, es necesario especificar su identificación de área. Esta identificación es interna a 4D View y generalmente se encuentra en una variable.

4D View utiliza variables para guardar la ubicación de las áreas incluidas, las ventanas externas y las áreas fuera de la pantalla. Para hacer referencia al área donde se quiere ejecutar una operación, pase la variable que contiene la identificación de área como parámetro para el comando o la función.

En las descripciones de los comandos de esta documentación, la variable de tipo Entero largo que identifica el área  del documento View 4D se llama area.

Hay dos tipos de variables area:

  • Los nombres de las áreas incluidas
  • Las variables creadas por una ventana externa o en un área fuera de la pantalla

Una vez crea y nombra un área 4D View en un formulario, 4D considera que el nombre del área 4D View es la variable de referencia de área. Por ejemplo, usted referenciaría el área "Hoja" especificando "Hoja" como parámetro area.

Una vez creada una ventana externa o un área fuera de la pantalla con la ayuda de las funciones Open external window o PV New offscreen area, el número de identificación del área devuelta por la función debe estar guardado en una variable. Puede utilizar esta variable después para hacer referencia a la ventana externa o al área fuera de la pantalla en otros comandos y funciones. Para guardar el valor de una variable, ubique el nombre de la variable y el operador de asignación (: =) a la izquierda de la función en la línea de código.

El siguiente ejemplo crea una ventana externa 4D View y guarda el número de identificación del área en la variable MiArea:

 MiArea:=Open external window(30;30;350;450;8;"Sheet";"_4D View")

Un área 4D View puede ubicarse en todo formulario: con más frecuencia, se coloca en un formulario de entrada para trabajar con documentos, pero también en formularios de salida para mostrar o imprimir la información.
4D View utiliza todo el formulario o comparte espacio con los campos y otros elementos del formulario.

Debe utilizar un área de objeto activo del tipo "Área de plug-in" con 4D View. Un área de plug-in de la zona es uno de los varios tipos de objetos activos en 4D (otros ejemplos incluyen botones, áreas de entrada, áreas de desplazamiento, etc.)

También puede asociar el área de plug-in a un campo 4D para que los contenidos del área se guarden cada vez que se grabe. Atención, si no utiliza los botones automáticos de tipo Validar, sino el comando SAVE RECORD, primero deberá ejecutar PV Area to blob para transferir el contenido del área 4D View al campo 4D ya que el mecanismo de guardado automático no está activo.

Para más información sobre la creación de áreas 4D View en los formularios, consulte el manual de uso 4D View.

Utilice la función Open external window de 4D para abrir una ventana externa y mostrar un documento 4D View en blanco.

Open external window abre una nueva ventana, muestra el plug-in especificado y devuelve un número de identificación para el área.

A continuación se muestra un ejemplo de cómo utilizar Open external window. Esta instrucción abre una ventana externa y muestra un documento 4D View vacío.

 PvRefArea:=Open external window(50;50;350;450;8;"Spreadsheet";"_4D View")

Use PvRefArea cada vez que necesite hacer referencia a este documento. Para una descripción completa del comando Open external window, consulte el manual Lenguaje 4D.

Un área fuera de la pantalla se guarda en la memoria: es invisible para el programador y el usuario. Suele ser útil en dos casos: para modificar un documento antes de que el usuario lo vea, o para guardar el documento para que el usuario puede volver a la original, si es necesario.

Las operaciones de 4D View funcionan más rápido en un área fuera de la pantalla ya que no es necesario dibujar el área.

Utilice la función PV New offscreen area para crear un área fuera de la pantalla.

No olvide eliminar el área fuera de la pantalla después de usarla para liberar la memoria utilizada utilizando la rutina PV DELETE OFFSCREEN AREA. Si cierra la base sin haber eliminado todas las áreas fuera de la pantalla, 4D muestra un mensaje de error.

 
PROPIEDADES 

Producto: 4D View
Tema: Introducción

 
ARTICLE USAGE

4D View - Lenguaje ( 4D View v11.4)
4D View - Lenguaje ( 4D View v12)
4D View - Lenguaje ( 4D v13)
4D View - Lenguaje ( 4D View v14 R2)
4D View - Lenguaje ( 4D View v14)
4D View - Lenguaje ( 4D View v14 R3)
4D View - Lenguaje ( 4D View v14 R4)