CFAPPLET  
説明

このタグからは、登録されているカスタム Java アプレットが参照されます。Java アプレットを登録するには、ColdFusion Administrator で、[拡張機能]-[Java アプレット] をクリックします。

cfform タグ内でのこのタグの使用はオプションです。cfform 内で cfapplet タグを使用し、Administrator で method 属性が定義されている場合は、戻り値がフォームに取り込まれます。

 
カテゴリ

フォームタグ

 
シンタックス
<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">
 
関連項目

cfform、cfformgroup、cfformitem、cfgrid、cfinput、cfobject、cfselect、cfservlet、cfslider、cftextarea、cftree

 
ヒストリ

ColdFusion MX:

  • このタグを cfform タグ内で使用するという必要条件はなくなりました。
  • このタグを cfform タグ内で使用した場合の動作が変わりました。具体的には、Administrator 内で method 属性が定義されていると、アプレットのメソッドの戻り値がフォームに取り込まれます。

属性 必須/
オプション
デフォルト 説明

appletSource

必須

 

登録されているアプレットの名前です。

name

必須

 

アプレットのフォーム変数名です。

height

オプション

 

アプレットの高さです (単位 : ピクセル)。

width

オプション

 

アプレットの幅です (単位 : ピクセル)。

vSpace

オプション

 

アプレットの垂直方向の余白です (単位 : ピクセル)。

hSpace

オプション

 

アプレットの左右の余白です (単位 : ピクセル)。

align

オプション

 

配置を表します。

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

notSupported

オプション

「説明」を参照

Java アプレットベースの cfform コントロールが含まれているページを、Java がサポートされていない (または Java のサポートが無効になっている) ブラウザで開いた場合に表示するテキストです。例 :

notSupported = "<b>ColdFusion の Java アプレットを表示するには、

ブラウザが Java に対応していなければなりません。</b>"

デフォルト :

<b>ColdFusion Java アプレットを表示するには、<br>ブラウザが Java をサポートしている必要があります。</b>

param_n

オプション

 

アプレットの登録済みパラメータです。ColdFusion Administrator 内のアプレットの値を上書きする場合にのみ指定します。

 
使用方法

アプレットの method 属性は、Administrator の [Java アプレット] ビューでのみ指定できます。他の属性については、[Administrator] ビューのデフォルト値をそのまま使用するか、またはこのタグ内で値を指定してデフォルト値を上書きすることができます。

Java アプレットコンポーネントが JAR ファイルに保管されている場合は、ColdFusion Administrator の [Java アプレット] ウィンドウの [アーカイブ] テキストボックスに、そのファイル名を入力します。詳細については、『ColdFusion MX 開発ガイド』の第27章の「cfform タグによるダイナミックフォームの作成」 の「Java アプレットの埋め込み」を参照してください。

 
<p>cfapplet により、ColdFusion Administrator を使用して登録したカスタム Java 
   アプレットを参照できます。
<p>Java アプレットを登録するには、ColdFusion Administrator を開き、[拡張機能] 
   セクションの [アプレット] リンクをクリックします。
<p>この例のアプレットは、ユーザーがフォームに入力したテキストをコピーします。テキストを
   入力して [copy] をクリックすると、コピーされたテキストが表示されます。

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