Adobe ColdFusion 8

cfapplet

描述

这个标签参考了一个自定制的java applet程序,要注册这个java applet,在 ColdFusion 的管理器中, 选择 Extensions > Java Applets.

在cfform标签中使用不使用这个标签是可选的 。如果你在 cfform中使用它 , 并在Administrator中定义method 的属性,那么返回的值就会被注册到 form里面.

类别

Form标签

语法

<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">

注: 你可以在attributeCollection 中指定这个标签的属性，作为一个结构的value,在attributeCollection 中指定结构的名称,并使用这个标签的属性名称作为这个结构的Keys.

属性

属性

必须/可选

默认

描述

appletSource

必须

 

注册的applet程序的名字

name

必须

 

applet程序的表单变量名

align

可选

 

对齐方式:

  • Left
  • Right
  • Bottom
  • Top
  • TextTop
  • Middle
  • AbsMiddle
  • Baseline
  • AbsBottom

高度

可选

 

applet程序的高度, 以 pixels为单位.

hSpace

可选

 

applet程序的水平两边的间隙, 以 pixels为单位.

notSupported

可选

请看描述

如果页面包含了一个applet为基础的java 控制表单 ,如果它被一个不支持java的浏览器打开,那么页面就会显示这个属性定义的文字.例如:

notSupported = "<b>Browser must support Java to view ColdFusion Java Applets</b>"

默认设为:

<b>Browser must support Java to<br> view ColdFusion Java Applets!</b>

param_n

可选

 

applet参数的名称只要指定一个参数覆盖原先那些在 ColdFusion Administrator中指定的.

vSpace

可选

 

垂直上下方的间隙,以 pixels为单位.

宽度

可选

 

applet程序的宽度, 以 pixels为单位.

用途

你可以只在 Administrator里指定 applet程序的method 属性, Java Applets 视图.对于其他的属性,你可以在Administrator 视图里面接受默认值,或者在这个标签里另行定义覆盖默认的值.

如果Java Applets组件是被保存在一个JAR 文件中，在J2EE Archives > ColdFusion Administrator 输入信息。更多信息，请点击链接 Embedding Java applets

范例

<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>