这些函数用于简化 Net.Data 表格的处理，它比您使用 REXX、C 或 Perl 编写的函数 更为有效。
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
在 Net.Data 表格结尾添加一行或多行。
格式
@DTW_TB_APPENDROW(table, rows)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | INOUT | 针对追加的行的宏表格变量。 |
| 整数 | rows | IN | 要追加到 table 的行数。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
| 1010 | 数据不停地被写入表格，直到表格满为止，然后废弃剩余的数据。 |
用法注意事项
例
例 1：向表中追加十行
%DEFINE myTable = %TABLE @DTW_TB_APPENDROW(myTable, "10")
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
返回 Net.Data 表格中的列数。
格式
@DTW_TB_COLS(table, cols)
@DTW_TB_rCOLS(table)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 针对返回的列数的宏表格变量。 |
| 整数 | cols | OUT | 包含 table 中列数的变量。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1006 | 传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。 |
例
例 1：检索列数，并把值赋给 cols
%DEFINE myTable = %TABLE %DEFINE cols = "" ... @FillTable(myTable) ... @DTW_TB_COLS(myTable, cols)
例 2：检索并显示表格中当前列数的值
%DEFINE myTable = %TABLE ... @FillTable(myTable) ... <P>My table contains @DTW_TB_rCOLS(myTable) columns.
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
从 Net.Data 表格中删除一列或多列。
格式
@DTW_TB_DELETECOL(table, after_col, cols)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | INOUT | 要在其中删除列的宏表格变量。 |
| 整数 | after_col | IN | 后继列要被删除的列的列号。要删除第一列，指定0。 |
| 整数 | cols | IN | 要从 table 中删除的列数。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
例
例 1：从表格中删除第三列与第四列
%DEFINE myTable = %TABLE @DTW_TB_DELETECOL(myTable, "3", "2")
例 2：从表格中删除第一列
%DEFINE myTable = %TABLE @DTW_TB_DELETECOL(myTable, "0", "1")
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
从 Net.Data 表格中删除一行或多行。
格式
@DTW_TB_DELETEROW(table, start_row, rows)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | INOUT | 要从中删除行的宏表格变量。 |
| 整数 | start_row | IN | table 中要删除的第一行的行号。 |
| 整数 | rows | IN | 要从 table 中删除的行数。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
用法注意事项
调用 DTW_TB_DELETEROW() 之前必须先设置表中的列数。用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函数设置列数，或者通过把表格传送给一个语言环境 来设置。
例
例 1：从表中删除从第 10 行开始的五行
%DEFINE myTable = %TABLE @DTW_TB_DELETEROW(myTable, "10", "5")
例 2：删除表中的所有行
%DEFINE myTable = %TABLE @DTW_TB_DELETEROW(myTable, "1", @DTW_TB_rROWS(myTable))
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
从 Net.Data 表格生成一个 HTML 定义列表。
格式
@DTW_TB_DLIST(table, term, def, termstyle, defstyle, link, link_u, image, image_u)
@DTW_TB_DLIST(table, term, def, termstyle, defstyle, link, link_u, image)
@DTW_TB_DLIST(table, term, def, termstyle, defstyle, link, link_u)
@DTW_TB_DLIST(table, term, def, termstyle, defstyle, link)
@DTW_TB_DLIST(table, term, def, termstyle, defstyle)
@DTW_TB_DLIST(table, term, def, termstyle)
@DTW_TB_DLIST(table, term, def)
@DTW_TB_DLIST(table, term)
@DTW_TB_DLIST(table)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 一个符号，指定表格变量显示成一张 HTML 定义列表。 |
| 整数 | term | IN | table 中的列号，它包含 term 名称值 (<DT>标记后转向的文本)。缺省情况是使用第一列。 |
| 整数 | def | IN | table 中包含项目定义值( <DD 标记 后面的文本)的列号。缺省情况是使用第二列。 |
| 字符串 | termstyle | IN | 包含针对 term名称值的一张 HTML 元素列表的变量 或者文字串。缺省情况是不使用任何风格标记。 |
| 字符串 | defstyle | IN | 包含针对 term定义值的一张 HTML 元素列表的变量 或者文字串。缺省情况是不使用任何风格标记。 |
| 字符串 | link | IN | 指定针对哪些 HTML 元素生成 HTML 链接。有效值是 DT 和 DD。缺省是不生成 HTML 链接。 |
| 整数 | link_u | IN | table 中的列号，它包含 HTML 引用的 URL。缺省是不生成 HTML 链接。 |
| 字符串 | image | IN | 指定要为哪些 HTML 元素生成 内嵌图象(inline image)。有效值是 DT 和 DD。缺省是不生成内嵌图象(DT)。 |
| 整数 | image_u | IN | table 中的列号，它包含内嵌图象的 URL。缺省情况是不生成内嵌图象。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
例
例 1：创建一张定义列表，按照表格数据产生下面所示的 HTML
@DTW_TB_DLIST(Mytable,"3","4","b i","strong","DD","2","DT","1")
结果：
<DL> <DT> <IMG SRC="http://www.mycompany.com/images/image1.gif" ALT=""><b><i>image1text</i></b> <DD> <A HREF="http://www.mycompany.com/link1.html"><strong>link1text</strong></A> <DT> <IMG SRC="http://www.mycompany.com/images/image2.gif" ALT=""><b><i>image2text</i></b> <DD> <A HREF="http://www.mycompany.com/link2.html"><strong>link2text</strong></A> <DT> <IMG SRC="http://www.mycompany.com/images/image3.gif" ALT=""><b><i>image3text</i></b> <DD> <A HREF="http://www.mycompany.com/link3.html"><strong>link3text</strong></A> <DT> <IMG SRC="http://www.mycompany.com/images/image4.gif" ALT=""><b><i>image4text</i></b> <DD> <A HREF="http://www.mycompany.com/link4.html"><strong>link4text</strong></A> </DT> </DL>
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
使用 HTML <PRE> 标记打印出 Net.Data 表格的内容，表格中的每一行分别显示在一行上。
格式
@DTW_TB_DUMPH(table)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 指定要显示的宏表格变量的符号。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
用法注意事项
如果 Net.Data 表格为空，将返回一个错误。
例
例 1：
@DTW_TB_DUMPH(Mytable)
此例生成的 HTML 看起来象：
<PRE> Name Department Position Jack Smith Internet Technologies Software Engineer Helen Williams Database Development Manager Alex Jones Manufacturing Industrial Engineer Tom Baker Procurement Sales Rep </PRE>
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
使用 HTML <PRE> 标记打印出 Net.Data 表格的内容，表格中的每个字段分别显示在一行上。
格式
@DTW_TB_DUMPV(table)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 指定要显示的宏表格变量的符号。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
用法注意事项
如果 Net.Data 表格为空，将返回一个错误
例
例 1：
@DTW_TB_DUMPV(Mytable)
这个 例子生成的 HTML 如下所示：
<PRE> http://www.mycompany.com/images/image1.gif http://www.mycompany.com/link1.html image1text link1text http://www.mycompany.com/images/image2.gif http://www.mycompany.com/link2.html image2text link2text http://www.mycompany.com/images/image3.gif http://www.mycompany.com/link3.html image3text link3text http://www.mycompany.com/images/image4.gif http://www.mycompany.com/link4.html image4text link4text </PRE>
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
从 Net.Data 表格返回一个列标题。
格式
@DTW_TB_GETN(table, col, name)
@DTW_TB_rGETN(table, col)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 从中返回一个列名称的宏表格变量。 |
| 整数 | col | IN | 要返回的那个列的列号。 |
| 字符串 | name | OUT | 包含 col 中指定的列名称的变量。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1006 | 传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
用法注意事项
调用 DTW_TB_GETN() 之前，设置表格中的列数。用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函数设置列数，或者通过把表格传送给一个语言环境 来设置。
例
例 1：检索第 4 列的列名
%DEFINE myTable = %TABLE %DEFINE name = "" ... @FillTable(myTable) ... @DTW_TB_GETN(myTable, "4", name)
例 2：检索表格最后一列的列名
%DEFINE myTable = %TABLE ... @FillTable(myTable) ... <P>The column name of the last column is @DTW_TB_rGETN(myTable, @DTW_TB_rCOLS(myTable))
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
返回 Net.Data 表格中给定行列的值。
格式
@DTW_TB_GETV(table, row, col, value)
@DTW_TB_rGETV(table, row, col)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 宏表格变量，它返回一个表格值。 |
| 整数 | row | IN | 要返回的行号值。 |
| 整数 | col | IN | 要返回的列号值。 |
| 字符串 | value | OUT | 一个变量，包含 row 和 col 所指定的行和 列上的值。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1006 | 传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
用法注意事项
调用 DTW_TB_GETV() 之前，设置表格中的列数。用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函数设置列数，或者通过把表格传送给一个语言环境 来设置。
例
例 1：检索第 6 行、第 3 列上的表格值
%DEFINE myTable = %TABLE %DEFINE value = "" ... @FillTable(myTable) ... @DTW_TB_GETV(myTable, "6", "3", value)
例 2：检索第 1 行、第 1 列上的表格值
%DEFINE myTable = %TABLE ... @FillTable(myTable) ... <P>The table value of row 1, column 1 is @DTW_TB_rGETV(myTable, "1", "1").
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
用相应的 HTML 字符转义代码替换位于 Net.Data 表格中的数据内的某些字符。
格式
@DTW_TB_HTMLENCODE(table, collist)
@DTW_TB_HTMLENCODE(table)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | INOUT | 要修改的宏表格变量。 |
| 字符串 | collist | IN | table 中要编码的列号。缺省情况是对所有列进行编码。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
用法注意事项
被替换的字符在下表中指出。
| 名称 | 字符 | 代码 |
|---|---|---|
| &符号 | & | & |
| 双引号 | " | " |
| 大于 | > | > |
| 小于 | < | < |
例
例 1：
@DTW_TB_HTMLENCODE(Mytable, "3 4")
在指定表格中第 3 和第 4 列中的特殊字符被它们的编码格式所替换。
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
从 Net.Data 表格生成一个或多个 HTML 校验框输入标记。
格式
@DTW_TB_INPUT_CHECKBOX(table, prompt, namecol, valuecol, rows, checkedrows)
@DTW_TB_INPUT_CHECKBOX(table, prompt, namecol, valuecol, rows)
@DTW_TB_INPUT_CHECKBOX(table, prompt, namecol, valuecol)
@DTW_TB_INPUT_CHECKBOX(table, prompt, namecol)
参数
表 139. DTW_TB_INPUT_CHECKBOX 参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 要作为校验框输入标记来显示的宏表格变量。 |
| 字符串 | prompt | IN | table中的列号，或是一个包含要在校验框 旁边显示的文本的字符串。此参数是必需的，但可以是空("")值。如果 prompt为空，则使用的值是 定义给 namecol 的值。 |
| 字符串 | namecol | IN | table中的列号，或一个包含输入字段名的字符串。 |
| 整数 | valuecol | IN | table 中的列号，它包含输入字段值。缺省值是 1。 |
| 整数 | rows | IN | 从中生成输入字段的 table 中的一张行的列表。缺省情况 是使用所有的行。 |
| 整数 | checkedrows | IN | 一张行列表，指定选择 table 中的哪些 rows。缺省 情况是不选择字段。 |
返回码
表 140. DTW_TB_INPUT_CHECKBOX 返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1002 | 输入参数中包含一个由空终结字符组成的字符串值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
例
例 1：生成三个校验框输入标记的 HTML
@DTW_TB_INPUT_CHECKBOX(Mytable,"3","4","","2 3 4","1 3 4")
结果：
<INPUT TYPE="CHECKBOX" NAME="link2text" VALUE="1">image2text<BR> <INPUT TYPE="CHECKBOX" NAME="link3text" VALUE="1" CHECKED>image3text<BR> <INPUT TYPE="CHECKBOX" NAME="link4text" VALUE="1" CHECKED>image4text<BR>
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
从 Net.Data 表格生成 HTML 选项按钮输入标记。
格式
@DTW_TB_INPUT_RADIO(table, prompt, namecol, valuecol, rows, checkedrows)
@DTW_TB_INPUT_RADIO(table, prompt, namecol, valuecol, rows)
@DTW_TB_INPUT_RADIO(table, prompt, namecol, valuecol)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 显示成选项按钮输入标记的宏表格变量。 |
| 字符串 | prompt | IN | table中的列号，或是一个包含要在选项按钮 旁边显示的文本的字符串。此参数是必需的，但可以包含空("")值。如果 prompt 为空，则使用 valuecol 的值。 |
| 字符串 | namecol | IN | table中的列号，或一个包含输入字段名的字符串。 |
| 整数 | valuecol | IN | table 中的列号，它包含输入字段值。 |
| 字符串 | rows | IN | 从中生成输入字段的 table 中的一张行的列表。缺省情况 是使用所有的行。 |
| 整数 | checkedrows | IN | table 中的行号，显示所选择的相应选项按钮。只允许指定一个值。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1002 | 输入参数中包含一个由空终结字符组成的字符串值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
例
例 1：生成三个选项按钮输入标记的 HTML
@DTW_TB_INPUT_RADIO(Mytable,"3","Radio4","4","2 3 4","4")
结果：
<INPUT TYPE="RADIO" NAME="Radio4" VALUE="link2text">image2text<BR> <INPUT TYPE="RADIO" NAME="Radio4" VALUE="link3text">image3text<BR> <INPUT TYPE="RADIO" NAME="Radio4" VALUE="link4text" CHECKED>image4text<BR>
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
针对 Net.Data 表格中指定的行生成 HTML <INPUT> 标记。
格式
@DTW_TB_INPUT_TEXT(table, prompt, namecol, valuecol, size, maxlen, rows)
@DTW_TB_INPUT_TEXT(table, prompt, namecol, valuecol, size, maxlen)
@DTW_TB_INPUT_TEXT(table, prompt, namecol, valuecol, size)
@DTW_TB_INPUT_TEXT(table, prompt, namecol, valuecol)
@DTW_TB_INPUT_TEXT(table, prompt, namecol)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 显示成文本输入标记的宏表格变量。 |
| 字符串 | prompt | IN | table中的列号，或是一个包含要在输入字段 旁边显示的文本的字符串。如果 prompt 为空，则不显示文本。 |
| 字符串 | namecol | IN | table 中的列号，它包含输入字段的名称。 |
| 整数 | valuecol | IN | table 中的列号，包含缺省输入字段值， 这是给 INPUT 标记上的 VALUE 属性指定的。缺省情况是不生成 VALUE 属性值。 |
| 整数 | size | IN | 输入字段的字符个数，这是为 INPUT 标记上的 SIZE 属性指定 的。缺省值是最长的缺省输入值的长度，如果不存在缺省输入，则为 10。 |
| 整数 | maxlen | IN | 输入字符串的最大长度，这是为 INPUT 标记上的 MAXLENGTH 属性 指定的。缺省是不生成MAXLENGTH 属性值。 |
| 整数 | rows | IN | 从中生成输入字段的 table 中的一张行的列表。缺省情况 是使用所有的行。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1002 | 输入参数中包含一个由空终结字符组成的字符串值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
例
例 1：返回三个 HTML <INPUT> 标记
@DTW_TB_INPUT_TEXT(Mytable,"3","3","4","35","40","1 2 3")
结果：
<P>image1text <INPUT TYPE="TEXT" NAME="image1text" VALUE="link1text" SIZE="35" MAXLENGTH="40"> <P>image2text <INPUT TYPE="TEXT" NAME="image2text" VALUE="link2text" SIZE="35" MAXLENGTH="40"> <P>image3text <INPUT TYPE="TEXT" NAME="image3text" VALUE="link3text" SIZE="35" MAXLENGTH="40">
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
在 Net.Data 表格中插入一列或多列。
格式
@DTW_TB_INSERTCOL(table, after_col, cols)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | INOUT | 要在其中插入列的宏表格变量。 |
| 整数 | after_col | IN | 新列插入后的列号。要在表的开头插入列， 请指定 0。 |
| 整数 | cols | IN | 要插入 table 的列数。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
例
例 1：在表尾插入五列
%DEFINE myTable = %TABLE @DTW_TB_INSERTCOL(myTable, @DTW_TB_rCOLS(myTable), "5")
例 2：在表首插入一列
%DEFINE myTable = %TABLE @DTW_TB_INSERTCOL(myTable, "0", "1")
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
在 Net.Data 表格中插入一行或多行。
格式
@DTW_TB_INSERTROW(table, after_row, rows)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | INOUT | 要在其中插入行的宏表格变量。 |
| 整数 | after_row | IN | 新行插入之后的行号。要在表格的开头插入行，请指定 0。 |
| 整数 | rows | IN | 要插入 table 的行数。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
用法注意事项
调用 DTW_TB_INSERTROW() 之前，设置表格中的列数。用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函数设置列数，或者通过把表格传送给一个语言环境 来设置。
例
例 1：在表的第五行后插入一行
%DEFINE myTable = %TABLE @DTW_TB_INSERTROW(myTable, "5", "1")
例 2：在表的开始处插入三行
%DEFINE myTable = %TABLE @DTW_TB_INSERTROW(myTable, "0", "3")
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
从 Net.Data 表格生成一个 HTML 列表。
格式
@DTW_TB_LIST(table, listtype, listitem, itemstyle, link_u, image_u)
@DTW_TB_LIST(table, listtype, listitem, itemstyle, link_u)
@DTW_TB_LIST(table, listtype, listitem, itemstyle)
@DTW_TB_LIST(table, listtype, listitem)
@DTW_TB_LIST(table, listtype)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 指定显示成 HTML 列表的宏表格变量的符号。 |
| 字符串 | listtype | IN | 要生成的列表类型。可接受的列表类型包括：
|
| 整数 | listitem | IN | table 中的列号，它包含列表值( <LI> 标记后 所转向的文本)。缺省情况是使用第一列。 |
| 字符串 | itemstyle | IN | 一个变量或文字串，其中包含用于项目名称值 的 HTML 元素列表。缺省情况是不使用任何风格标记。 |
| 整数 | link_u | IN | table 中的列号，它包含 HTML 链接的 URL。 如果没有指定这个值，则不生成 HTML 链接。 |
| 整数 | image_u | IN | table 中的列号，它包含内嵌图象的 URL。如果没有指定这个值，则不生成嵌入图象。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1002 | 输入参数中包含一个由空终结字符组成的字符串值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
例
例 1：生成一张顺序列表的 HTML 标记
@DTW_TB_LIST(Mytable,"OL","4","TT U","2","1")
结果：
<TT><U> <OL> <LI><A HREF="http://www.mycompany.com/link1.html"> <IMG SRC="http://www.mycompany.com/images/image1.gif" ALT="">link1text</A> <LI><A HREF="http://www.mycompany.com/link2.html"> <IMG SRC="http://www.mycompany.com/images/image2.gif" ALT="">link2text</A> <LI><A HREF="http://www.mycompany.com/link3.html"> < IMG SRC="http://www.mycompany.com/images/image3.gif" ALT="">link3text</A> <LI><A HREF="http://www.mycompany.com/link4.html"> <IMG SRC="http://www.mycompany.com/images/image4.gif" ALT="">link4txt</A> </OL> </U></TT>
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
返回与 Net.Data 表格的列标题相关联的列号。
格式
@DTW_TB_QUERYCOLNONJ(table, name, col)
@DTW_TB_rQUERYCOLNONJ(table, name)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 要从中返回列号的宏表格变量。 |
| 字符串 | name | IN | 列标题的名称(对于这个列标题返回了列号)。如果表中不存在 该列标题，则返回 0。 |
| 整数 | col | OUT | 包含某一列列号的变量(该列的名称在 name 中指定)。 |
返回码
表 152. DTW_TB_QUERYCOLNONJ 返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1006 | 传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。 |
用法注意事项
例
例 1：检索列名为 SERIAL_NUMBER 的列的列号
%DEFINE myTable = %TABLE %DEFINE col = "" @DTW_TB_QUERYCOLNONJ(myTable, "SERIAL_NUMBER", col)
例 2检索列名为 SERIAL_NUMBER 的列的列号
%DEFINE myTable = %TABLE <P>The "SERIAL_NUMBER" column is column number @DTW_TB_rQUERYCOLNONJ(myTable, "SERIAL_NUMBER")
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
返回 Net.Data 表格中的行数。
格式
@DTW_TB_ROWS(table, rows)
@DTW_TB_rROWS(table)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 宏表格变量，它返回当前的行数。 |
| 整数 | rows | OUT | 包含 table 中当前行数的变量。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1006 | 传递给函数调用的参数必须是一个输出参数，但实际上传递了一个文字串。 |
例
例 1：检索表格中当前的行数，并把值赋给 rows
%DEFINE myTable = %TABLE %DEFINE rows = "" ... @FillTable(myTable) ... @DTW_TB_ROWS(myTable, rows)
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
从 Net.Data 表格生成一个 HTML 选择列表。
格式
@DTW_TB_SELECT(table, name, optioncol, size, multiple, rows, selectedrows, valuecol)
@DTW_TB_SELECT(table, name, optioncol, size, multiple, rows, selectedrows)
@DTW_TB_SELECT(table, name, optioncol, size, multiple, rows)
@DTW_TB_SELECT(table, name, optioncol, size, multiple)
@DTW_TB_SELECT(table, name, optioncol, size)
@DTW_TB_SELECT(table, name, optioncol)
@DTW_TB_SELECT(table, name)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 要作为 SELECT 字段来显示的宏表格变量。 |
| 字符串 | name | IN | SELECT 字段中 NAME 属性的值。 |
| 整数 | optioncol | IN | table 中的列号，它的值将在 SELECT 字段 的 OPTION 标记中使用。缺省情况是使用第一列。 |
| 整数 | size | IN | table 中的行数，用于 SELECT 字段中的 OPTION 标 记。缺省情况是使用所有行。 |
| 字符串 | multiple | IN | 指定是否允许多个选择。缺省值是 N，即不允许 多个选择。 |
| 字符串 |
rows
| IN | table中的行数，它用在 SELECT 字段中。缺省情况是使用所有行。 |
| 字符串 |
selectedrows
| IN | 表格中的行列表，这些行的 OPTION 标记都 将被选择。如果要指定多行，必须将“多个参数”选项设置为 Y。缺省值是使用 第一个项目。 |
| 字符串 | valuecol | IN | table 中的列号，用于 OPTION 标记的 VALUE 属性。此参数是可选的。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
例
例 1：生成一个具有多项选择的 HTML SELECT 菜单
@DTW_TB_SELECT(Mytable,"URL6","3","","y","1 2 4","1 4")
结果：
<SELECT NAME="URL6" SIZE="3" MULTIPLE> <OPTION SELECTED>image1text <OPTION>image2text <OPTION SELECTED>image4text </SELECT>
例 2：使用 valuecol 参数来生成 一个使用列号的 HTML SELECT 菜单，从该列号获取值。
结果：
<SELECT NAME="URL6" SIZE="3" MULTIPLE> <OPTION VALUE="1" SELECTED>image1text <OPTION VALUE="2">image2text <OPTION VALUE="3" SELECTED>image3text </SELECT>
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
设置 Net.Data 表格中的列数。
格式
@DTW_TB_SETCOLS(table, cols)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | INOUT | 设置了列数的宏表格变量。 |
| 整数 | cols | IN | 要在 table 中分配的初始列数。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
用法注意事项
例
例 1：为表分配三个列并指定列名
%DEFINE myTable = %TABLE @DTW_TB_SETCOLS(myTable, "3") @DTW_TB_SETN(myTable, "Name", "1") @DTW_TB_SETN(myTable, "Address", "2") @DTW_TB_SETN(myTable, "Phone", "3")
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
给 Net.Data 中的列标题指定一个名称。
格式
@DTW_TB_SETN(table, name, col)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | INOUT | 要在其中设置列名的宏表格变量。 |
| 字符串 | name | IN | 指定给列标题的字符串(该列在 col 中指定)。 |
| 整数 | col | IN | 要设置标题的列的列号。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
用法注意事项
例
例 1：为列标题 1 至 3 指定一个名称
%DEFINE myTable = %TABLE @DTW_TB_SETCOLS(myTable, "3") @DTW_TB_SETN(myTable, "Name", "1") @DTW_TB_SETN(myTable, "Address", "2") @DTW_TB_SETN(myTable, "Phone", "3")
例 2：为列 2 删除列标题。这可以通过在未定义的函数调用时传递一个变量来实现。缺省情况下，这个变量的值为 NULL
%DEFINE myTable = %TABLE @DTW_TB_SETN(myTable, nullVar, "2")
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
给 Net.Data 表格中的特定行和列指定一个值。
格式
@DTW_TB_SETV(table, value, row, col)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | INOUT | 要在其中设置表格值的宏表格变量。 |
| 字符串 | value | IN | 指定给表格值的字符串(其行和列在 row 和 col 中指定)。 |
| 整数 | row | IN | 要设置的行号值。 |
| 整数 | col | IN | 要设置的列号值。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
用法注意事项
例
例 1：为第 3 行第 3 列指定一个值
%DEFINE myTable = %TABLE @DTW_TB_SETV(myTable, "value3.3", "3", "3")
例 2：删除第 4 行、第 2 列的表格值。这可以通过在未定义的函数调用时传递一个变量来实现。缺省情况下，这个变量的值为 NULL。
%DEFINE myTable = %TABLE @DTW_TB_SETV(myTable, nullVar, "4", "2")
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
从 Net.Data 表格生成一个 HTML 表格。
格式
@DTW_TB_TABLE(table, options, collist, cellstyle, link_u, image_u, url_text, url_style)
@DTW_TB_TABLE(table, options, collist, cellstyle, link_u, image_u, url_text)
@DTW_TB_TABLE(table, options, collist, cellstyle, link_u, image_u)
@DTW_TB_TABLE(table, options, collist, cellstyle, link_u)
@DTW_TB_TABLE(table, options, collist, cellstyle)
@DTW_TB_TABLE(table, options, collist)
@DTW_TB_TABLE(table, options)
@DTW_TB_TABLE(table)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 显示成 HTML 表格的宏表格变量。 |
| 字符串 | options | IN | TABLE 标记内部的表格属性。缺省情况是不使用任何属性。有效值包括：
|
| 字符串 | collist | IN | table 中用在 HTML 表格中的列号。缺省情况是使用所有列。 |
| 字符串 | cellstyle | IN | 在每个 TD 标记中的文本附近出现的 HTML 风格 元素的一个列表，例如 B 和 I。缺省情况是不使用风格标记。 |
| 整数 | link_u | IN | table中的列号，它包含用于创建 HTML 链 路的 URL。同样必须在 collist中指定这一列。缺省是不生成 HTML 链接。 |
| 整数 | image_u | IN | table中的列号，它包含用于创建内嵌图象的 URL。同样必须在 collist中指定这一列。 缺省是不生成图象标记。 |
| 整数 | url_text | IN | table中的列号，它包含显示给 HTML 链接 或内嵌图象的文本。缺省情况是使用 URL 本身。 |
| 字符串 | url_style | IN | HTML 风格元素的一个列表，这些风格 用于在 url_text 中指定的文本。缺省情况是不生成风格标记。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
例
例 1：为一张具有一个边框并使用 B (黑体)和 I (斜体字)标记的表格生 成 HTML 标记
@DTW_TB_TABLE(Mytable,"BORDER","4 2 1","i","2","1","4","b")
结果：
<TABLE BORDER> <TR> <TH>TITLE <TH>LINKURL <TH>IMAGEURL <TR> <TD><i>link1text</i> <TD><A HREF="http://www.mycompany.com/link1.html"><b>link1text</b></A> <TD><IMG SRC="http://www.mycompany.com/images/image1.gif" ALT=""><b>link1text</b> <TR> <TD><i>link2text</i> <TD><A HREF="http://www.mycompany.com/link2.html"><b>link2text</b></A> <TD><IMG SRC="http://www.mycompany.com/images/image2.gif" ALT=""><b>link2text</b> <TR> <TD><i>link3text</i> <TD><A HREF="http://www.mycompany.com/link3.html"><b>link3text</b></A> <TD><IMG SRC="http://www.mycompany.com/images/image3.gif" ALT=""><b>link3text</b> </TABLE>
| AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
| X | X | X | X | X | X | X | X | X |
目的
从 Net.Data 表格生成一个 HTML 文本区域。
格式
@DTW_TB_TEXTAREA(table, name, numrows, numcols, valuecol, rows)
@DTW_TB_TEXTAREA(table, name, numrows, numcols, valuecol)
@DTW_TB_TEXTAREA(table, name, numrows, numcols)
@DTW_TB_TEXTAREA(table, name, numrows)
@DTW_TB_TEXTAREA(table, name)
参数
| 数据类型 | 参数 | 用法 | 说明 |
|---|---|---|---|
| 表格 | table | IN | 作为 TEXTAREA 标记显示的宏表格变量。 |
| 字符串 | name | IN | 文本区域的名称。 |
| 整数 | numrows | IN | 在 rows 中指定的文本区域的高度。缺省是 table 中 的行数。 |
| 整数 | numcols | IN | 在 columns 中指定的文本区域的宽度。缺省是 table 中最长行的长度。 |
| 整数 | valuecol | IN | table 中的列号，其值显示在文本区域中。缺省值是第一列。 |
| 字符串 | rows | IN | table 的一张行列表，用于生成 TEXTAREA 标记。缺省情况 是使用所有的行。 |
返回码
| 返回码 | 说明 |
|---|---|
| -1001 | 服务器不能处理 Net.Data 请求来分配内存。 |
| 1001 | 输入参数中包含一个空值。 |
| 1003 | 在函数调用时传递的参数数目或者超过了允许的最大数目，或者小于该函数必需的最小数目。 |
| 1004 | 传递给函数调用的参数应该是一个 Net.Data 宏表格变量， 但实际上是另一个类型的变量。 |
| 1005 | 传递给函数调用的参数应该是一个字符串变量，但实际上是另一个类型的变量。 |
| 1007 | 参数中包含了一个无效值。 |
| 1008 | 参数超出了表边界。 |
例
例 1：生成 HTML TEXTAREA 标记并指定要包含哪些行
@DTW_TB_TEXTAREA(Mytable,"textarea5","3","70","4","1 3 4")
结果：
<TEXTAREA NAME="textarea5" ROWS="3" COLS="70"> link1text link3text link4text <TEXTAREA>