ようこそ > ユーザー インターフェイス > フォーム > ツールボックス > 一般的なコントロール > 複数行テキスト コントロールのプロパティ

複数行テキスト コントロールのプロパティ

複数行テキスト コントロールのプロパティを構成するには、次のタブを使用します。

全般

[タイプ]

コントロールのタイプ。
[名前]

テキスト フィールドの一意の名前。たとえば、textbox1ではなくCustNameを使用します。
[ヒント]

テキスト フィールドに関する補足情報。

たとえば、名前は大文字で始める必要があるというメッセージをユーザーに対して表示できます。[顧客の詳細] フォームの [顧客名] フィールドに、「大文字から始まる名前をここに入力」といったヒントを追加します。
[状態]

[オプション]、[必須]、または [非表示] のフィールドの状態。(デフォルト: オプション)
[有効になりました]

実行時にフィールドを有効になります。
[読み取り専用]

選択した場合、実行時にテキスト フィールドが編集できなくなります。
[セキュリティ トークン]

コントロールの安全性を高めます。「セキュリティ トークン」を参照してください。
[テキスト]

意味を持った、テキスト フィールドのテキスト。たとえば、「textbox1」ではなく「顧客名」を使用します。
[ヒント テキスト]

入力フィールドに値を入力させるためのヒント テキスト。

ヒント テキストはユーザーが値を入力する前に表示されます。フィールドをクリックすると、ヒント テキストは消えます。

ヒント テキストは、フィールドに値、デフォルト値、またはフォーカスがない場合にのみ表示されます。

TotalAgility の以前のバージョンからフォームをインポートした場合、ヒント テキストは空の状態で表示されます。
[エラー メッセージ]

実行時に、必須のテキスト フィールドにデータが含まれない場合に表示されるメッセージ。
[最大長]

テキスト フィールドで許可される最大文字数。設定した場合、指定した文字数を超過する文字はテキスト フィールドに入力できません。文字をさらに入力した場合、フィールドには設定した最大数までの文字のみが表示されます。

デフォルトでは、テキスト フィールドの最大長は 0 (ゼロ) です。これは、ユーザーが任意の数の文字をフィールドに入力できることを意味します。

「最大長」プロパティは、「タイプ」プロパティおよび「形式」プロパティとは関連性を持ちません。
[複数行]

顧客の住所など、1 行を超える可能性のあるテキストを処理できるようにします。デフォルトでは、コントロールの [高さ] は、66 です。

注 キャプチャ テキスト フィールドに対して選択した場合、OCR なげなわ処理中に改行を保持できます。キャプチャ テキスト フィールドの詳細については、「キャプチャ コントロール」を参照してください。
[フィールド タイプ]

テキスト フィールドに特定のタイプのデータを入力するために使用する事前定義済みのフィールド タイプ。たとえば、日付の入力にテキスト フィールドを使用する場合、フィールド タイプとして「日付」を選択します。

TotalAgility では、以下のフィールド タイプがサポートされています。

データ タイプ

説明

[文字列] (デフォルト)

文字列として任意の文字を受け入れます。文字列フィールドを単独で使用するか、最大長プロパティとともに使用します。

このデータ型を選択した場合、実行時にユーザーが入力した値の形式を制御するマスクプロパティが使用可能になります。これは表示用のプロパティであるため、入力した値には影響を及ぼしません。

実行時に、マスク形式がテキスト フィールドに表示されます。入力すると、入力内容は定義されたマスクに従ってマスク処理されます。

[数値]

任意の整数を受け入れます。「数値」フィールドを単独で使用するか、最大長プロパティとともに使用します。

[小数]

任意の浮動小数点数を受け入れます。小数点以下は固定されないため、必要に応じて入力する必要があります。「小数」フィールドを単独で使用するか、最大長プロパティとともに使用します。

このデータ型を選択すると、次のプロパティが使用可能になります。

  • [小数を許可]: 小数点以下の数値を表示します。

  • [小数点以下の精度]: 小数点の後に許容される桁数を指定します。たとえば、10 進数として 0.234 を入力し、10 進数の精度を 2 に指定すると、システムでは.23と表示されます。

[通貨]

数字と小数点以下の桁を受け入れます。小数点以下の桁数は、地域の設定に基づいて許可されます。たとえば、英国地域の場合、通貨の値は小数点以下 2 桁までです。また、イタリアの場合は、小数点以下 6 桁まで可能です。デンマークの場合は、通貨で小数値を使用できない場合があります。

このデータ型を選択すると、次のプロパティが使用可能になります。

  • [小数を許可]: 小数点以下の数値を表示します。

  • [小数点以下の精度]: 小数点の後に許容される桁数を指定します。たとえば、10 進数として 0.234 を入力し、10 進数の精度を 2 に指定すると、システムでは.23と表示されます。

  • [通貨コード]: 実行時に入力された値をユーザー ロケールに一致するようにフォーマットする通貨を関連付けることができます。デフォルトでは、通貨コード フィールドは空です。通貨フィールドを作成する際に、オプションで通貨コードを選択できます。通貨コードを関連付けると、そのフィールドに入力されたデータは、ブラウザのロケールに対応する通貨形式で表示されます。通貨記号が含まれます。

    通貨コードの定義方法に関する詳細については、「通貨コードの管理」を参照してください。

[日付]

(最小日付と最大日付)

日付の最大値と最小値を受け入れます。

短い形式の日付を受け入れます。形式は地域の設定に依存し、変更できません。

注 タッチ フォームには最大の日付が必須です。設定しない場合、現在の日付を最大の日付として使用します。たとえば、最小の日付を 2030 に設定し、最大の日付を空白のままにした場合、フォームには 2030 から現在の年までの日付が表示されます。最大の日付を設定せずにフォームをリリースしようとすると、最大の日付の入力を促すメッセージが表示されます。

[ブール値]

true または false の値を受け入れます。

[パスワード]

文字列として任意の文字を受け入れます。ただし、実行時に文字は * (アスタリスク) として表示されます。

注

  • テキスト フィールドの形式を設定した場合、フィールド タイププロパティは使用できません。

  • Windows では、パスワード モードでテキスト フィールドを使用した場合、Microsoft 仮想キーボードが無効になります。

[電子メール]

電子メール アドレスを受け入れます。

[URL]

URL Web アドレスを受け入れます。

注 タッチ スクリーンを使用して Safari などのスマートフォン ブラウザでフォームを表示した場合、デバイスにはデータを入力するためのタッチ スクリーン キーパッドが表示されます。

[マスク]

実行時にユーザーが入力する値の形式を制御します。「マスクされたテキスト フィールド」を参照してください。
[形式]

ユーザーがデータを入力した際に表示される正規表現の形式でフィールド マスクを設定します。事前定義済みの正規表現を使用するか、カスタム表現を作成します。
[正規表現]

テキスト フィールドに適用される一連のルール。ルールにより、ユーザーが入力可能なデータのタイプと範囲を指定します。この表現は、フォームの完成時に入力データの精度をテストし、入力したデータが指定されたパターンに準拠していることを確認します。パターンに準拠していない場合、ユーザーにメッセージでエラーを通知します。たとえば、ユーザーが次のような形式で名前を入力する必要があるテキスト フィールドに正規表現を指定します。<大文字で始まる名> スペース <大文字で始まる姓>。ユーザーが姓の前にスペースの入力を忘れた場合、メッセージを表示します。

サポートされる正規表現は次のとおりです。

  • [インターネット電子メール アドレス]: \w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*

  • [インターネット URL]: http://([\w-]+\.)+[\w-]+(/[\w- ./?%&=]*)?

  • [パーセント]: ^(100(?:\.0{1,2})?|0*?\.\d{1,2}|\d{1,2}(?:\.\d{1,2})?)$

  • [時間]: ([0-1][0-9]|[2][0-3]):([0-5][0-9])

  • [英国の日付]: (0[1-9]|[12][0-9]|3[01])[- /.](0[1-9]|1[012])[- /.](19|20)\d\d

  • [英国の日時]: 9]|3[01])[- /.](0[1-9]|1[012])[- /.](19|20)\d\d\s(20|21|22|23|[01]\d|\d)(([:][0-5]\d){1,2})$

  • [英国の郵便番号]: (?:(?:A[BL]|B[ABDHLNRST]?|C[ABFHMORTVW]|D[ADEGHLNTY]|E[CHNX]?|F[KY]|G[LUY]?|H[ADGPRSUX]|I[GMPV]|JE|K[ATWY]|L[ADELNSU]?|M[EKL]?|N[EGNPRW]?|O[LX]|P[AEHLOR]|R[GHM]|S[AEGKLMNOPRSTWY]?|T[ADFNQRSW]|UB|W[ACDFNRSV]?|YO|ZE)\d(?:\d|[A-Z])? \d[A-Z]{2})')

  • [米国の日時]: [- /.](0[1-9]|[12][0-9]|3[01])[- /.](19|20)\d\d\s(20|21|22|23|[01]\d|\d)(([:][0-5]\d){1,2})$
[空のときの値]

テキスト ボックスが空のままの場合、実行時にアクション (.Net、Web サービス、または DB クエリ) によって使用されるデフォルト値。

値は [null] または [文字列] です。実行時にテキスト フィールドの値が空の場合、システムでは設計時にどのプロパティが選択されているかがチェックされます。「null」を選択している場合、テキスト フィールドが空の際の値は null です。「文字列」を選択している場合、テキスト フィールドの値は設計時に指定した文字列の値が取得され、実行時に表示されます。デフォルトでは、テキスト フィールドは空です。