change イベント

説明

このイベントは、フォームの入力者が次のいずれかのアクションを実行してフィールドのコンテンツを変更するときに開始されます。

  • フィールドにキーボードフォーカスを与えるキーストロークを入力する

  • フィールドにデータを貼り付ける

  • リストボックスまたはコンボボックスからの選択を行う

  • チェックボックスを選択または選択解除する

  • 一連のラジオボタンの設定を変更する

    演算またはスクリプトの結果としてのオブジェクトの値の変更に応答して、またはフォームデザインとデータの結合によってこのイベントが開始されることはありません。

タイプ

インタラクティブイベント

サポート

クライアントアプリケーション

使用の可否

Acrobat および Adobe Reader

○

HTML ブラウザー

○

（コンボボックスの場合のみ）

バージョン

XFA 2.1

例

フォームの入力者によるフィールドの値の変更に応答して開始する必要のある演算またはスクリプトにはこのイベントを使用します。例えば、change イベントをコンボボックスで使用して、テーブル内の特定の行をハイライト表示することができます。この方法を使用すると、フォームの入力者がコンボボックスで値を選択するたびに、対応するテーブル行がハイライト表示されます。

注意： オブジェクトの 'this.rawValue' に対するスクリプティングは機能しません。オブジェクトの現在の値を取得するには、イベントモデルのプロパティ $event.fullText を代わりに使用します。

change イベントの詳しい使用例については、コンボボックスの現在または以前の値の取得を参照してください。