AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X | X | X | X | X | X | X | X |
Purpose
Generates one or more HTML check box input tags from a Net.Data table.
Format
@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)
Parameters
Table 140. DTW_TB_INPUT_CHECKBOX Parameters
Data Type | Parameter | Use | Description |
---|---|---|---|
table | table | IN | The macro table variable to display as check box input tags. |
string | prompt | IN | The column number in table or a string containing the text to display next to the check box. This parameter is required but can have a null ("") value. When prompt is null, the value used is the value defined for namecol. |
string | namecol | IN | The column number in table or a string containing the input field names. |
integer | valuecol | IN | The column number in table that contains the input field values. The default is 1. |
integer | rows | IN | The list of rows in table from which to generate the input fields. The default is to use all rows. |
integer | checkedrows | IN | The list of rows specifying which rows of table to check. The default is not to check fields. |
Return Codes
Table 141. DTW_TB_INPUT_CHECKBOX Return Codes
Return Code | Explanation |
---|---|
-1001 | The server could not process a Net.Data request to allocate memory. |
1001 | An input parameter contained a NULL value. |
1002 | An input parameter contained a string value which consisted of the null-terminating character. |
1003 | An incorrect number of parameters were passed on a function call. |
1004 | A parameter passed on a function call, required to be a Net.Data macro table variable, was of a different variable type. |
1005 | A parameter passed on a function call, required to be a string variable, was of a different variable type. |
1007 | A parameter contains a value which is not valid. |
1008 | A parameter is outside of table bounds. |
Examples
Example 1: Generates HTML for three check box input tags
@DTW_TB_INPUT_CHECKBOX(Mytable,"3","4","","2 3 4","1 3 4")
Results:
<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 />