S E T T E X T M E R G E 命 令

指定是否对文本合并分隔符括起的字段 变量 数组元素 函数或表达式进行计算并允许指定文本合并输出

语 法

SET TEXTMERGE [ON | OFF]

[TO [ FileNam e] [ADDITIVE]]

[ W INDOW W indowNam e ] [SHOW | NOSHOW]

参 数 描 述

O N

指定对文本合并分隔符括起的字段 变量 数组元素 函数或表达式进行计算 而且当它们放在 \ 或 \\ 之后或 TEXT 和 ENDTEXT 之间时将其输出

下面的程序示例演示了当 SET TEXTMERGE 设置为 ON 时 gcTodayDate 变量的内

容和 DATE ( ) 及 TIME( ) 函数是如何计算的 之所以计算 gcTodayDate 变量DATE( ) 及 TIME( ) 函数 是因为它们用文本合并分隔符分隔了 并且 SET TEXTMERGE 设置为 ON

CLEAR

SET TALK OFF

STORE 'Today is: ' TO gcTodayDate SET TEXTMERGE ON

\<<gcTodayDate>>

\\<<DATE( )>>

\The time is:

\\ <<TIME( )>>

下面是在一月一日运行时 该程序的结果

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

OFF

默 认 值 指 定 对 文 本 合 并 分 隔 符 括 起 的 字 段 变 量 数 组 元 素 函 数 或 表达 式 同 括 起 它 们 的 文 本 合 并 分 隔 符 一 起 不 作 变 化 地 输 出

CLEAR

SET TALK OFF

STORE 'Today is: ' TO gcTodayDate SET TEXTMERGE OFF

\<<gcTodayDate>>

\\<<DATE( )>>

\The time is:

\\ <<TIME( )>>

下 面 是 程 序 输 出

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

TO [ FileNam e]

指 定 \ \\ 和 TEXT ... ENDTEXT 产 生 的 结 果 不 输 出 到 默 认 的 Visual FoxPro 主 窗 口 中 而 是 直 接 输 出 到 文 本 文 件 中 可 以 指 定 FileName 把 结 果 输 出 到某 一 文 本 文 件 中 如 果 指 定 的 文 件 不 存 在 则 创 建 新 文 件 如 果 指 定 的 文 件已 经 存 在 且 SET SAFETY 设 置 为 O N 时 可 以 选 择 改 写 已 有 文 件

以 低 级 方 式 打 开 文 本 文 件 文 件 句 柄 保 存 在 _TEXT 系 统 变 量 中 可 以 用 不带 参 数 的 SET TEXTMERGE TO 命 令 来 关 闭 该 文 件 如 果 另 一 个 文 件 的 句柄 先 前 已 保 存 在 _TEXT 中 则 关 闭 此 文 件

ADDITIVE

指 定 \ \\ 和 TEXT ... ENDTEXT 产 生 的 输 出 追 加 在 已 有 文 件 的 后 面有 关 将 文 本 合 并 输 出 到 文 件 的 详 细 内 容 请 参 阅 _TEXT 系 统 变 量

W INDOW W indowName

指 定 \ \\ 和 TEXT ... ENDTEXT 产 生 的 结 果 不 输 出 到 默 认 的 Visual FoxPro 主 窗 口 中 而 是 直 接 输 出 到 用 户 自 定 义 窗 口 中 WindowName 指 定 接 收 输 出结 果 的 窗 口 名 这 一 窗 口 必 须 在 接 收 输 出 结 果 前 用 DEFINE W INDOW 创

建 可 以 不 是 活 动 窗 口 或 可 见 窗 口

S H O W | NOSHOW 默 认 值

S H O W 显 示 文 本 合 并 结 果

N O S H O W 不 显 示 文 本 合 并 结 果

默 认 情 况 下 由 \ \\ 和 TEXT ... ENDTEXT 产 生 的 输 出 结 果 发 送 到 Visual FoxPro 主 窗 口 或 活 动 的 用 户 自 定 义 窗 口

说 明

\
\\ 和 TEXT ... ENDTEXT 命令用表 变量 数组元素 以及函数和表达式的计算结果替换文本中的内容 如果字段 变量 数组元素 函数或表达式用文本合并分隔符 默认为 << 和 >> 括起来了 可以计算它们的值然后以文本形式替换其内容 这一文本合并功能可以用于产生信件 程序和创建程序的模板

SET TEXTMERGE 确定用文本合并分隔符括起来的字段 变量 数组元素 函数或

表达式的计算方式 它还可以直接将替换的结果输出到 Visual FoxPro 主窗口 用户自定义窗口或文件中

可以用备注字段嵌套被替换文本 如果备注字段中包含有当前文本合并分隔符括起来

的字段名 变量 数组元素 函数或表达式 则计算它们的值 并随备注字段的内容一起输出 备注字段的名称也必须用文本合并分隔符括起来

请 参 阅

\ | \\, _PRETEXT, SET TEXTMERGE DELIMITERS, _TEXT