这些函数用于简化 Net.Data 表格的处理,它比您使用 REXX、C 或 Perl 编写的函数 更为有效。
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X |
| X | X | X | X |
目的
返回表格中当前的列数。
格式
@DTW_TB_COLS(table, cols)
@DTW_TB_rCOLS(table)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | table | IN | 针对返回的列数的宏表格变量。 |
整数 | cols | OUT | 包含 table 中列数的变量。 |
例
例 1:检索列数,并把值赋给 cols
%DEFINE myTable = %TABLE %DEFINE cols = "" ... @FillTable() ... @DTW_TB_COLS(myTable, cols)
例 2:检索并显示表格中当前列数的值
%DEFINE myTable = %TABLE ... @FillTable() ... <P>My table contains @DTW_TB_rCOLS(myTable) columns.
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
从宏表格中返回一个 HTML 定义列表。
格式
@DTW_TB_DLIST(table, term, def, termstyle, defstyle, link, link_u, image, image_u)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | 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。缺省情况是不生成内嵌图象。 |
例
例 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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
返回一个宏表格变量的内容。表格中的每一行显示在不同的行中。整个表格 要用 <PRE></PRE> 标记括起来。
格式
@DTW_TB_DUMPH(table)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | table | IN | 指定要显示的宏表格变量的符号。 |
例
例 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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
返回一个宏表格变量的内容。每个表格值在不同的行中。整个表格 要用 <PRE></PRE> 标记括起来。
格式
@DTW_TB_DUMPV(table)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | table | IN | 指定要显示的宏表格变量的符号。 |
例
例 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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X |
| X | X | X | X |
目的
检索 col 中指定的列号的列标题。
必须在调用 DTW_TB_GETN() 之前设置表格的列数。 用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函数设置列数,或者通过把表格传送给一个语言环境 来设置。
格式
@DTW_TB_GETN(table, name, col)
@DTW_TB_rGETN(table, col)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | table | IN | 从中返回一个列名称的宏表格变量。 |
表格 | table | OUT | 包含 col 中指定的列名称的变量。 |
整数 | cols | IN | 要返回的那个列的列号。 |
例
例 1:检索第 4 列的列名
%DEFINE myTable = %TABLE %DEFINE name = "" ... @FillTable() ... @DTW_TB_GETN(myTable, name, "4")
例 2:检索表格最后一列的列名
%DEFINE myTable = %TABLE ... @FillTable() ... <P>The column name of the last column is @DTW_TB_rGETN(myTable, @DTW_TB_rCOLS(myTable))
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X |
|
| X | X | X |
目的
检索 row 和 col 所指定的行和列的表格值。
必须在调用 DTW_TB_GETV() 之前设置表格的列数。 用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函数设置列数,或者通过把表格传送给一个语言环境 来设置。
格式
@DTW_TB_GETV(table, value, row, col)
@DTW_TB_rGETV(table, row, col)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | table | IN | 宏表格变量,它返回一个表格值。 |
整数 | value | OUT | 一个变量,包含 row 和 col 所指定的行和 列上的值。 |
整数 | row | IN | 要返回的行号值。 |
整数 | col | IN | 要返回的列号值。 |
例
例 1:检索第 6 行、第 3 列上的表格值
%DEFINE myTable = %TABLE %DEFINE value = "" ... @FillTable() ... @DTW_TB_GETV(myTable, value, "6", "3")
例 2:检索第 1 行、第 1 列上的表格值
%DEFINE myTable = %TABLE ... @FillTable() ... <P>The table value of row 1, column 1 is @DTW_TB_rGETV(myTable, "1", "1").
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
返回带有已编码的 HTML 字符的输入宏表格。
名称 | 字符 | 代码 |
---|---|---|
&符号 | & | & |
双引号 | " | " |
大于 | > | > |
小于 | < | < |
格式
@DTW_TB_HTMLENCODE(table, collist)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | table | INOUT | 要修改的宏表格变量。 |
字符串 | collist | IN | table 中要编码的列号。缺省情况是对所有列进行编码。 |
例
例 1:
@DTW_TB_HTMLENCODE(Mytable, "3 4")
在指定表格中第 3 和第 4 列中的特殊字符被它们的编码格式所替换。
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
从一个宏表格变量返回一个或多个 HTML 校验框输入标记。
格式
@DTW_TB_INPUT_CHECKBOX(table, prompt, namecol, valuecol, rows, checkedrows)
值
表 75. 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。缺省 情况是不选择字段。 |
例
例 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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
从一个宏表格变量返回一个或多个 HTML 选项按钮输入标记。
格式
@DTW_TB_INPUT_RADIO(table, prompt, namecol, valuecol, rows, checkedrows)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | table | IN | 显示成选项按钮输入标记的宏表格变量。 |
字符串 | prompt | IN | table中的列号,或是一个包含要在选项按钮 旁边显示的文本的字符串。此参数是必需的,但可以包含空("")值。如果 prompt 为空,则使用 valuecol 的值。 |
字符串 | namecol | IN | table中的列号,或一个包含输入字段名的字符串。 |
字符串 | valuecol | IN | table中的列号,或是一个包含输入字段值的字符串。 |
字符串 | rows | IN | 从中生成输入字段的 table 中的一张行的列表。缺省情况 是使用所有的行。 |
整数 | checkedrows | IN | table 中的行号,显示所选择的相应选项按钮。只允许指定一个值。 |
例
例 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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
针对 Net.Data 表格中指定的行返回 HTML <INPUT> 标记。例如, Net.Data 可以生成具有 VALUE、SIZE 和 MAXLENGTH 属性的 HTML <INPUT> 标记。
<INPUT TYPE="TEXT" NAME="someName" VALUE="someValue" SIZE="20" MAXLENGTH="40">
格式
@DTW_TB_INPUT_TEXT(table, prompt, namecol, valuecol, size, maxlen, rows)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | 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 中的一张行的列表。缺省情况 是使用所有的行。 |
例
例 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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
返回一个 HTML 列表。
格式
@DTW_TB_LIST(table, listtype, listitem, itemstyle, link_u, image_u)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | table | IN | 指定显示成 HTML 列表的宏表格变量的符号。 |
字符串 | listtype | IN | 要生成的列表类型。可接受的列表类型包括:
|
整数 | listitem | IN | table 中的列号,它包含列表值( <LI> 标记后 所转向的文本)。缺省情况是使用第一列。 |
字符串 | itemstyle | IN | 一个变量或文字串,其中包含用于项目名称值 的 HTML 元素列表。缺省情况是不使用任何风格标记。 |
整数 | link_u | IN | table 中的列号,它包含 HTML 链接的 URL。 如果没有指定这个值,则不生成 HTML 链接。 |
整数 | image_u | IN | table 中的列号,它包含内嵌图象的 URL。如果没有指定这个值,则不生成嵌入图象。 |
例
例 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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X |
|
| X | X | X |
目的
返回表格中当前的行数。
格式
@DTW_TB_ROWS(table, rows)
@DTW_TB_rROWS(table)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | table | IN | 宏表格变量,它返回当前的行数。 |
整数 | rows | OUT | 包含 table 中当前行数的变量。 |
例
例 1:检索表格中当前的行数,并把值赋给 rows
%DEFINE myTable = %TABLE %DEFINE rows = "" ... @FillTable() ... @DTW_TB_ROWS(myTable, rows)
例 2:检索并显示当前行号的值
%DEFINE myTable = %TABLE ... @FillTable() ... <P>The table value of row 1, column 1 is @DTW_TB_rROWS(myTable, "1", "1").
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
返回一个 HTML SELECT 菜单。
格式
@DTW_TB_SELECT(table, name, optioncol, size, multiple, rows, selectrows)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | table | IN | 要作为 SELECT 字段来显示的宏表格变量。 |
字符串 | name | IN | SELECT 字段中 NAME 属性的值。 |
整数 | optioncol | IN | table 中的列号,它的值将在 SELECT 字段 的 OPTION 标记中使用。缺省情况是使用第一列。 |
整数 | size | IN | table 中的行数,用于 SELECT 字段中的 OPTION 标 记。缺省情况是使用所有行。 |
字符串 | multiple | IN | 指定是否允许多个选择。缺省值是 N,即不允许 多个选择。 |
字符串 | selectedrows | IN | table中的行数,它用在 SELECT 字段中。缺省情况是使用所有行。 |
字符串 | rows | IN | 表格中的行列表,这些行的 OPTION 标记都 将被选择。如果要指定多行,必须将“多个参数”选项设置为 Y。缺省值是使用 第一个项目。 |
例
生成一个具有多项选择的 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>
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
从一个宏表格变量返回一个 HTML 表格。
格式
@DTW_TB_TABLE(table, options, collist, cellstyle, link_u, image_u, url_text, url_style)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | 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 中指定的文本。缺省情况是不生成风格标记。 |
例
例 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 | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X | X | X | X | X | X |
目的
从一个宏表格变量返回 HTML TEXTAREA 标记。
格式
@DTW_TB_TEXTAREA(table, name, numrows, numcols, valuecol, rows)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
表格 | table | IN | 作为 TEXTAREA 标记显示的宏表格变量。 |
字符串 | name | IN | 文本区域的名称。 |
整数 | numrows | IN | 在 rows 中指定的文本区域的高度。缺省是 table 中 的行数。 |
整数 | numcols | IN | 在 columns 中指定的文本区域的宽度。缺省是 table 中最长行的长度。 |
整数 | valuecol | IN | table 中的列号,其值显示在文本区域中。缺省值是第一列。 |
字符串 | rows | IN | table 的一张行列表,用于生成 TEXTAREA 标记。缺省情况 是使用所有的行。 |
例
例 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>