cftree

Overview ColdFusion Open BlueDragon Lucee

Inserts a tree control in a form. Validates user selections. Used within a cftree tag block. You can use a CFML query to supply data to the tree.

Attributes

Name Required Type Default Description
align No String Alignment of the tree control applet object.
appendkey No Boolean true - true: if you use cftreeitem href attributes, ColdFusion appends a CFTREEITEMKEY query string variable with the value of the selected tree item to the cfform action URL. - false: do not append the tree item value to the URL. Default: true
bold No Boolean false - true: displays tree control text in bold - false: it does not Default: false
border No Boolean true - true: display a border around the tree control. - false: no border Default: true
8
cache No Boolean true A Boolean value that specifies whether to get new data each time the user expands tree nodes, as follows: * yes: fetches a node's child items only once, when the node is first expanded * no: fetches child items each time the node is expanded.
completepath No Boolean false - true: start the Form.treename.path variable with the root of the tree path when cftree is submitted. - false: omit 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. Default: false
delimiter No String \\ Character to separate elements in form variable path. Default: \\
enabled No Boolean true Flash only: Boolean value specifying whether the control is enabled. A disabled control appears in light gray. Default: true
font No String arial Font name for data in tree control.
fontsize No Numeric Font size for text in tree control, in points.
format No String 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", below. - xml: Generates an XMLrepresentation of the tree. In XML format forms, includes the generated XML in the form. and puts the XML in a string variable with the name specified by the name attribute. Default: applet
height No Numeric 320 Tree control height, in pixels. If you omit this attribute in Flash format, Flash automatically sizes the tree. Default: 320 (applet only)
highlighthref No Boolean true - true: highlights as a link the displayed value for any cftreeitem tag that specifies a href attribute. - false: disables highlighting. Default: true
highlightref No Yes highlights links associated with a cftreeitem with a URL attribute value. No disables highlight. Default is Yes.
hscroll No Boolean true - true: permits horizontal scrolling - false: no horizontal scrolling Default: true
hspace No Numeric Horizontal spacing to left and right of tree control, in pixels.
italic No Boolean false - true: displays tree control text in italics - false: it does not Default: false
8
label No String Valid when format="HTML"
lookandfeel No String 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. Default: windows
message No String Message to display if validation fails.
name Yes String Name for tree control.
notsupported No String Browser must support Java to
view ColdFusion Java Applets!
Text to display if a page that contains a Java applet-based cfform control is opened by a browser that does not support Java or has Java support disabled. Default: "Browser must support Java to
view ColdFusion Java Applets!
"
onblur No String Flash only: ActionScript that runs when the calendar loses focus. (Added in 7.0.1)
onchange No String Flash only: ActionScript to run when the control changes due to user action. If you specify an onChange event handler, the Form scope of the ColdFusion action page does not automatically get information about selected items. The ActionScript onChange event handler must handle all changes and selections.
onerror No String JavaScript function to execute if validation fails.
onfocus No String Flash only: ActionScript that runs when the calendar loses focus. (Added in 7.0.1)
onvalidate No String 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.
required No Boolean false - true: user must select an item in tree control - false: they do not Default: false
style No String Flash only: Must be a style specification in CSS format, with the same syntax and contents as used in Macromedia Flex for the corresponding Flash element.
tooltip No String Flash only: Text to display when the mouse pointer hovers over the control.
8
value No String Valid when format="HTML"
visible No Boolean true Flash only: Boolean value specifying whether to show the control. Space that would be occupied by an invisible control is blank. Default: true
vscroll No Boolean true - true: permits vertical scrolling - false: no vertical scrolling Default: true
vspace No Numeric Vertical margin above and below tree control, in pixels.
width No Numeric 200 Tree control width, in pixels. If you omit this attribute in Flash format, Flash automatically sizes the tree. Default: 200 (applet only)