SET TEXTMERGE (Comando)

Activa o desactiva la evaluación de campos, las variables, los elementos de matriz, las funciones o expresiones rodeadas por delimitadores de combinación de texto, y le permite especificar los resultados de la combinación de texto.

SET TEXTMERGE [ON | OFF] [TO [FileName] MEMVAR VarName [ADDITIVE]]
   [WINDOW WindowName] [SHOW | NOSHOW]

Parámetros

• ON
  Especifica que los campos, las variables, los elementos de matriz, y las funciones o expresiones rodeadas por los delimitadores de combinación de texto se evalúen y se generen cuando se colocan después de \ o \\, o entre TEXT y ENDTEXT.

  El corto programa de ejemplo siguiente demuestra cómo se evalúa el contenido de la variable gcTodayDate y de las funciones DATE( ) y TIME( ) cuando SET TEXTMERGE está en ON. La variable gcTodayDate, DATE( ) y TIME( ) se evalúan porque están encerrados entre delimitadores de combinación de texto y SET TEXTMERGE está definido en ON.

  CLEAR
  SET TALK OFF
  STORE 'Today is: ' TO gcTodayDate
  SET TEXTMERGE ON
  \<<gcTodayDate>>
  \\<<DATE( )>>
  \The time is:
  \\ <<TIME( )>>
  

  Este es el resultado del programa anterior cuando se ejecuta el 1 de enero:

  Today is: 01/01/98
  The time is: 10:55:19
  

• OFF
  (Predeterminado) Especifica que los campos, las variables, los elementos de matriz, y las funciones o expresiones se muestren literalmente junto con los delimitadores de texto que los rodean. Observe la diferencia del resultado cuando SET TEXTMERGE está en OFF con respecto al ejemplo anterior:

  CLEAR
  SET TALK OFF
  STORE 'Today is: ' TO gcTodayDate
  SET TEXTMERGE OFF
  \<<gcTodayDate>>
  \\<<DATE( )>>
  \The time is:
  \\ <<TIME( )>>
  

  Éste es el resultado del programa:

  <<gcTodayDate>><<DATE( )>>
  The time is: <<TIME( )>>
  

• TO [FileName]
  Especifica que el resultado de \, \\ y TEXT ... ENDTEXT se dirige a un archivo de texto además de enviarse a la ventana principal de Visual FoxPro, que es el destino predeterminado. También puede dirigir el resultado a un archivo de texto si incluye FileName. Si no existe ningún archivo con ese nombre, se creará un archivo nuevo. Si ya existe un archivo con ese mismo nombre y SET SAFETY está en ON, se le ofrecerá la opción de sobrescribir el archivo existente.

  El archivo de texto se abre como un archivo de bajo nivel y su controlador de archivo se almacena en la variable del sistema _TEXT. Puede cerrar el archivo ejecutando SET TEXTMERGE TO sin argumentos adicionales. Si el controlador de archivo u otro archivo se almacenó previamente en _TEXT, ese archivo se cerrará.

• MEMVAR VarName ****
  Especifica la variable en la que deben almacenarse los datos del resultado de TEXTMERGE.

  Como SET TEXTMERGE es un valor global y puede abarcar varios procedimientos y métodos, MEMVAR VarName puede perder alcance. Este comando funcionará incluso cuando la variable está fuera del alcance, pero no devolverá ningún contenido. Para controlar el alcance de MEMVAR VarName, puede declarar la variable como de tipo PUBLIC o PRIVATE.

  Esta cláusula también permite crear un comportamiento recursivo, que puede controlar con el comando SET TEXTMERGE TO, como en el siguiente ejemplo:

  USE LABELS
  STORE "" to myVar, myVar2
  
  SET TEXT ON NOSHOW
  SET TEXTMERGE TO MEMVAR myVar && TEXTMERGE begins on the next line
  
  \Hey Now
  \<<date()>>
  
  SCAN
     \  <<name>>
  ENDSCAN
  
  * Uncomment the following line to eliminate the recursive error with myVar and myVar2
  * SET TEXTMERGE TO
  
  TEXT TO myVar2
  <b> how about some html. </b>
  wow this is cool
     <<date()>>
  ENDTEXT
  
  SET TEXTMERGE OFF
  USE
  
  CLEAR
  ? myVar  && But has also stored the TEXTMERGE contents to variables
  ? myVar2 
  

• ADDITIVE
  Especifica que el resultado de \, \\ y TEXT ... ENDTEXT se anexará a un archivo o una variable de memoria existentes.

  Para obtener más información acerca de cómo dirigir el resultado de una combinación de texto a un archivo, vea _TEXT.

• WINDOW WindowName
  Especifica que el resultado de \, \\ y TEXT ... ENDTEXT se dirigirá a una ventana definida por el usuario, en lugar de a la ventana principal de Visual FoxPro, que es el lugar predeterminado. WindowName especifica el nombre de la ventana hacia la que desea dirigir el resultado. Es necesario haber creado la ventana con DEFINE WINDOW antes de enviar el resultado hacia ella. No es obligatorio que la ventana esté activa ni visible.

• SHOW | NOSHOW
  (Predeterminado) SHOW muestra el resultado de la combinación de texto.

  NOSHOW suprime la presentación del resultado de la combinación de texto.

  De forma predeterminada, el resultado generado por \, \\ y TEXT ... ENDTEXT se envía a la ventana principal de Visual FoxPro o a una ventana activa definida por el usuario.

Observaciones

Los comandos \, \\ y TEXT ... ENDTEXT se utilizan para combinar texto con el contenido de tablas, variables, elementos de matrices y los resultados de funciones y expresiones. Si un campo, una variable, un elemento de matriz, una función o una expresión están rodeados por delimitadores de combinación de texto (de forma predeterminada, << y >>) pueden evaluarse y combinarse con texto. Esta capacidad para combinar texto le permite producir cartas, programas y plantillas que creen programas.

SET TEXTMERGE determina la forma en que se evalúan los campos, las variables, los elementos de matriz, y las funciones o expresiones rodeadas por delimitadores de combinación de texto. También permite dirigir el resultado de combinación de texto hacia la ventana principal de Visual FoxPro, una ventana definida por el usuario o un archivo.

Los campos memo pueden utilizarse para anidar texto combinado. Si un campo memo contiene nombres de campos, variables, o funciones o expresiones rodeadas por los delimitadores de combinación de texto actuales, se evaluarán y mostrarán con el contenido del campo memo. El nombre del campo memo debe estar también entre delimitadores de combinación de texto.

Vea también

\ | \\ | _PRETEXT | SET TEXTMERGE DELIMITERS | TEXTMERGE( ) (Función) | _TEXT | TEXT ... ENDTEXT