User Guide

346 Chapter 2: ColdFusion Tags
completePath Optional No; tree
name is
returned as
root
• Yes: passes the root part of
treename.path form variable
when
cftree is submitted
• No, or omitted: root level of form variable is not passed;
path value starts with the first node
For the
preserveData attribute of cfform to work with the
tree, you must set this attribute to Yes.
If you specify a root name for a tree item with
cftreeitem
queryasroot, that value is returned. If you do not specify a
root name, ColdFusion returns the query name as the root.
appendKey Optional Yes • Yes: when used with href, passes CFTREEITEMKEY
variable with the value of the selected tree item in URL to
the application page specified in the
cfform action
attribute
• No
highlightHref Optional Yes • Yes: highlights links that are associated with a
cftreeitem
with a
URL attribute value
• No: disables highlight
onValidate Optional JavaScript function to validate user input. The form object,
input object, and input object value are passed to the
specified routine, which should return True if validation
succeeds; False, otherwise.
message Optional Message to display if validation fails.
onError Optional JavaScript function to execute if validation fails.
lookAndFeel Optional windows • motif: renders slider in Motif style
• windows: renders slider in Windows style
• metal: renders slider in Java Swing style
If platform does not support style option, tag defaults to
platform default style.
font Optional Font name for data in tree control.
fontSize Optional Font size for text in tree control, in points.
italic Optional No • Yes: displays tree control text in italics
• No
bold Optional No • Yes: displays tree control text in bold
• No
height Optional 320 Tree control height, in pixels.
width Optional 200 Tree control width, in pixels.
vSpace Optional Vertical margin above and below tree control, in pixels.
hSpace Optional Horizontal spacing to left and right of tree control, in pixels.
Attribute Req/Opt Default Description