cfapplet

Description

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

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.

Syntax

<cfapplet  
    appletSource = "applet name" 
    name = "form variable name" 
    align = "alignment option" 
    height = "height in pixels" 
    hSpace = "space on each side in pixels" 
    notSupported = "message to display for non-Java browser" 
    param_1 = "applet parameter name" 
    param_2 = "applet parameter name" 
    param_n = "applet parameter name" 
    vSpace = "space above and below in pixels" 
    width = "width in pixels">

Note: You can specify this tag’s attributes in an attributeCollection whose value is a structure. Specify the structure name in the attributeCollection and use the tag’s attribute names as structure keys.

Attributes

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

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 information in the J2EE Archives > ColdFusion Administrator. For more information, see Embedding Java applets in the Developing ColdFusion Applications

Example

cfapplet lets you reference custom Java applets that have been  
    registered using the ColdFusion Administrator. 
To register a Java applet, open the ColdFusion Administrator and  
    click "Applets" link under "extensions" section. 
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>

cfmldocs