grtext

将文本写到状态行或屏幕菜单区

(grtext [box text [highlight]])

该函数在菜单区显示提供的文本，它并不改变基础菜单项。不带参数调用 grtext 函数将使所有文本区恢复成缺省值。

参数

box

整数型，指定待写文本的位置。

text

要写到状态行或屏幕菜单区的字符串。如果 text 参数太长，则它将被截断。

highlight

整数，用于标识是否亮显屏幕菜单项。

不带参数调用 grtext 将使所有文本区域恢复为标准值。如果仅带一个参数调用，grtext 将产生错误。

返回值

text 参数传送的字符串。如果失败或未提供参数，则返回 nil。

屏幕菜单区

将 box 参数设为正数或 0 可以指定屏幕菜单位置，该参数的有效取值范围是从 0 到最大的屏幕菜单行号减 1。通过系统变量 SCREENBOXES 可以获得最大的屏幕菜单行号。如果提供的 highlight 参数为正整数，grtext 函数将亮显指定位置的文本。亮显一个菜单项，将自动使其他已亮显的菜单项解除亮显。如果该参数为 0，则菜单项不再亮显。如果该参数为负，它将被忽略。在某些平台上，文本必须先用不带 highlight 参数的 grtext 函数写到屏幕菜单区，然后再将它突出显示。仅当光标不在该菜单区域时，才能突出显示该区域的菜单项。

状态行区域

如果调用 grtext 函数时 box 参数的值取为 -1，则该函数会将文本写入到模式状态行区域。模式状态行的长度依显示设备的不同而不同（大多数显示设备的模式状态行至少允许容纳 40 个字符）。下列代码用 DIESEL 表达式 $(linelen) 来获取模式状态行的长度：

(setq modelen (menucmd "M=$(linelen)"))

如果 box 参数的值为 -2，grtext 函数就将文本写入到坐标状态行区域。如果坐标状态行的坐标显示跟踪开关是打开的，那么，在定点设备传过来新的坐标集时，它将会覆盖由本函数写入到该区域的文本。box 参数为 -1 或 -2 时，忽略 highlight 参数。