field

field オブジェクトは、データコンテンツの取得と提示を行うことができる、単一のインタラクティブコンテナを表します。

Designer のオブジェクトライブラリで使用可能なオブジェクトとして、field オブジェクトは次のオブジェクトの基になる XML 定義です。

バーコード
ボタン
日付 / 時間フィールド
十進数フィールド
署名フィールド
電子メール送信ボタン
HTTP 送信ボタン
画像フィールド
数値フィールド
Paper Forms Barcode
パスワードフィールド
印刷ボタン
リセットボタン
テキストフィールド

カスタム検証メッセージを定義できます。1 つのフィールドには、最大 3 つのメッセージ（それぞれ、スクリプトテスト、画像テスト、および null テスト用）を含むことができます。これらのメッセージが指定されている場合、メッセージには、次の構文を使用してアクセスできます。

field.validate.message.scriptTest.value 
field.validate.message.formatTest.value 
field.validate.message.nullTest.value

また、これらの構文のショートカットプロパティを使用しても検証メッセージにアクセスできます。

field.validationMessage 
field.formatMessage 
field.mandatoryMessage

これらの値が入力されていない場合は、プロセッサーがデフォルトのメッセージを作成します。

フィールドには、常時、エラー状態の検証テストを 1 つまで含むことができます。検証テストは次の順序で評価され、エラーになった最初のテストで評価が停止します。

オブジェクトの階層

モデル

子オブジェクト

親クラス

container クラス

プロパティ

名前	説明	型	アクセス権
{default}	オブジェクトにより保存される実際の値を表します。	可変	読み取り / 書き込み
access	サブフォームなど、コンテナオブジェクトのコンテンツへのユーザーアクセスを制御します。	文字列	読み取り / 書き込み
accessKey	インタラクティブアプリケーションで使用するアクセラレーターキーを指定して、入力フォーカスを特定のフィールド要素に移動します。	文字列	読み取り / 書き込み
anchorType	位置固定レイアウト方法を使用して配置した場合のコンテナのアンカーポイントの位置を指定します。	文字列	読み取り / 書き込み
borderColor	このフィールドの境界線の色の値を指定します。	文字列	読み取り / 書き込み
borderWidth	このフィールドの境界線の幅を指定します。	文字列	読み取り / 書き込み
colSpan	レイアウトの種類が行であるサブフォーム内で使用する場合、このオブジェクトが対象とする列の数を指定します。	文字列	読み取り / 書き込み
editValue	フィールドの編集値を指定します。	文字列	読み取り / 書き込み
errorText	最初に失敗した検証テストの検証メッセージテキストを返します。このフィールドがすべての検証テストに合格した場合は、空白の文字列を返します。	文字列	読み取り
fillColor	このフィールドの背景色の値です。	文字列	読み取り / 書き込み
fontColor	フィールドの描画色の値を指定します。font.fill.color.valueexpression 式と等価です。	文字列	読み取り / 書き込み
formatMessage	このフィールドの形式検証メッセージの文字列を指定します。	文字列	読み取り / 書き込み
formattedValue	フィールドの形式設定された値を指定します。	文字列	読み取り / 書き込み
h	レイアウトの高さを指定する測定値です。	文字列	読み取り / 書き込み
hAlign	水平方向のテキスト揃えを指定します。	文字列	読み取り / 書き込み
length	リストのオブジェクト数を指定します。	整数値	読み取り
locale	オブジェクトのコンテンツに使用する言語、通貨、日時の形式を指定します。	文字列	読み取り / 書き込み
mandatory	フィールドの nullTest 値を指定します。	文字列	読み取り / 書き込み
mandatoryMessage	このフィールドの指示メッセージ文字列を指定します。	文字列	読み取り / 書き込み
maxH	レイアウト用の高さの最大値を指定します。	文字列	読み取り / 書き込み
maxW	レイアウト用の幅の最大値を指定します。	文字列	読み取り / 書き込み
minH	レイアウト用の高さの最小値を指定します。	文字列	読み取り / 書き込み
minW	レイアウト用の幅の最小値を指定します。	文字列	読み取り / 書き込み
parentSubform	このフィールドの親サブフォーム（ページ）を指定します。	オブジェクト	読み取り
presence	オブジェクトの可視性を指定します。	文字列	読み取り / 書き込み
rawValue	現在のオブジェクトの形式設定されていない値を指定します。	可変	読み取り / 書き込み
relevant	フォームの印刷時にフォームオブジェクトを含めるかどうかを制御します。	文字列	読み取り / 書き込み
rotate	アンカーを中心にオブジェクトを指定された角度だけ回転させます。	文字列	読み取り / 書き込み
selectedIndex	最初の選択項目のインデックスです。	整数値	読み取り / 書き込み
use	プロトタイプを呼び出します。	文字列	読み取り / 書き込み
usehref	外部プロトタイプを呼び出します。	文字列	読み取り / 書き込み
validationMessage	このフィールドの検証メッセージ文字列を指定します。	文字列	読み取り / 書き込み
vAlign	垂直方向のテキスト揃えを指定します。	文字列	読み取り / 書き込み
w	レイアウトの幅を指定する測定値です。	文字列	読み取り / 書き込み
x	位置固定レイアウトで配置した場合の、親コンテナの左上のコーナーに相対的なコンテナのアンカーポイントの X 座標を指定します。	文字列	読み取り / 書き込み
y	位置固定レイアウトで配置した場合の、親コンテナの左上のコーナーに相対的なコンテナのアンカーポイントの Y 座標を指定します。	文字列	読み取り / 書き込み

メソッド

名前	説明	戻り値
addItem	現在のフォームフィールドに新しい項目を追加します。例えば、このメソッドではコンボボックスに新しい項目を追加します。	なし
boundItem	コンボボックスまたはリストボックスの特定の表示項目の連結値を取得します。	文字列
clearItems	フィールドからすべての項目を削除します。例えば、コンボボックスまたはリストボックスに含まれるすべての項目を削除します。	なし
deleteItem	指定された項目を削除します。	ブール値
execCalculate	指定したオブジェクトとその子オブジェクトの calculate イベントのスクリプトを実行します。	なし
execEvent	オブジェクトのイベントスクリプトを実行します。	なし
execInitialize	指定したオブジェクトとそのすべての子オブジェクトについて、initialize イベント内のスクリプトを実行します。	なし
execValidate	指定したオブジェクトとそのすべての子オブジェクトについて、validate イベント内のスクリプトを実行します。	なし
getDisplayItem	指定された項目インデックスの項目表示テキストを取得します。	文字列
getItemState	指定された項目の選択状態を返します。	ブール値
getSaveItem	指定された項目インデックスのデータ値を取得します。	文字列
setItemState	指定された項目の選択状態を設定します。	なし
setItems	新しい項目と値を現在のフォームフィールドに追加します。例えば、コンボボックスに新しい項目と値を引数として追加するにはこのメソッドを使用します。	なし