cfapplet

Description

This tag references a registered custom Java applet. To register a Java applet, in the ColdFusion Administrator, click Extensions > Java Applets.

Using this tag within a cfform tag is optional. If you use it within cfform, and the method attribute is defined in the Administrator, the return value is incorporated into the form.

Syntax

<cfapplet 
   appletSource = "applet_name"
   name = "form_variable_name"
   height = "height_in_pixels"
   width = "width_in_pixels"
   vSpace = "space_above_and_below_in_pixels"
   hSpace = "space_on_each_side_in_pixels"
   align = "alignment_option"
   notSupported = "message_to_display_for_nonJava_browser"
   param_1 = "applet_parameter_name"
   param_2 = "applet_parameter_name"
   param_n = "applet_parameter_name">

History

ColdFusion MX:

Removed the requirement that you use this tag within a cfform tag.
Changed the behavior when this tag is used within a cfform tag; if the method attribute is defined in the Administrator, the return value of the applet's method is incorporated into the form.

Attributes

Attribute	Req/Opt	Default	Description
appletSource	Required		Name of registered applet
name	Required		Form variable name for applet
height	Optional		Height of applet, in pixel
width	Optional		Width of applet, in pixels
vSpace	Optional		Space above and below applet, in pixels
hSpace	Optional		Space on left and right of applet, in pixels
align	Optional		Alignment: Left Right Bottom Top TextTop Middle AbsMiddle Baseline AbsBottom
notSupported	Optional	See Description	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. For example: notSupported = "<b>Browser must support Java to view ColdFusion Java Applets</b>" Default: <b>Browser must support Java to<br> view ColdFusion Java Applets!</b>
param_n	Optional		Registered parameter for applet. Specify only to override values for applet in ColdFusion Administrator.

Usage

You can specify the applet method attribute only in the Administrator, Java Applets view. For other attributes, you can accept the default values in the Administrator view, or specify values in this tag and override the defaults.

If Java applet components are stored in a JAR file, enter the filename in the ColdFusion Administrator, Java Applets window, Archive text box. For more information, see Embedding Java applets in Building Dynamic Forms with cfform Tags in ColdFusion MX Developer's Guide

Example

<p>cfapplet lets you reference custom Java applets that have been 
   registered using the ColdFusion Administrator.
<p>To register a Java applet, open the ColdFusion Administrator and 
   click "Applets" link under "extensions" section.
<p>This example applet copies text that you type into a form. Type 
   some text, and then click "copy" to see the copied text.

<cfform action = "index.cfm">
   <cfapplet appletsource = "copytext" name = "copytext">
</cfform>

View comments in LiveDocs