Macromedia coldfusion 4.5-cfml language reference User Manual

Page of 608
Chapter 1:  ColdFusion Tags
141
Likewise, if the custom tag uses a CFASSOCIATE tag to save its attributes, the attributes 
passed with ATTRIBUTECOLLECTION are saved as independent attribute values with 
no indication that the attributes are grouped into a structure by the custom tag’s caller.
Example
<!--- This example shows the use of CFMODULE --->
<HTML>
<HEAD>
<TITLE>CFMODULE Example</TITLE>
</HEAD>
<BODY>
<H3>CFMODULE Example</H3>
<P>
This example shows the use of CFMODULE to call a sample custom 
tag inline.
</P>
<P>
This example makes use of a sample custom tag that has been saved in the 
file myTag.cfm in the snippets directory. You can also save ColdFusion 
custom tags in the Cfusion\CustomTags directory. For more information 
about using Custom Tags, please refer to 
<i>Developing Web Applications</i>.
</P>
<!--- show the code in the custom tag--->
<P>Here is the code in the custom tag.</P>
<CFOUTPUT>#HTMLCodeFormat("<CFSET X = attributes.x>
<CFSET Y = attributes.y>
<CFSET A = attributes.value1>
<CFSET B = attributes.value2>
<CFSET C = attributes.value3>
<CFSET caller.result = x + y + a + b + c>")#
</CFOUTPUT>
<!--- end sample tag --->
<CFSET attrCollection1 = StructNew()>
<CFSET attrCollection1.value1 = 22>
<CFSET attrCollection1.value2 = 45>
<CFSET attrCollection1.value3 = 88>
<!--- Call the tag with CFMODULE with Name--->
<CFMODULE 
   Template="..\snippets\myTag.cfm"
X="3"
attributeCollection=#attrCollection1# 
Y="4">
<!--- show the code --->
<P>Here is one way in which to invoke the custom tag, 
using the TEMPLATE attribute.</P>
<CFOUTPUT>#HTMLCodeFormat("<CFMODULE
Template=""..\snippets\myTag.cfm""
X=3