テキストボックス コントロールのプロパティ
次のタブを使用して、テキストボックス コントロールのプロパティを設定します。
全般
[タイプ] |
コントロールのタイプ。 |
||||||||||||||||||||
[名前] |
テキスト フィールドの一意の名前。たとえば、 |
||||||||||||||||||||
[ヒント] |
テキスト フィールドに関する補足情報。 たとえば、名前は大文字で始める必要があるというメッセージをユーザーに対して表示できます。[顧客の詳細] フォームの [顧客名] フィールドに、「大文字から始まる名前をここに入力」といったヒントを追加します。 |
||||||||||||||||||||
[状態] |
[オプション]、[必須]、または [非表示] のフィールドの状態。(デフォルト: オプション) |
||||||||||||||||||||
[有効になりました] |
選択した場合、実行時にフィールドが有効になります。 |
||||||||||||||||||||
[読み取り専用] |
選択した場合、実行時にテキスト フィールドが編集できなくなります。 |
||||||||||||||||||||
[セキュリティ トークン] |
コントロールの安全性を高めます。「セキュリティ トークン」を参照してください。 |
||||||||||||||||||||
[テキスト] |
意味を持った、テキスト フィールドのテキスト。たとえば、「textbox1」ではなく「顧客名」を使用します。 |
||||||||||||||||||||
[ヒント テキスト] |
入力フィールドに値を入力させるためのヒント テキスト。 ヒント テキストはユーザーが値を入力する前に表示されます。フィールドをクリックすると、ヒント テキストは消えます。 ヒント テキストは、フィールドに値、デフォルト値、またはフォーカスがない場合にのみ表示されます。 TotalAgility の以前のバージョンからフォームをインポートした場合、ヒント テキストは空の状態で表示されます。 |
||||||||||||||||||||
[エラー メッセージ] |
実行時に、必須のテキスト フィールドにデータが含まれない場合に表示されるメッセージ。 |
||||||||||||||||||||
[最大長] |
テキスト フィールドで許可される最大文字数。設定した場合、指定した文字数を超過する文字はテキスト フィールドに入力できません。文字をさらに入力した場合、フィールドには設定した最大数までの文字のみが表示されます。 デフォルトでは、テキスト フィールドの最大長は 0 (ゼロ) です。これは、ユーザーが任意の数の文字をフィールドに入力できることを意味します。 「最大長」プロパティは、「タイプ」プロパティおよび「形式」プロパティとは関連性を持ちません。 |
||||||||||||||||||||
[複数行] |
顧客の住所など、1 行を超える可能性のあるテキストを処理できるようにします。選択した場合、テキスト フィールドの高さを指定できます。オフにした場合、コントロールの高さはデフォルトで 22 になります。 注 キャプチャ テキスト フィールドに対して選択した場合、OCR なげなわ処理中に改行を保持できます。キャプチャ テキスト フィールドの詳細については、「キャプチャ コントロール」を参照してください。
|
||||||||||||||||||||
[フィールド タイプ] |
テキスト フィールドに特定のタイプのデータを入力するために使用する事前定義済みのフィールド タイプ。たとえば、日付の入力にテキスト フィールドを使用する場合、フィールド タイプとして「日付」を選択します。 TotalAgility では、以下のフィールド タイプがサポートされています。
注 タッチ スクリーンを使用して Safari などのスマートフォン ブラウザでフォームを表示した場合、デバイスにはデータを入力するためのタッチ スクリーン キーパッドが表示されます。
|
||||||||||||||||||||
[マスク] |
実行時にユーザーが入力する値の形式を制御します。「マスクされたテキスト フィールド」を参照してください。 |
||||||||||||||||||||
[形式] |
ユーザーがデータを入力した際に表示される正規表現の形式でフィールド マスクを設定します。事前定義済みの正規表現を使用するか、カスタム表現を作成します。 |
||||||||||||||||||||
[正規表現] |
テキスト フィールドに適用される一連のルール。ルールにより、ユーザーが入力可能なデータのタイプと範囲を指定します。この表現は、フォームの完成時に入力データの精度をテストし、入力したデータが指定されたパターンに準拠していることを確認します。パターンに準拠していない場合、ユーザーにメッセージでエラーを通知します。たとえば、ユーザーが次のような形式で名前を入力する必要があるテキスト フィールドに正規表現を指定します。<大文字で始まる名> スペース <大文字で始まる姓>。ユーザーが姓の前にスペースの入力を忘れた場合、メッセージを表示します。 サポートされる正規表現は次のとおりです。
|
||||||||||||||||||||
[空のときの値] |
テキストボックスが空のままの場合、実行時にアクション (.Net、Web サービス、または DB クエリ) によって使用されるデフォルト値。実行時にテキスト フィールドの値が空の場合、システムでは設計時にどのプロパティが選択されているかがチェックされます。
文字列フィールド タイプの場合、値は [null] または [文字列] になります。「null」を選択している場合、テキスト フィールドが空の際の値は null です。「文字列」を選択している場合、テキスト フィールドの値は設計時に指定した文字列の値が取得され、実行時に表示されます。デフォルトでは、文字列のテキスト フィールドは設計時には空になります。 日付フィールド タイプの場合、値は [null] または [日付] (デフォルト) になります。「null」を選択している場合、テキスト フィールドが空の際の値は null です。[日付] を選択すると、実行時に表示される日付を選択できます。デフォルトでは、日付フィールドは設計時には空になります。 数値テキストボックスの場合 (フィールド タイプが数値、10 進数、および通貨に設定)、値は [null] または [数値] になります。「null」を選択している場合、テキスト フィールドが空の際の値は null です。「Number」を選択している場合、実行時に表示される数値 (デフォルト: 数値、0) を入力できます。これは、デスクトップ、タブレット、およびモバイルの各フォームに適用されます。 |