テキストフィールドの使用

ユーザーがテキストデータを入力できるようにするには、フォームにテキストフィールドを追加します。テキストフィールドを用意しておくと、ユーザーはフィールド内で任意のテキストを入力、選択、編集、切り取り、コピー、貼り付けおよび削除することができます。

テキストフィールドでは、折り返されたテキスト行や、高度な形式設定機能がサポートされています。例えば、テキストフィールドには、テキストブロックを様々な書体やカラーで表示できます。テキストは、プレーンテキストまたは XHTML として保存、取得できます。必要であれば、定義済みパターンに従ってテキストフィールドを形式設定して表示することもできます。

フォームデザインにテキストフィールドを追加した後に、オブジェクトパレットの「フィールド」、「値」および「連結」タブを使用して、キャプションテキストを編集し、オブジェクトのプロパティを操作することができます。次のプロパティを定義できます。

  • フィールドのキャプションを変更する。 キャプションの形式設定 を参照してください。

  • フィールドの境界線のスタイルを設定する。 境界線のスタイルを設定するには を参照してください。

  • フィールドを表示、非表示または隠すのいずれかとして定義する。 オブジェクトを表示、非表示または隠すに設定する を参照してください。

  • フィールドのロケールを指定する。 オブジェクトのロケール(言語と国または地域)を指定するには を参照してください。

  • フィールドについて comb 形式を指定する。

  • 複数行のテキストを有効または無効にする。

  • リッチテキスト形式でのフィールドへの入力を有効または無効にする。

  • フィールド内の文字数を制限する。

  • フィールドのコンテンツ内で改ページを許可する

  • 改ページが挿入されたときに、テキストフィールドオブジェクトをドキュメント内の次のオブジェクトに合わせる。

  • 表示パターンを定義する。

  • 編集パターンを定義する。

  • 表示の初期値を指定する。

  • 実行時プロパティを定義する(例えば、ページ番号を挿入する)。

  • 検証パターンを定義する。

  • フィールドをプレーンテキストまたは XHTML に対応させるかどうかを選択する。

  • データ連結パターンを指定する。

  • 連結データの格納および取得のための連結メソッドを指定する。

テキストフィールドはスクリプティングと演算に対応しています。ユーザーにデータ入力を求める場合は、入力が推奨されるのか、それとも必須なのかを定義し、必要に応じてユーザーの注意を促すためのメッセージを設定することができます。ユーザーの入力はすべてスクリプティングを使用して検証できます。

テキストフィールドで複数行のテキストを使用できるようにするには

オブジェクトパレットで「フィールド」タブをクリックし、「複数行」を選択します。

テキストフィールド内の文字数を制限するには

テキストフィールド内の文字数は、2 とおりの方法で制限できます。

  • 文字数の上限を指定する。

  • Designer で、テキストフィールドの水平方向の長さにより、許容される文字数が決定されるように指定する。

テキストフィールド内の文字数を指定するには

  1. オブジェクトパレットで、「フィールド」タブをクリックします。

  2. 「文字数の制限」を選択し、「最大文字数」ボックスに、ユーザーがテキストフィールドに入力できる最大文字数を入力します。

テキストフィールドの幅を基に文字数を制限するには

オブジェクトパレットの「フィールド」タブをクリックし、「文字数を表示領域に制限」を選択します。

テキストフィールド内での改ページの許可

「コンテンツ内で改ページを許可する」オプションは、親サブフォームで改ページが許可されている場合に、テキストフィールドに対してデフォルトで有効になります。

テキストフィールド内で改ページを許可する際は、次のことを考慮します。

  • 「コンテンツ内で改ページを許可する」オプションは、親オブジェクトで改ページが許可されている場合にのみ選択できます。

  • オブジェクトパレットの「フィールド」タブでキャプションの位置として上または下が選択されている場合は、テキストフィールドオブジェクトのキャプションテキストは改ページされません。

  • 改ページは、回転テキストフィールドオブジェクトではサポートされません。

  • 改ページの挿入が可能なオブジェクトが、改ページを挿入できないオブジェクトの横に配置されている場合、改ページは許可されません。

テキストフィールド内での改ページを許可するには

オブジェクトパレットの「フィールド」タブをクリックし、「コンテンツ内で改ページを許可」を選択します。

テキストフィールドをフォーム内の次のオブジェクトに合わせるには

「次と合わせる」オプションは、フローコンテナである親オブジェクトで改ページが許可されている場合に、テキストフィールドに対して有効になります。

「次と合わせる」オプションは、フローティングフィールドに対しては無効です。代わりに、フローティングフィールドを参照するテキストフィールドオブジェクトの「次と合わせる」オプションを有効にしてください。

オブジェクトパレットの「フィールド」タブをクリックし、「次と合わせる」を選択します。

リッチテキスト形式でのフィールドへの入力を有効にするには

デフォルトでは、テキストフィールドではプレーンテキストが表示、取得されます。その場合、テキストフィールドに関連付けられたデータ値にテキストの形式設定情報が含まれていると、その形式設定は無視され、データ値はプレーンテキストとして表示されます。設定により、データのリッチテキストの形式設定を保持することもできます。

オブジェクトパレットの「フィールド」タブをクリックし、フィールドフォーマットリストで「リッチテキスト」を選択します。

フィールドの動作を定義するには

  1. オブジェクトパレットの「値」タブで、種類リストから次のいずれかのオプションを選択します。

    • データを入力するかどうかをユーザーが選択できるようにする場合は、「ユーザー定義 - オプション」を選択します。

    • ユーザーにデータの入力を促し、推奨フィールドにする場合は、「ユーザー定義 - 推奨」を選択して、「空白のメッセージ」ボックスにカスタムメッセージを入力します。

    • ユーザーにデータの入力を促し、これを必須フィールドにする場合は、「ユーザー定義 - 必須」を選択して、「空白のメッセージ」ボックスにカスタムメッセージを入力します。

    • 読み取り専用フィールドにして、スクリプトにより計算され、表示されるデータ値を表示する場合は、「計算済み - 読み取り専用」を選択します。ユーザーは計算値を編集できません。

    • 編集可能なフィールドにして、スクリプトにより計算され、表示されるデータ値を表示する場合は、「計算済み - 上書き可能」を選択します。入力を処理するための計算スクリプトが記述されている場合、ユーザーは計算結果の値を編集できます。ユーザーが計算結果の値を編集すると、「上書きメッセージ」ボックスで指定したカスタムメッセージが表示されます。

    • 読み取り専用フィールドにして、実行時にマージまたは計算されたうえで表示されるデータ値を表示する場合は、「読み取り専用」を選択します。ユーザーは値を編集できません。

  2. 値が推奨または必須である場合は、「空白のメッセージ」ボックスにプロンプトを入力します。

  3. 値を計算する場合は、スクリプトエディターでオブジェクトに計算スクリプトを追加します。

  4. (オプション)上書き可能な計算値について、「上書きメッセージ」ボックスにメッセージを入力します。

テキストフィールドのカスタムデータ連結プロパティを定義するには

連結プロパティを使用すると、企業インフラストラクチャ用のデータを取得するフォームを作成したり、実行時に外部データソースのデータをフォームに埋め込んだりすることができます。データ連結プロパティは、オブジェクトパレットの「連結」タブで設定します。

  1. テキストフィールドを選択します。

  2. フォームを開いたときに、データソースに接続できるようにします。

  3. 対応するデータノードにフィールドを連結します。オブジェクトとデータソースを連結する方法について詳しくは、 データソースへのフィールドの連結 を参照してください。

テキストフィールドのデータ形式を指定するには

テキストフィールドには、プレーンテキスト形式のデータのみを格納することも、XHTML テキスト形式設定情報が含まれるデータを格納することもできます。デフォルトはプレーンテキストです。データ形式を XHTML に変更すると、オブジェクトパレットの「フィールド」タブにあるフィールドフォーマットリストの「リッチテキスト」オプションが自動的に選択されます。

  1. テキストフィールドオブジェクトを選択します。

  2. オブジェクトパレットで、「フィールド」タブをクリックします。

  3. フィールドフォーマットリストから適切な形式を選択します。

テキストフィールドに comb 形式を指定するには

comb 形式は、テキストフィールドに追加される文字と数値を境界線で区切る場合に使用します。

  1. オブジェクトパレットで、「フィールド」タブをクリックします。

  2. 「マス目で区切る」を選択して、テキストフィールドに含まれる各文字を区切る境界線を含めます。

  3. テキストフィールド内で境界線で区切る文字の数を入力します。