4D Doc Center : Utilizar las áreas 4D Write

4D Write v14

Utilizar las áreas 4D Write

Hay tres tipos de áreas disponibles en 4D:

Áreas 4D Write incluídas en los formularios
Ventanas externas 4D Write
Áreas 4D Write fuera de la pantalla.

Para utilizar un documento 4D Write, puede crear un área de plug-in en un formulario o abrir una ventana externa. Puede crear un área externa, dibujando el área en un formulario en el entorno Diseño. Una ventana externa se abre, ya sea por la elección de 4D Write en el menú Herramientas o mediante la ejecución del comando Open external window.

Además de la creación de áreas visibles, puede crear áreas invisibles fuera de la pantalla. Para obtener más información, consulte el párrafo "Áreas Fuera de la pantalla 4D Write", más adelante en esta sección.

Número de Identificación y variable del área 4D Write

4D Write utiliza variables para almacenar la ubicación de las áreas 4D Write, ventanas externas y áreas fuera de la pantalla. Para referenciar el área en la que desea realizar una operación, debe pasar la variable que contiene el número de identificación del área como parámetro para el comando o la función.
En las descripciones de comandos de esta documentación, el parámetro area se refiere a la variable de identificación del área del documento.

Hay dos tipos de variables area:

Nombres de los objetos externos
Cuando crea y da nombre a un área 4D Write, 4D reconoce automáticamente el nombre del área 4D Write como una variable que hace referencia al área. Por ejemplo, usted se referiría al área Carta especificando "Carta", como parámetro area.
Las variables que usted crea para una ventana externa o un área fuera de la pantalla
Cuando crea una ventana externa o un área fuera de la pantalla utilizando las funciones Open external window o WR New offscreen area, puede guardar el número de ID de área devuelto por la función en una variable. A continuación, puede utilizar la variable para hacer referencia a la ventana externa o al área fuera de la pantalla en otros comandos y funciones. Para guardar el valor en 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..

La mayoría de comandos 4D Write requieren que se especifique un área antes de que puedan ejecutarse.

Áreas de plug-in 4D Write

Cuando desee que un documento 4D Write aparezca en un formulario 4D, debe crear un área plug-in en el formulario y asignarle un nombre único, especificando el tipo de plug-in como 4D Write.

4D permite guardar este documento con el registro.

Probablemente usted utiliza con más frecuencia el área del plug-in para almacenar un documento o para usarlo en lugar de un campo de texto si el formato es importante.

Ventanas externas 4D Write

4D le permite crear un documento 4D Write en un área independiente llamada una ventana externa. Las ventanas externas son útiles cuando desea que el usuario tenga acceso a un procesador de textos en cualquier momento para escribir cartas, memorandos y otros documentos.

Ejecutando la función 4D, Open external window, desde un método abre una ventana especificada y devuelve un ID de área en una variable entero largo. Puede hacer referencia a esta variable cada vez que desee ejecutar un comando 4D Write para afectar la ventana externa.

Por ejemplo:

vWrite:=Open external window(50;50;350;450;8;"Merge Letter";"_4D Write")

Para obtener más información sobre el comando Open external window, consulte a su definición en el Manual de lenguaje 4D.

Áreas 4D Write fuera de pantalla

Un área fuera de la pantalla se almacena en la memoria y no es visible para el programador o para el usuario. Puede utilizar un área fuera de la pantalla para modificar un documento antes de que un usuario lo vea o para guardar el documento para que el usuario pueda volver al original, si es necesario.

WR New offscreen area y WR PICTURE TO AREA son los dos comandos que se utilizan para crear un área fuera de la pantalla. Recuerde que debe eliminar el área fuera de la pantalla después de haberla terminado de utilizar para liberar la memoria que utiliza.

Cuando se pone en un método global, el siguiente código crea un área fuera de la pantalla para guardar el documento.

 QUERY([Empleados];[Empleados]ID=vID)

 If(Records in selection([Empleados]=1)

    Area:=WR New offscreen area

    WR PICTURE TO AREA(Area;[Empleados]Review_)

  `Guardar review en el área fuera de pantalla

    MODIFY RECORD([Empleados])

  `Modificar el registro empleados

    WR DELETE OFFSCREEN AREA(Area)

  `Liberar la memoria utilizada por el área fuera de pantalla

 End if

Utilizando un botón en un formulario, puede permitir al usuario volver al documento original guardado.

Puede crear un botón en el formulario de entrada y asignarle el siguiente código:

 Review:=WR Area to picture(Area)

  `Pone el área fuera de pantalla que contiene el documento original en el área externa

  `contenida en el formulario Review.