User Guide

cftreeitem 349
cftreeitem
Description
Populates a form tree control, created with the cftree tag, with elements. To display icons, you
can use the
img values that ColdFusion provides, or reference your own icons.
Category
Forms tags
Syntax
<cftreeitem
value = "text"
display = "text"
parent = "parent_name"
img = "filename"
imgopen = "filename"
href = "URL"
target = "URL_target"
query = "queryname"
queryAsRoot = "Yes" or "No"
expand = "Yes" or "No">
See also
cfapplet, cfform, cfgrid, cfgridcolumn, cfgridrow, cfgridupdate, cfinput,
cfselect, cfslider, cftextinput, cftree
Attributes
Attribute Req/Opt Default Description
value Required Value passed when
cfform is submitted. When populating a
tree with data from a
cfquery, specify columns in a delimited
list. Example:
value = "dept_id,emp_id"
display Optional value Tree item label. When populating a tree with data from a query,
specify names in a delimited list. Example:
display =
"dept_name,emp_name"
parent Optional Value for tree item parent.
img Optional folder Image name, filename, or file URL for tree item icon.
The following values are provided:
• cd
• computer
• document
• element
• folder
• floppy
• fixed
• remote
You can specify a custom image. To do so, include path and
file extension; for example:
img = "../images/page1.gif"
To specify more than one image in a tree, or an image at the
second or subsequent level, use commas to separate names,
corresponding to level; for example:
img = "folder,document"
img = ",document" (example of second level)