User Guide

cftree 429
History
ColdFusion MX 7:
• Added the format attribute and support for generating Flash and XML and object output.
• Added enabled, onChange, style, tooltip, and visible attributes (Flash format only).
ColdFusion MX: Changed behavior: ColdFusion renders a tree control regardless of whether
there are any
treeitems within it.
Attributes
Note: In XML format, ColdFusion MX passes all attributes to the XML. The supplied XSLT skins do
not handle or display XML format trees, but do display applet and Flash format trees.
Attribute Req/Opt
Format
Default Description
name Required;
All
Name for tree control.
format Optional;
All
applet • applet: displays the tree using a Java applet in the
browser.
• flash: displays the tree using a Flash control
• object: returns the tree as a ColdFusion structure with the
name specified by the
name attribute, For details of the
structure contents, see “object format”.
• xml: generates an XML representation of the tree.
In XML format forms, includes the generated XML in the
form.
In HTML format forms, puts the XML in a string variable
with the name specified by the
name attribute.
required Optional;
Applet,
Flash
No • Yes: user must select an item in the tree control.
• No
delimiter Optional;
All
\\ Character to separate elements in the Forms.treename.path
variable of the action page.
completePath Optional;
Applet,
object
No • Yes: starts the Form.treename.path variable with the root
of the tree path when
cftree is submitted.
• No: omits the root level from the Form.treename.path
variable; the value starts with the first child node in the
tree.
For the
preserveData attribute of cfform to work with the
tree, you must set this attribute to Yes.
For tree items populated by a query, if you use the
cftreeitem queryasroot attribute to specify a root name,
that value is returned. If you do not specify a root name,
ColdFusion returns the query name.