參考手冊

表格函數

這些函數可簡化 Net.Data 表格的使用化，且比使用 REXX、C 或 Perl 撰寫您自己的函數更有效率。

DTW_TB_APPENDROW
DTW_TB_COLS
DTW_TB_DELETEROW
DTW_TB_DELETECOL
DTW_TB_DLIST
DTW_TB_DUMPH
DTW_TB_DUMPV
DTW_TB_GETN
DTW_TB_GETV
DTW_TB_HTMLENCODE
DTW_TB_INPUT_CHECKBOX
DTW_TB_INPUT_RADIO
DTW_TB_INPUT_TEXT
DTW_TB_INSERTCOL
DTW_TB_INSERTROW
DTW_TB_LIST
DTW_TB_QUERYCOLNONJ
DTW_TB_ROWS
DTW_TB_SELECT
DTW_TB_SETCOLS
DTW_TB_SETN
DTW_TB_SETV
DTW_TB_TABLE
DTW_TB_TEXTAREA

DTW_TB_APPENDROW

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)

參數

表 119. DTW_TB_APPENDROW 參數

資料類型	參數	使用	說明
表格	`table`	INOUT	附加橫列的巨集表格變數。
整數	`rows`	IN	附加至 `table` 中的橫列數。

回覆碼

表 120. DTW_TB_APPENDROW 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
1003	函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1004	函數呼叫上傳遞的參數必須是 Net.Data 巨集表變數，但卻是不同的變數類型。
1005	函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007	參數包含的值無效。
1008	參數超出表格界限。
1010	資料會被寫入表格中，直到表格沒有空位為止，剩餘資料則捨棄。

用法注意事項

在呼叫 DTW_TB_APPENDROW() 之前，須先設定表格中的直欄數目。您可以使用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函數，或將表格傳送到將被設定的語言環境中來設定直欄的數目。
在表格中附加列之後，您可以使用 DTW_TB_SETV() 函數指定新列的值，或將表格傳送到語言環境去處理。
如果表格中有橫列總數的限制，且將附加的列數使得超過這個限制，會有一個錯誤傳回給呼叫者。

範例

範例 1：附加十列橫列至表格

%DEFINE myTable = %TABLE
 
@DTW_TB_APPENDROW(myTable, "10")

DTW_TB_COLS

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)

參數

表 121. DTW_TB_COLS 參數

資料類型	參數	使用	說明
表格	`table`	IN	傳回直欄數目的巨集表格變數。
整數	`cols`	OUT	一個包含在 `table` 中之直欄數目的變數。

回覆碼

表 122. DTW_TB_COLS 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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>我的表格包含 @DTW_TB_rCOLS(myTable) 個直欄。

DTW_TB_DELETECOL

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)

參數

表 123. DTW_TB_DELETECOL 參數

資料類型	參數	使用	說明
表格	`table`	INOUT	將刪除其直欄的巨集表格變數。
整數	`after_col`	IN	將在該直欄後刪除後續直欄的直欄號碼。若要刪除第一個直欄，請指定 `0`。
整數	`cols`	IN	從 `table` 刪除的直欄數目。

回覆碼

表 124. DTW_TB_DELETECOL 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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")

DTW_TB_DELETEROW

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)

參數

表 125. DTW_TB_DELETEROW 參數

資料類型	參數	使用	說明
表格	`table`	INOUT	其中橫列被刪除的巨集表格變數。
整數	`start_row`	IN	`table` 中將刪除的第一列的橫列號碼。
整數	`rows`	IN	從 `table` 所刪除之橫列數。

回覆碼

表 126. DTW_TB_DELETEROW 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
1003	函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1004	函數呼叫上傳遞的參數必須是 Net.Data 巨集表變數，但卻是不同的變數類型。
1005	函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007	參數包含的值無效。
1008	參數超出表格界限。

用法注意事項

呼叫 DTW_TB_DELETEROW() 之前，您必須設定表格的直欄數目。您可以使用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函數，或將表格傳送到將被設定的語言環境中來設定直欄的數目。

範例

範例 1：刪除表格中第 10 列開始的 5 列。

%DEFINE myTable = %TABLE
 
@DTW_TB_DELETEROW(myTable, "10", "5")

範例 2：刪除表格中所有的橫列

%DEFINE myTable = %TABLE
 
@DTW_TB_DELETEROW(myTable, "1", @DTW_TB_rROWS(myTable))

DTW_TB_DLIST

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)

參數

表 127. DTW_TB_DLIST 參數

資料類型	參數	使用	說明
表格	`table`	IN	指定巨集表格變數來顯示為 HTML 列示的符號。
整數	`term`	IN	在 `table` 中的直欄號碼，其包含 `term` 名稱值（在 `<DT>` 標籤之後的本文）。預設值是使用第一欄。
整數	`def`	IN	在 `table` 中的直欄號碼，其包含 term 定義值（在 `<DD>` 標籤之後的本文）。預設值是使用第二直欄。
字串	`termstyle`	IN	一個包含 `term` 名稱值之 HTML 元素列示的變數或文字字串。預設值是使用沒有樣式的標籤。
字串	`defstyle`	IN	一個包含 `term` 定義值之 HTML 元素列示的變數或文字字串。預設值是使用沒有樣式的標籤。
字串	`link`	IN	指定哪一個 HTML 元素是由 HTML 鏈結所產生的。有效的值有 DT 和 DD。預設值是不產生 HTML 鏈結。
整數	`link_u`	IN	在包含 HTML 參照的 URL 之 `table` 中的欄號碼。預設值是不產生 HTML 鏈結。
字串	`image`	IN	指定列入壓縮檔所產生的是哪一個 HTML 元素。有效的值有 DT 和 DD。預設值是不產生列入壓縮檔（DT）。
整數	`image_u`	IN	在包含列入壓縮檔之 URL 之 `table` 中的欄號碼。預設值是不產生列入壓縮檔。

回覆碼

表 128. DTW_TB_DLIST 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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>

DTW_TB_DUMPH

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)

參數

表 129. DTW_TB_DUMPH 參數

資料類型	參數	使用	說明
表格	`table`	IN	指定要顯示之巨集表格變數的符號。

回覆碼

表 130. DTW_DB_DUMPH 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
1003	函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1004	函數呼叫上傳遞的參數必須是 Net.Data 巨集表變數，但卻是不同的變數類型。
1007	參數包含的值無效。

用法注意事項

如果 Net.Data 表格是空的，則傳回錯誤。

範例

範例 1：

@DTW_TB_DUMPH(Mytable)

由這個範例所產生的 HTML 看起來類似這個：

<PRE>
名稱             部門                    職位
Jack Smith       Internet 技術           軟體工程師
Helen Williams   資料庫                  開發部經理
Alex Jones       製造                    工業工程師
Tom Baker        採購                    業務代表
</PRE>

DTW_TB_DUMPV

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)

參數

表 131. DTW_TB_DUMPV 參數

資料類型	參數	使用	說明
表格	`table`	IN	指定要顯示之巨集表格變數的符號。

回覆碼

表 132. DTW_TB_DUMPV 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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>

DTW_TB_GETN

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)

參數

表 133. DTW_TB_GETN 參數

資料類型	參數	使用	說明
表格	`table`	IN	傳回一個直欄名稱的巨集表格變數。
整數	`col`	IN	將被傳回名稱的直欄的直欄號碼。
字串	`name`	OUT	包含在 `col` 中被指定之直欄名稱的變數。

回覆碼

表 134. DTW_TB_GETN 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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>最後一欄的直欄名稱是 @DTW_TB_rGETN(myTable, @DTW_TB_rCOLS(myTable))

DTW_TB_GETV

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)

參數

表 135. DTW_TB_GETV 參數

資料類型	參數	使用	說明
表格	`table`	IN	傳回表格值的巨集表格變數。
整數	`row`	IN	傳回值的列號。
整數	`col`	IN	傳回值的欄號。
字串	`value`	OUT	包含 `row` 和 `col` 所指定的橫列與直欄值的變數。

回覆碼

表 136. DTW_TB_GETV 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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>橫列 1，直欄 1 的表格值是 @DTW_TB_rGETV(myTable, "1", "1")。

DTW_TB_HTMLENCODE

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)

參數

表 137. DTW_TB_HTMLENCODE 參數

資料類型	參數	使用	說明
表格	`table`	INOUT	所要修改的巨集表格變數。
字串	`collist`	IN	在 `table` 中所要編碼的直欄號碼。預設值是對所有的直欄進行編碼。

回覆碼

表 138. DTW_TB_HTMLENCODE 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
1003	函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1004	函數呼叫上傳遞的參數必須是 Net.Data 巨集表變數，但卻是不同的變數類型。
1005	函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007	參數包含的值無效。
1008	參數超出表格界限。

用法注意事項

下表列出被置換的字元。

名稱	字元	程式碼
＆記號	&	&
雙引號	"	"
大於	>	>
小於	<	<

範例

範例 1：

@DTW_TB_HTMLENCODE(Mytable, "3 4")

在指定的表格之直欄 3 和直欄 4 中的特殊字元被它們的編碼格式所置換。

DTW_TB_INPUT_CHECKBOX

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` 之`列`的列示。預設值是不檢查欄位。

回覆碼

表 140. DTW_TB_INPUT_CHECKBOX 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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>

DTW_TB_INPUT_RADIO

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)

參數

表 141. DTW_TB_INPUT_RADIO 參數

資料類型	參數	使用	說明
表格	`table`	IN	顯示為圓鈕輸入標籤的巨集表格變數。
字串	`prompt`	IN	在 `table` 中或包含顯示於圓鈕旁邊之文字字串的直欄號碼。必要的參數，但是可以包含一個空 ("") 值。當 `prompt` 是空值時，請使用 `valuecol` 的值。
字串	`namecol`	IN	在 `table` 中的直欄號碼或包含輸入欄位名稱的字串。
整數	`valuecol`	IN	`table` 中包含輸入欄位值的直欄號碼。
字串	`rows`	IN	在產生輸入欄位之 `table` 之列的列示。預設值是使用所有的列。
整數	`checkedrows`	IN	在 `table` 中的列號碼顯示所勾選之相對應的圓鈕。只有一個值是被允許的。

回覆碼

表 142. DTW_TB_INPUT_RADIO 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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>

DTW_TB_INPUT_TEXT

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)

參數

表 143. DTW_TB_INPUT_TEXT 參數

資料類型	參數	使用	說明
表格	`table`	IN	顯示為文字輸入標籤的巨集表格變數。
字串	`prompt`	IN	在 `table` 中的欄號碼或包含顯示在輸入欄旁之文字的字串。如果`提示`是空值，則不會顯示文字。
字串	`namecol`	IN	`table` 中包含輸入欄位名稱的直欄號碼。
整數	`valuecol`	IN	`table` 中包含預設輸入欄位值的直欄號碼，它是指定給 INPUT 標籤上的 VALUE 屬性。預設值是不產生 VALUE 屬性值。
整數	`size`	IN	輸入欄位的字元號碼，其為 INPUT 標籤上 SIZE 屬性所指定的。預設值是最長預設輸入值的長度，或者如果沒有預設輸入時則是 10。
整數	`maxlen`	IN	輸入字串的最大長度，是為 INPUT 標籤之 MAXLENTH 屬性所指定的。預設值是不產生 MAXLENGTH 屬性值。
整數	`rows`	IN	在產生輸入欄位之 `table` 之列的列示。預設值是使用所有的列。

回覆碼

表 144. DTW_TB_INPUT_TEXT 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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">

DTW_TB_INSERTCOL

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)

參數

表 145. DTW_TB_INSERTCOL 參數

資料類型	參數	使用	說明
表格	`table`	INOUT	其中將插入直欄的巨集表格變數。
整數	`after_col`	IN	直欄號碼，將在該欄之後插入新直欄。若要在表格起始處插入直欄，請指定 `0`。
整數	`cols`	IN	將插入 `table` 中的直欄數目。

回覆碼

表 146. DTW_TB_INSERTCOL 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
1003	函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1004	函數呼叫上傳遞的參數必須是 Net.Data 巨集表變數，但卻是不同的變數類型。
1005	函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007	參數包含的值無效。
1008	參數超出表格界限。

範例

範例 1：在表格最後插入 5 欄直欄

%DEFINE myTable = %TABLE
 
@DTW_TB_INSERTCOL(myTable, @DTW_TB_rCOLS(myTable), "5")

範例 2：在表格起始處插入一直欄

%DEFINE myTable = %TABLE
 
@DTW_TB_INSERTCOL(myTable, "0", "1")

DTW_TB_INSERTROW

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)

參數

表 147. DTW_TB_INSERTROW 參數

資料類型	參數	使用	說明
表格	`table`	INOUT	其中將插入橫列的巨集表格變數。
整數	`after_row`	IN	橫列號碼，在該列後將插入新的橫列。若要在表格起始處插入橫列，請指定 `0`。
整數	`rows`	IN	插入 `table` 中之橫列數。

回覆碼

表 148. DTW_TB_INSERTROW 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
1003	函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1004	函數呼叫上傳遞的參數必須是 Net.Data 巨集表變數，但卻是不同的變數類型。
1005	函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007	參數包含的值無效。
1008	參數超出表格界限。

用法注意事項

呼叫 DTW_TB_INSERTROW() 之前，請設定表格的直欄數目。您可以使用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函數，或將表格傳送到將被設定的語言環境中來設定直欄的數目。

範例

範例 1：在表格中的第 5 橫列後插入一橫列

%DEFINE myTable = %TABLE
 
@DTW_TB_INSERTROW(myTable, "5", "1")

範例 2：在表格起始處插入 3 列橫列

%DEFINE myTable = %TABLE
 
@DTW_TB_INSERTROW(myTable, "0", "3")

DTW_TB_LIST

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)

參數

表 149. DTW_TB_LIST 參數

資料類型	參數	使用	說明
表格	`table`	IN	指定巨集表格變數顯示當作 HTML 列示的符號。
字串	`listtype`	IN	所要產生的列示類型。可接受的值包括： DIR MENU OL UL
整數	`listitem`	IN	在 `table` 中的直欄號碼包含列表值（在 <LI> 標籤之後的本文）。預設值是使用第一欄。
字串	`itemstyle`	IN	一個包含詞彙名稱值之 HTML 元素列示的變數或文字字串。預設值是使用沒有樣式的標籤。
整數	`link_u`	IN	在包含 HTML 鏈結的 URL 之 `table` 中的欄號碼。如果並未指定這個值，則將不會產生 HTML 鏈結。
整數	`image_u`	IN	在包含列入壓縮檔之 URL 之 `table` 中的欄號碼。如果並未指定這個值，則將不會產生列入壓縮檔。

回覆碼

表 150. DTW_TB_LIST 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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>

DTW_TB_QUERYCOLNONJ

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)

參數

表 151. DTW_TB_QUERYCOLNONJ 參數

資料類型	參數	使用	說明
表格	`table`	IN	將傳回直欄數目的巨集表格變數。
字串	`name`	IN	將傳回其直欄號碼的欄位標題的名稱。若表格中不存在欄位標題，將傳回 `0`。
整數	`col`	OUT	含有直欄號碼的變數，此直欄的名稱是在 `name`中指定的。

回覆碼

表 152. DTW_TB_QUERYCOLNONJ 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
1003	函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1004	函數呼叫上傳遞的參數必須是 Net.Data 巨集表變數，但卻是不同的變數類型。
1005	函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1006	文字字串傳遞給函數呼叫中的參數，但此參數必須是輸出參數。

用法注意事項

呼叫 DTW_TB_QUERYCOLNONJ() 之前，請設定表格的直欄數目。您可以使用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函數，或將表格傳送到將被設定的語言環境中來設定直欄的數目。
若表格中不存在欄位標題，將傳回 0。

範例

範例 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")

DTW_TB_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 表格中的橫列數目。

格式

@DTW_TB_ROWS(table, rows)

@DTW_TB_rROWS(table)

參數

表 153. DTW_TB_ROWS 參數

資料類型	參數	使用	說明
表格	`table`	IN	傳回現行列數的巨集表格變數。
整數	`rows`	OUT	包含在 `table` 中之現行列數的變數。

回覆碼

表 154. DTW_TB_ROWS 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
1003	函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1004	函數呼叫上傳遞的參數必須是 Net.Data 巨集表變數，但卻是不同的變數類型。
1005	函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1006	文字字串傳遞給函數呼叫中的參數，但此參數必須是輸出參數。

範例

範例 1：取回表格中的現行列數，並將值指定到 rows

%DEFINE myTable = %TABLE
%DEFINE rows = ""
...
@FillTable(myTable)
...
@DTW_TB_ROWS(myTable, rows)

DTW_TB_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 表格產生 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)

參數

表 155. DTW_TB_SELECT 參數

資料類型	參數	使用	說明
表格	`table`	IN	顯示為 SELECT 欄位的巨集表格變數。
字串	`name`	IN	SELECT 欄位之 NAME 屬性的值。
整數	`optioncol`	IN	在 `table`（該表格具有使用在 SELECT 欄位中之 OPTION 標籤中的值）中的直欄號碼。預設值是使用第一欄。
整數	`size`	IN	在使用作為在 SELECT 欄位中之 OPTION 標籤之 `table` 中的列號碼。預設值是使用所有的列。
字串	`multiple`	IN	指定是否允許所作的多重選擇。預設值是 N，表示不允許多重選擇。
字串	`rows`	IN	從 `table` 選取，要使用在 SELECT 欄位中的列。預設值是使用所有的列。
字串	`selectedrows`	IN	從已檢查過標籤之表格中選取列的列示。若要指定多於一行，您必須將多重參數設定為 Y。預設值是選取第一個項目。
字串	valuecol	IN	表格中用於 OPTION 標籤的 VALUE 屬性之直欄號碼。這個參數是可選用的。

回覆碼

表 156. DTW_TB_SELECT 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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>

DTW_TB_SETCOLS

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)

參數

表 157. DTW_TB_SETCOLS 參數

資料類型	參數	使用	說明
表格	`table`	INOUT	設定直欄數目的巨集表格變數。
整數	`cols`	IN	`table` 中配置的起始直欄數目。

回覆碼

表 158. DTW_TB_SETCOLS 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
1003	函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1004	函數呼叫上傳遞的參數必須是 Net.Data 巨集表變數，但卻是不同的變數類型。
1005	函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007	參數包含的值無效。

用法注意事項

一個表格僅能使用一次 DTW_TB_SETCOLS() 函數。然後，使用 DTW_TB_DELETECOL() 或 DTW_TB_INSERTCOL() 函數，變更表格中的直欄數目。
使用 DTW_TB_SETN() 函數指定欄位標題。

範例

範例 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")

DTW_TB_SETN

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)

參數

表 159. DTW_TB_SETN 參數

資料類型	參數	使用	說明
表格	`table`	INOUT	將設定直欄名稱的巨集表格變數。
字串	`name`	IN	指定為 `col` 中所指定直欄之欄位標題的字串。
整數	`col`	IN	將設定標題之直欄的直欄號碼。

回覆碼

表 160. DTW_TB_SETN 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
1003	函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1004	函數呼叫上傳遞的參數必須是 Net.Data 巨集表變數，但卻是不同的變數類型。
1005	函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007	參數包含的值無效。
1008	參數超出表格界限。

用法注意事項

呼叫 DTW_TB_SETN() 之前，請設定表格的直欄數目。您可以使用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函數，或將表格傳送到將被設定的語言環境中來設定直欄的數目。
若要刪除欄位標題，請將欄位標題值指定為 NULL。

範例

範例 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")

DTW_TB_SETV

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)

參數

表 161. DTW_TB_SETV 參數

資料類型	參數	使用	說明
表格	`table`	INOUT	將設定表格值的巨集表格變數。
字串	`value`	IN	指定為 `row` 與 `col` 中指定的橫列與直欄的表格值的字串。
整數	`row`	IN	將設定值的橫列號碼。
整數	`col`	IN	將設定值的直欄號碼。

回覆碼

表 162. DTW_TB_SETV 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
1003	函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1004	函數呼叫上傳遞的參數必須是 Net.Data 巨集表變數，但卻是不同的變數類型。
1005	函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007	參數包含的值無效。
1008	參數超出表格界限。

用法注意事項

呼叫 DTW_TB_SETV() 之前，請設定表格的直欄數目。您可以使用 DTW_TB_SETCOLS() 或 DTW_TB_INSERTCOL() 函數，或將表格傳送到將被設定的語言環境中來設定直欄的數目。
若要刪除表格值，請將該值指定為 NULL。

範例

範例 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")

DTW_TB_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_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)

參數

表 163. DTW_TB_TABLE 參數

資料類型	參數	使用	說明
表格	`table`	IN	顯示為 HTML 表格的巨集表格變數。
字串	`options`	IN	位於 TABLE 標籤中的表格屬性。預設值示不使用屬性。有效的值包括： BORDER CELLSPACING WIDTH
字串	`collist`	IN	使用在 HTML 表格中之 `table` 的欄號碼。預設值是使用所有的欄。
字串	`cellstyle`	IN	HTML 樣式元素的列示，例如 B 和 I, 是圍繞在每個 TD 標籤旁的文字。預設值是不使用樣式標籤。
整數	`link_u`	IN	在包含使用來建立 HTML 鏈結之 URL 的 `table` 中的欄號碼。您必需也在 `collist` 中指定欄。預設值是不產生 HTML 鏈結。
整數	`image_u`	IN	在包含使用來建立列入壓縮檔之 URL 的 `table` 中的欄號碼。您必需也在 `collist` 中指定欄。預設值是不產生壓縮檔標籤。
整數	`url_text`	IN	在 `table` 中包含顯示 HTML 鏈結或列入壓縮檔的文字的欄號碼。預設值是使用 URL 它本身。
字串	`url_style`	IN	指定在 `url_text` 中文字之 HTML 樣式元素的列示。預設值是不產生樣式標籤。

回覆碼

表 164. DTW_TB_TABLE 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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>

DTW_TB_TEXTAREA

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)

參數

表 165. DTW_TB_TEXTAREA 參數

資料類型	參數	使用	說明
表格	`table`	IN	一個顯示為 TEXTAREA 標籤的巨集表格變數。
字串	`name`	IN	文字區域的名稱。
整數	`numrows`	IN	指定在列中之本文區域的高度。預設值是在 `table` 中的列數。
整數	`numcols`	IN	指定在欄中之本文區域的寬度。預設值是在 `table` 中的最長列的長度。
整數	`valuecol`	IN	其值顯示在本文區域中的 `table` 直欄號碼。預設值是第一直欄。
字串	`rows`	IN	在 `table` 中用來產生 TEXTAREA 標籤的列。預設值是使用所有的列。

回覆碼

表 166. DTW_TB_TEXTAREA 回覆碼

回覆碼	說明
-1001	伺服器無法處理 Net.Data 的配置記憶體要求。
1001	輸入參數包含 NULL 值。
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>

[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]