![]() ![]() ![]() |
Use CFTREEITEM to populate a tree control created with CFTREE with individual elements. You can use the IMG values supplied with ColdFusion or reference your own icons.
CFTREEITEM incorporates a Java applet, so a browser must be Java-enabled for CFTREE to work properly.
<CFTREEITEM VALUE="text" DISPLAY="text" PARENT="parent_name" IMG="filename" IMGOPEN="filename" HREF="URL" TARGET="URL_target" QUERY="queryname" QUERYASROOT="Yes/No" EXPAND="Yes/No">
Required. Value passed when the CFFORM is submitted. When populating a CFTREE with data from a CFQUERY, columns are specified in a comma-separated list:
VALUE="dept_id,emp_id"
Optional. The label for the tree item. Default is VALUE. When populating a CFTREE with data from a CFQUERY, display names are specified in a comma-separated list:
DISPLAY="dept_name,emp_name"
Optional. Value for tree item parent.
Optional. Image name or filename for the tree item. When populating a CFTREE with data from a CFQUERY, images or filenames for each level of the tree are specified in a comma-separated list.
The default image name is "Folder." A number of images are supplied and can be specified using only the image name (no file extension):
Use commas to separate image names corresponding to tree level, for example:
IMG="folder,document" IMG=",document
To specify your own custom image, specify the path and file extension:
IMG="../images/page1.gif"
Optional. Icon displayed with open tree item. You can specify the icon filename using a relative path. As with IMG, you can use an image supplied with ColdFusion.
Optional. URL to associate with the tree item or a query column for a tree that is populated from a query. If HREF is a query column, then the HREF value is the value populated by the query. If HREF is not recognized as a query column, it is assumed that the HREF text is an actual HTML HREF.
When populating a CFTREE with data from a CFQUERY, HREFs can be specified in a comma-separated list
HREF="http://dept_server,http://emp_server"
Optional. Target attribute for HREF URL. When populating a CFTREE with data from a CFQUERY, targets are specified in a comma-separated list:
TARGET="FRAME_BODY,_blank"
Optional. Query name used to generate data for the tree item.
Optional. Yes or No. Defines specified query as the root level. As in Example 1, this option prevents having to create an additional parent CFTREEITEM.
Optional. Yes or No. Yes expands tree to show tree item children. No keeps tree item collapsed. Default is Yes.
![]() ![]() ![]() |
AllaireDoc@allaire.com
Copyright © 1998, Allaire Corporation. All rights reserved.