| Note | 该命令在头文件中定义，将由 X# 预处理器预处理为函数调用。如果禁用标准头文件 (-nostddefs)，该命令将不可用。如果告诉编译器使用不同的标准头文件（-stddef ），则此命令也可能不可用。 |
用途
启用或禁用对文本合并分隔符包围的字段、变量、数组元素、函数或表达式的评估，并可指定文本合并输出。
语法
SET TEXTMERGE [ON | OFF] [TO [FileName] MEMVAR VarName [ADDITIVE]]
[WINDOW WindowName] [SHOW | NOSHOW]
参数
| ON | 指定由文本合并分隔符包围的任何字段、变量、数组元素、函数或表达式在放在 \ 或 \\ 之后，或 TEXT 和 ENDTEXT 之间时，都要进行评估和输出。 |
| OFF | (默认)指定将任何字段、变量、数组元素、函数或表达式连同它们周围的文本合并分隔符一起按字面意思输出。 |
| TO [ FileName] | 指定 \ 、\\ 和 TEXT ... ENDTEXT 的输出除了直接输出到 Visual FoxPro 主窗口外，还直接输出到文本文件。您也可以通过包含 FileName 将输出指向文本文件。如果不存在同名文件，则会创建一个新文件。如果同名文件已经存在，且 SET SAFETY 设置为 ON，则可以选择覆盖现有文件。 |
| 文本文件作为低级文件打开，其文件句柄存储在 _TEXT 系统变量中。关闭文件时，只需发出 SET TEXTMERGE TO，无需其他参数。如果 _TEXT 中先前存储了另一个文件的文件句柄，则该文件将被关闭。 |
| MEMVAR VarName | 指定包含 TEXTMERGE 输出数据的变量。 |
| 由于 SET TEXTMERGE 是一个全局设置，可以跨越多个过程或方法，因此 MEMVAR VarName 有可能失去作用域。即使变量不在作用域内，命令也能运行，但不会返回任何内容。您可以通过声明变量来控制 MEMVAR VarName 的作用域。 |
| ADDITIVE | 指定将 \ 、\\ 和 TEXT ... ENDTEXT 的输出附加到现有文件或内存变量中。 |
| SHOW | NOSHOW | (默认） SHOW 显示文本合并输出。NOSHOW 则不显示文本合并输出。默认情况下，由 \ 、\\ 和 TEXT ... ENDTEXT 生成的输出将发送到控制台窗口。 |
描述
指定任何字段、变量、数组元素、函数或由文本合并分隔符包围的表达式在置于 \ 或 \\ 之后，或 TEXT 和 ENDTEXT 之间时，都要进行评估和输出。
下面的简短程序示例演示了当 SET TEXTMERGE 设置为 ON 时，如何评估变量 gcTodayDate 的内容以及 DATE( ) 和 TIME( ) 函数。
示例
CLEAR
CLOSE DATABASES
SET TEXTMERGE ON
SET TEXTMERGE TO ContactList.TXT
USE customer
TEXT
CONTACT NAMES
<<DATE( )>> <<TIME( )>>
ENDTEXT
WAIT "按任意键生成前十个名称。"
SCAN NEXT 10
TEXT
<<contact>>
ENDTEXT
ENDSCAN
CLOSE ALL
程序集
XSharp.VFP.DLL
