removeInstance

フォームモデルから指定したサブフォームまたはサブフォームセットを削除します。

サブフォームインスタンスを削除するときは、サブフォームのオカレンス違反が発生しないようにする必要があります。インスタンスの最小値に達している場合は、サブフォームインスタンスを削除できません。サブフォームがインスタンスの最小値に達すると、JavaScript デバッガーにより次のようなエラーメッセージが表示されます。

The element [min] has violated its allowable number of occurrences.

エンドユーザーがサブフォームの各インスタンスの削除を許可されている場合、インスタンスを削除する前に、インスタンスの最小値を 0 にリセットしてください。それ以外の場合は、最小値を下回るようなサブフォームの削除をスクリプトで一切試行しないようにする必要があります。

構文

Reference_Syntax.removeInstance( INTEGER param )

パラメーター

param

削除するサブフォームまたはサブフォームセットのフォームモデル内でのゼロベースインデックス位置を表す有効な整数です。

戻り値

なし

適用先

モデル

オブジェクト

フォームモデル

instanceManager

バージョン

XFA 2.1

JavaScript

Subform2.instanceManager.removeInstance(3);

FormCalc

Subform2.instanceManager.removeInstance(3)