ColdFusion 9.0 Resources |
cfpresentationDescriptionDefines the look of a dynamic slide presentation and determines whether to write the presentation files to disk. The cfpresentation tag is the parent tag for one or more cfpresentationslide tags, where you define the content for the presentation, and the cfpresenter tags, which provide information about the people presenting the slides. Syntax<cfpresentation title = "text string" authPassword = "authentication password" authUser = "authentication user name" autoPlay = "yes|no" backgroundColor = "hexadecimal color|HTML named color" control = "normal|brief" controlLocation = "right|left" destination = "filepath" directory = "pathname" format = "ppt|html" glowColor = "hexadecimal color|HTML named color" initialTab = "outline|search|notes" lightColor = "hexadecimal color|HTML named color" loop = "yes|no" overwrite = "yes|no" primaryColor = "hexadecimal color|HTML named color" proxyHost = "IP address or server name for proxy host" proxyPassword = "password for the proxy host" proxyPort = "port of the proxy host" proxyUser = "user name for the proxy host" shadowColor = "hexadecimal color|HTML named color" showNotes = "yes|no" showOutline = "yes|no" showSearch = "yes|no" textColor = "hexadecimal color|HTML named color" userAgent = "HTTP user agent identifier"> presentation content... </cfpresentation> Note: You can
specify this tag’s attributes in an attributeCollection attribute
whose value is a structure. Specify the structure name in the attributeCollection attribute
and use the tag’s attribute names as structure keys.
See alsocfchart, cfpresentationslide, cfpresenter, cfreport, Creating Slide Presentations in the Developing ColdFusion Applications Attributes
UsageUse the cfpresentation tag to create the container for a slide presentation. You can define the position and appearance of the presentation controls, the background color, and the text for the presentation. Also, use this tag to determine whether to write the presentation to files or to run it directly in the client browser. The settings in the cfpresentation tag do not affect the appearance of the content defined in the cfpresentationslide tags. destination attributeUse the following syntax to specify an in-memory file, which is not written to disk in the destination attribute. In-memory files speed processing of transient data. ram:///filepath The filepath can include directories, for example ram:///petStore/presentations/quarterlyresults.html. Create the directories in the path before you specify the file. For more information on using in-memory files, see Optimizing transient files in the Developing ColdFusion Applications. Named colorsThe cfpresentation tag supports the following named colors for use with the backgroundColor, glowColor, lightColor, primaryColor, shadowColor, and textColor attributes:
Example<!--- This example shows how to create a slide presentation from ---> <!--- an HTML file and from HTML code on the CFM page and write ---> <!--- the presentation files to a directory called myPresentation, ---> <!--- which is relative to the CFM page. ---> <cfpresentation title="Sales Presentation" directory="myPresenation"> <cfpresenter name="Shyam" title="Vice President" email="shyam@somecompany.com" image="shyam.jpg"> <cfpresenter name="Ram" title="Sr. Vice President" email="ram@somecompany.com"> <!--- The following code creates a slide from an HTML file ---> <!--- located on the ColdFusion server. ---> <cfpresentationslide src="introduction.htm" title="Introduction" presenter="Shyam" audio="myAudio.mp3" duration="36"/> <!--- The following code creates a slide from HTML code in the CFM file. ---> <cfpresentationslide> <h3>Sales</h3> <ul> <li>Overview</li> <li>Q1 Sales Figures</li> <li>Projected Sales</li> <li>Competition</li> <li>Advantages</li> <li>Long Term Growth</li> </ul> </cfpresentationslide> <!--- The following code creates a slide from HTML and CFML code. ---> <cfpresentationslide Title="Q1 Sales Figures" duration="14" presenter="Ram" audio="myAudio2.mp3"> <h3>Q1 Sales Figures</h3> <cfchart format="png" showborder="yes" chartheight="250" chartwidth="300" pieslicestyle="sliced"> <cfchartseries type="pie"> <cfchartdata item="Europe" value="9"> <cfchartdata item="Asia" value="20"> <cfchartdata item="North America" value="50"> <cfchartdata item="South America" value="21"> </cfchartseries> </cfchart> </cfpresentationslide> </cfpresentation> |