定制文档向导

请参阅

除了在运行“文档向导”时使用的选项外,可以在向导之外定制附加的选项。

CASE 结构中的缩进

默认情况下,向导在 CASE 结构中寻找如下的缩进:

DO CASE
CASE case1=1
   case2=2
CASE case3=3
   case4=4
ENDCASE

一些开发者愿意将 DO CASE 和 ENDCASE 之间的行再缩进一层,象下面这样:

DO CASE
   CASE case1=1
      case2=2
   CASE case3=3
      case4=4
ENDCASE

若要象第二例子中那样缩进 CASE 结构,可以在 FDKEYWRD.DBF 文件中指定。要在 FDKEYWRD.DBF 中指定代码类型,应将 ENDCASE 记录中 Code 字段的值更改为“UU”。

向导指令

可以在代码文件中放置特定的向导指令,使“文档向导”在分析代码时完成指定的任务。

可以把指令放在:

指令的语法规定以星号开始,Visual FoxPro 把它们作为注释并且在编译时忽略。指令不区分大小写,其语法为:

*# document directive

把指令放置在主程序文件的开始处是较好的方法,这能使“文档向导”在开始分析时就得到指令。

下面详细说明“文档向导”指令。

*# document ACTIONCHARS "abcdef"

默认时,文档向导建立一个操作图或者树图,当在 ASCII 1250 代码页和 ANSI 1252 代码页查看时,向导使用六个线条样的字符以及方角号。在其他代码页下查看时,不是所有的字符都映射为线条样字符。六个默认字符和相应的 FoxFont 字符在下表中用 abcdef 列出。

abcdef Chr( ) 默认值 用 FoxFont 字体
a 32 (空格)
b 196
c 179
d 218
e 192
f 195

提示 当使用其他代码页时,在主程序文件中插入如下代码,可以确保图表中的行映射为线条样字符(引号括起的字符串中第一个字符是空格):

*# document ACTIONCHARS " -|+++"

有关所支持代码页的列表,请参阅“Visual FoxPro 支持的代码页”

*# document XREF cMode

启用变量的交叉索引,默认值为 ON。

cMode 说明
ON 启用变量的交叉索引
OFF 废止变量的交叉索引
SUSPEND 在当前文件中不能使用变量的交叉索引,直至文档向导遇到下一个:

*# document XREF ON


*# document EXPANDKEYWORDS cMode

启用关键字扩展。例如,“DEFI WIND”可以扩展为“DEFINE WINDOW”。默认值为 OFF。

警告 在 Visual FoxPro 中不是所有的关键字都能以唯一的四字符长度的字符串开始。例如,“REPL”可能代表“REPLACE”或者“REPLICATE”。注意自己是否包含这种指令并选择改写已有文件。

cMode 说明
ON 启用关键字扩展
OFF 废止关键字扩展
SUSPEND 在当前文件中不能使用关键字扩展,直到遇到下一个

*# document EXPANDKEYWORDS ON


*# document XREFKEYWORDS cMode

此指令对应于文档向导中“步骤-6 完成”中的“交叉引用关键字”选项。默认值为 OFF。

cMode 说明
ON 启用关键字的交叉引用
OFF 废止关键字的交叉引用
SUSPEND 在当前文件中不能使用关键字的交叉引用,直至遇到下一个

*# document XREFKEYWORDS ON


*# document ARRAYBRACKETS cMode

默认值为 OFF。

cMode 说明
ON “文档向导”假定数组使用方括号,而函数和方法程序使用圆括号。
OFF “文档向导”将方括号和圆括号都视为数组。

*# document ACTIONINDENTLENGTH nSpace

nSpace 是“文档向导”使用缩进时需要的空格数,最小值为 2。