<cfx_kmHTML> cfx_kmSuite
Programming Reference

cfx_kmHTML contains functions related to the generation of HTML controls, etc.

BigSelect
Help
 BigSelectFromQuery
 Version

F=BigSelect

Description
Generate HTML form controls to select from a list of items.
Returns
The generated HTML.
Syntax
  <cfx_kmHTML  F=BigSelect  V=variable  SHOW
      NAME=control-name
      TYPE=control-type
      VALUES=list
      LABELS=list
      DEFAULTS=list
      HEIGHT=number
      MULTIPLE
      AUTO_SUBMIT
      READONLY
      DISABLED
      ADD_NULL
      NULL_LABEL=text-string >
Attribute   Description         Required?
NAME  Name for the generated HTML form controls NAME= attribute.  YES
TYPE  Selection item type, LISTBOX, CHECKBOX or RADIO. Default=LISTBOX.  no
VALUES  Comma-separated list of selection VALUES.  YES
LABELS  Comma-separated list of selection LABELS. If LABELS is not specified, the VALUES is used for LABELS.  no
DEFAULTS  Comma-separated list of default values, initially selected.
This may be empty, a single value or a list of values.
For TYPE=RADIO, only the first default value has an effect. 		 no
HEIGHT  Selection list height.
For TYPE=LISTBOX, the default HEIGHT is 1.
For CHECKBOX and RADIO, the default=full required height. 		 no
MULTIPLE  Allow multiple selections. Applies only to TYPE=LISTBOX.  no
AUTO_SUBMIT  Automatically submit the form when an item is selected. (requires JavaScript)  no
READONLY  Display the current DEFAULTS as fixed text, with no selection possible.  no
DISABLED  Disable the HTML controls. (MSIE only)  no
ADD_NULL  Include a null-valued item at the top of the selection items.  no
NULL_VALUE  If ADD_NULL is specified, this is the value displayed for the null item.  no


Examples
<cfx_kmHTML F=BigSelect
   NAME="testSelect"
   TYPE=ListBox
   VALUES="Mary,had,a,little,lamb,its,fleece,was,white,as,snow"
   LABELS="A young lady,was in possession of,a single,small and vicious,
    furry mammal,its,fleece,was,white,as,snow"
   DEFAULTS="had,lamb"
   MULTIPLE
   HEIGHT=4
   ADD_NULL
   NULL_LABEL="-select one if you dare-" >
Result: 
<cfx_kmHTML F=BigSelect
   NAME="testSelect"
   TYPE=CheckBox
   VALUES="Mary,had,a,little,lamb,its,fleece,was,white,as,snow"
   LABELS="A young lady,was in possession of,a single,small and vicious,
    furry mammal,its,fleece,was,white,as,snow"
   DEFAULTS="had,lamb"
   MULTIPLE
   HEIGHT=4
   ADD_NULL
   NULL_LABEL="-select one if you dare-" >
Result: 
-select one if you dare-
   A young lady    
   was in possession of    
   a single    
   small and vicious    
    furry mammal    
   its    
   fleece    
   was    
    white    
   as    
   snow    
<cfx_kmHTML F=BigSelect
   NAME="testSelect"
   TYPE=Radio
   VALUES="Mary,had,a,little,lamb,its,fleece,was,white,as,snow"
   LABELS="A young lady,was in possession of,a single,small and vicious,
    furry mammal,its,fleece,was,white,as,snow"
   DEFAULTS="had,lamb"
   MULTIPLE
   HEIGHT=4
   ADD_NULL
   NULL_LABEL="-select one if you dare-" >
Result: 
-select one if you dare-
   A young lady    
   was in possession of    
   a single    
   small and vicious    
    furry mammal    
   its    
   fleece    
   was    
    white    
   as    
   snow    

F=BigSelectFromQuery

Description
Generate HTML form controls to select from a query.
Returns
The generated HTML.
Syntax
  <cfx_kmHTML  F=BigSelectFromQuery  V=variable  SHOW
      NAME=control-name
      TYPE=control-type
      QUERY=query-name
      STARTROW=number
      ENDROW=number
      VCOLUMN=column-name
      LCOLUMN=column-name
      DEFAULTS=list
      HEIGHT=number
      MULTIPLE
      AUTO_SUBMIT
      READONLY
      DISABLED
      ADD_NULL
      NULL_LABEL=text-string  >
Attribute   Description         Required?
NAME  Name for the generated HTML form controls NAME= attribute.  YES
TYPE  Selection item type, LISTBOX, CHECKBOX or RADIO. Default=LISTBOX.  no
QUERY  Name of an existing query.  YES
STARTROW  The starting row number to be read from the query. The default is to start at row #1, the first row.  no
ENDROW  The last row number to be read from the query. The default is to end at the last existing row.  no
VCOLUMN  Name of the query column to supply the selection VALUEs.  YES
LCOLUMN  Name of the query column to supply LABELs corresponding to the selection VALUEs. If LCOLUMN is not specified, VCOLUMN is used for the LABELs.  no
DEFAULTS  Comma-separated list of default values, initially selected.
This may be empty, a single value or a list of values.
For TYPE=RADIO, only the first default value has an effect. 		 no
HEIGHT  Selection list height.
For TYPE=LISTBOX, the default HEIGHT is 1.
For CHECKBOX and RADIO, the default=full required height. 		 no
MULTIPLE  Allow multiple selections. Applies only to TYPE=LISTBOX.  no
AUTO_SUBMIT  Automatically submit the form when an item is selected. (requires JavaScript)  no
READONLY  Display the current DEFAULTS as fixed text, with no selection possible.  no
DISABLED  Disable the HTML controls. (MSIE only)  no
ADD_NULL  Include a null-valued item at the top of the selection items.  no
NULL_VALUE  If ADD_NULL is specified, this is the value displayed for the null item.  no