IBM Books

Net.Data 参考


表格函数

这些函数用于简化 Net.Data 表格的处理,它比您使用 REXX、C 或 Perl 编写的函数 更为有效。

DTW_TB_COLS


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)


表 68. DTW_TB_COLS 参数
数据类型 参数 用法 说明
表格 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.

DTW_TB_DLIST


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)


表 69. DTW_TB_DLIST 参数
数据类型 参数 用法 说明
表格 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>

DTW_TB_DUMPH


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)


表 70. DTW_TB_DUMPH 参数
数据类型 参数 用法 说明
表格 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>

DTW_TB_DUMPV


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)


表 71. DTW_TB_DUMPV 参数
数据类型 参数 用法 说明
表格 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>

DTW_TB_GETN


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)


表 72. DTW_TB_GETN 参数
数据类型 参数 用法 说明
表格 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))

DTW_TB_GETV


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X

X X X

目的

检索 rowcol 所指定的行和列的表格值。

必须在调用 DTW_TB_GETV() 之前设置表格的列数。 用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函数设置列数,或者通过把表格传送给一个语言环境 来设置。

格式

@DTW_TB_GETV(table, value, row, col)

@DTW_TB_rGETV(table, row, col)


表 73. DTW_TB_GETV 参数
数据类型 参数 用法 说明
表格 table IN 宏表格变量,它返回一个表格值。
整数 value OUT 一个变量,包含 rowcol 所指定的行和 列上的值。
整数 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").

DTW_TB_HTMLENCODE


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

目的

返回带有已编码的 HTML 字符的输入宏表格。
名称 字符 代码
&符号 & &#38;
双引号 " &#34;
大于 > &#62;
小于 < &#60;

格式

@DTW_TB_HTMLENCODE(table, collist)


表 74. DTW_TB_HTMLENCODE 参数
数据类型 参数 用法 说明
表格 table INOUT 要修改的宏表格变量。
字符串 collist IN table 中要编码的列号。缺省情况是对所有列进行编码。

例 1

@DTW_TB_HTMLENCODE(Mytable, "3 4")

在指定表格中第 3 和第 4 列中的特殊字符被它们的编码格式所替换。

DTW_TB_INPUT_CHECKBOX


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>

DTW_TB_INPUT_RADIO


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)


表 76. DTW_TB_INPUT_RADIO 参数
数据类型 参数 用法 说明
表格 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>

DTW_TB_INPUT_TEXT


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)


表 77. DTW_TB_INPUT_TEXT 参数
数据类型 参数 用法 说明
表格 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">

DTW_TB_LIST


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)


表 78. DTW_TB_LIST 参数
数据类型 参数 用法 说明
表格 table IN 指定显示成 HTML 列表的宏表格变量的符号。
字符串 listtype IN 要生成的列表类型。可接受的列表类型包括:

DIR

MENU

OL

UL

整数 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>

DTW_TB_ROWS


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)


表 79. DTW_TB_ROWS 参数
数据类型 参数 用法 说明
表格 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").

DTW_TB_SELECT


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)


表 80. DTW_TB_SELECT 参数
数据类型 参数 用法 说明
表格 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>

DTW_TB_TABLE


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)


表 81. DTW_TB_TABLE 参数
数据类型 参数 用法 说明
表格 table IN 显示成 HTML 表格的宏表格变量。
字符串 options IN TABLE 标记内部的表格属性。 缺省情况是不使用任何属性。有效值包括:

  • BORDER

  • CELLSPACING

  • WIDTH
字符串 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>

DTW_TB_TEXTAREA


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)


表 82. DTW_TB_TEXTAREA 参数
数据类型 参数 用法 说明
表格 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>


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]