13.62.2 入出力フィールドダイアログ(GUI画面)
入出力フィールドダイアログ(GUI画面)で表示される項目を次に示します。
- フィールドの配置
-
レイアウト領域上でのオブジェクトの先頭位置(行数・列数)と長さ(列数)が表示されます。長さは[APが受け取る項目]の[データ長]に応じて更新されます。
- 使用目的
-
キーボードから入力する場合は,「MCR」以外を指定します。
入出力するデータに応じて選びます。指定に応じて[詳細目的]などで指定できる内容が異なります。
「数字」は,数字一般(数字コードなど)を表記する半角文字用です。
「金額」は,金額を表記する半角文字用です。
「数値」は,主に数量や件数などを表記する半角文字用です。
「カナ」は,半角のカタカナ・英数字での表記用です。日本語入力システムがカナ入力モードになります。
「英数」は,半角のカタカナ・英数字・記号での表記用です。
「日本語」は,全角文字,全角・半角の混在文字での表記用です。日本語入力システムがかな入力モードになります。
「パスワード」は,文字を表示しないパスワード入力などの半角文字用です。
「MCR」は,MCR(磁気カード読取機)からのデータ入力用です。半角文字のデータを入力できます。APの実行時に,MCRから入力データを,入出力テキスト・フィールドを介してAP(論理マップ)に格納できます。
- 詳細目的
-
[使用目的]に応じて,指定できる内容が異なります。
-
使用目的が数字,金額,数値の場合
入力を許可する半角文字の種類を選びます。選べる項目は[使用目的]に応じて異なります。
「数字・数字記号」は,数字(0〜9),数字記号(+ - * . , \),およびスペースです。
「モジュラス」は,数字(0〜9)で,最終桁はモジュラスチェック用数字です。この場合,画面属性で指定するモジュラスアルゴリズムに従って,入力データがチェックされます。チェック条件に合わない場合はエラーになり,オブジェクトからフォーカス・カーソルが移動できなくなります。
「数字」は,数字(0〜9)です。
「小数点付き」は,数字(0〜9)と1個の小数点(.)です。
「符号付き」は,符号(+ -)と数字(0〜9)です。
「符号・小数点付き」は,符号(+ -)と数字(0〜9)と1個の小数点(.)です。
-
使用目的が日本語の場合
入力を許可する文字の種類を選びます。
「混在(全角・半角)」は,全種類の全角文字・半角文字の混在です。
「漢字」は,全種類の全角文字です。
-
使用目的がカナ,英数,パスワードの場合
入力を許可する半角文字の種類を,次の項目の組み合わせから選びます。選べる項目は[使用目的]に応じて異なります。
「半角」は,全種類の半角文字です。
「英大」は,英大文字(A〜Z)です。
「英小」は,英小文字(a〜z)です。
「カナ」は,大文字(〜)と小文字(など)と半濁点(゛)です。「カナ・半角」の場合,全角文字の入力はできますが,その場合はエラー通知文字がAPに返ります。
「長音」は,カナ長音()です。
「数」は,数字(0〜9)です。
「マイナス,アスタリスク,カンマ」は,それぞれの記号(- * ,)です。
「記号」は,英字記号(# @ \ /など)です。
-
- 空白入力
-
空白文字の入力制限について指定します。選べる項目は,オブジェクトの種類や[詳細目的]に応じて異なります。なお,全角空白は,表示・印刷セットアップで指定する[全角スペースコードの扱い]に応じて処理(全角のまま/半角2個に変換)されます。
「禁止」は,空白の入力はできません。
「全桁(半角)」は,半角空白だけを入力できます。未入力ではない「データ無し」を明示的に表す場合に使います。
「一部(半角)」は,半角空白が混在する文字列を入力できます。半角空白だけの入力はできません。※
「一部(全角)」は,全角空白が混在する文字列を入力できます。全角空白だけの入力はできません。
「一部(全・半角)」は,全角空白,半角空白が混在する文字列を入力できます。全角・半角空白だけの入力はできません。
「一部&全桁(半角)」は,半角空白が混在する文字列を入力できます。半角空白だけの入力もできます。※
「一部&全桁(全角)」は,全角空白が混在する文字列を入力できます。全角空白だけの入力もできます。
「一部&全桁(全・半角)」は,全角・半角の空白を自由に入力できます。
注※ 全角空白は入力できますが,その場合はエラー通知文字がAPに返ります(ただし,半角に変換される場合を除く)。
- 表示方法
-
入力可否と非表示属性の組み合わせで指定します。
-
入力可否の指定について
「入力可能」(または「選択可能」)は,活性状態(入力・選択できる状態)でオブジェクトを表示します。
「入力不可」(または「選択不可」)は,不活性状態(入力・選択できない状態)でオブジェクトを表示します。
「パスワード表示」は「入力可能」とだけ組み合わせられます。「グレーアウト表示」および「全体非表示」は「入力不可」とだけ組み合わせられます。
-
非表示属性の指定について
オブジェクトや文字列の表示のしかたを指定します。指定できる項目は,オブジェクトの種類や[使用目的]などに応じて異なります。また,フィールドボックス内のフィールドでは「全体非表示」と「グレーアウト表示」は使用できません。なお,指定はレイアウト領域上には反映されません。
「標準表示」は,オブジェクトや文字を見える状態で表示します。
「全体非表示」は,文字を含むオブジェクト全体を表示しません。
「文字だけ非表示」は,オブジェクトの外観は表示しますが文字は表示しません。
「グレーアウト表示」は,オブジェクトや文字を不活性状態のグレーで表示します。
「パスワード表示」は,文字を「*」に替えて表示します。
-
- 表示書式
-
テキスト・フィールド中の入力文字の表示のしかたを選びます。指定できるのは,[使用目的]が「金額」または「数値」の場合です。
「カンマ付加」は,3桁ごとにカンマ(,)を付けて表示します。「\付加」「*付加」との組み合わせもあります。
「\付加」は,先頭に金額記号(\)を付けます。
「ゼロサプレス」は,前方のゼロ(0)を表示しません。
「*付加」は,前方のゼロ(0),ヌル,スペースをすべてアスタリスク(*)に置き換えて表示します。
「ゼロ付加」は,前方のゼロ(0),ヌル,スペースをすべてゼロに置き換えて表示します。
- 遷移条件
-
オブジェクトでのデータ入力や候補選択の完了後のフォーカス・カーソルの動きについて指定します。
「手動スキップ・右寄せ」は,タブキーやマウスで他のオブジェクトにフォーカス・カーソルを移動したとき,入力データが桁数に満たない場合に入力データが右寄せされます。
「手動スキップ・全桁必須」は,1文字でも入力した場合,桁数いっぱいに入力しないと入力エラーになり,タブキーやマウスでフォーカス/カーソルの移動ができなくなります。
「手動スキップ」は,タブキーやマウスでフォーカス/カーソルを移動します。なお,桁数を超えるデータを入力しようとするとエラーになります。
「自動スキップ」は,桁数いっぱいまで文字を入力するか候補選択の操作をしたとき,フォーカス/カーソルが次の入力/選択できるオブジェクトに自動的に移動します。これに対して,手動スキップの場合はタブキーを押すことでフォーカス/カーソルが次の入力/選択できるオブジェクトに移動します。
- コメントの記述
-
オブジェクトに付けるコメントを記述します。
- 文字色
-
オブジェクトに表示する文字の色を指定します。
- 反転表示する
-
背景色と文字色を反転して表示します。項目を強調して表示する場合などに使います。
- カーソル設定(初期カーソルを本フィールドに設定する)
-
APからカーソル位置を設定しないで画面を表示したとき(例えば,論理マップのカーソル制御項目に値を設定していないなど),このフィールドにカーソルを位置づけます。
すべてのオブジェクトでこの指定が「オフ」の場合は,最小位置(行数−列数の順)で指定可能なオブジェクトに初期カーソルが位置づけられます。
- 入力済み(入力しなくても表示データをAPに返す)
-
オブジェクトを転送状態にします。この場合,入力論理マップのデータ項目に必ず(操作者が変更するかどうかに関係なく)次のデータ/コードを返します。
-
「入力済み」では,オブジェクト内の表示データ(文字列など)。
ただし,ポップアップやコンボボックスの場合は表示データに対応する通知コード。
-
「選択済み」では,候補(ボタンなど)に対応する通知コード。
ただし,表示・選択データがない場合は,データ消去通知文字が入力論理マップの項目に代入されます。
-
- 自動送信(入力直後にAPへ制御を渡す)
-
テキスト入力や候補(メニュー項目やボタンなど)の選択動作ごとに,APにイベントを通知します。
入力/選択後に他のオブジェクトへフォーカスを移動すると,自動的にAPにイベントが通知されます。このとき返すイベント通知コードは,送信キーと同じです。
- 入力必須(入力しない時はエラーにする)
-
このオブジェクトでのデータ入力の操作を省略できないようにします。入力していない場合は,画面確定時(APへ制御を渡す直前)にエラーとなり,イベントはAPに通知されません。
なお,他の属性との対応([不活性]との併用など)に注意してください。
- ワンタッチクリア(選択状態にする)
-
画面が表示されたとき,およびマウス・キー操作によって入力フィールドにフォーカスが移動したときに,この入力フィールドに表示される出力データをすべて選択した状態にします。
ワンタッチで表示データを削除できる状態になります。表示データを必ず書き換える場合などに使います。
-
ワンタッチクリアを設定した入力フィールドにデータが無い場合
入力フィールドをクリックすると,XMAP3 04-02以前ではクリックした個所にカーソルが位置づけられますが,XMAP3 04-03以降では,クリックした位置に関わらず,次に入力が行われる個所(文字の場合は左端,数値・金額の場合は右端※)にカーソルが位置づけられます。
なお,画面が表示されたとき,およびキー操作によってフォーカスが移動したときも同様になります。
注※ オブジェクトに右寄せを指定している場合は,カーソルは常に左端に位置づけられます。
-
- 改行入力(改行コードを認識する)
-
GUI画面で,フィールドボックス内の改行を有効にするときに選択します。入力フィールドおよび入出力フィールドを使用して,改行を含む複数行の文書やコメントをやり取りする場合に使います。
メモ帳などのテキストエディタからコピー&ペーストまたはカット&ペーストでXMAP3の画面に改行を含むデータを貼り付けることができ,さらに,XMAP3の画面からコピー&ペーストでメモ帳などのテキストエディタに改行を含むデータを貼り付けることができます。
注 複数行フィールドでは改行は「↓(半角)」として表示されます。
- 印字する
-
論理ハードコピーでオブジェクトを印刷対象にするかどうかを指定します。印字対象にしない場合は,[印字する]チェックボックスをオフにしてください。
- [フィールド反復]ボタン
-
反復定義について指定するためのダイアログが表示されます。
- APが受け取る項目
-
APが参照するデータ項目について指定します。
- ・データ名
-
データ項目のデータ名を次の規則に従って指定します。
-
指定できる文字数は,接頭語(マップ名)を含めて29文字以内です。このため,ドローセットアップの[マップ名の長さ]の設定が「7」の場合は21文字以内,「6」の場合は22文字以内となります。全角文字は2文字分として数えます。ただし,データ名の先頭および末尾の全角文字は,4文字分として数えます。また,全角文字と半角文字が混在する場合,半角文字の直前の全角文字は,4文字分として数えます。
-
指定できる文字種は,COBOLの場合は「A〜Z」「0〜9」「-(ハイフン)」「大文字の半角カナ」「全角(混在)」です。
Cの場合は「A〜Z」「a〜z」「0〜9」「_(アンダースコア)」です。
-
- ・桁
-
入力・出力するデータに応じて,データ項目の桁を指定します。
-
[データ長を変更する]ボタンがオフの場合
指定できる長さは,入出力するデータの最大長以上で,オブジェクトがレイアウト領域に収まる範囲です。ただし,[データ型]が「数字」または「数字編集」のときはピクチャの最大桁を指定します。
-
[データ長を変更する]ボタンがオンの場合
不活性になり,設定できません。
-
- ・データ長
-
APが受け取る項目のデータ長を指定します。
-
[データ長を変更する]ボタンがオフの場合
ターゲット,使用目的に応じて,「桁」の値を基に計算した値を表示します。
-
[データ長を変更する]ボタンがオンの場合
「桁」より小さい値になっているとエラーになります。
また,次の場合エラーになります。
・最大値31920を超えている
・数値以外が入力された
-
- ・データ型
-
使用言語がCOBOLの場合に,ピクチャ句で指定するデータ型を選びます。選べるデータ型は,オブジェクトの種類や他の項目の指定に応じて異なります。なお,Cの場合は文字(char)型で固定です。
-
文字用の「文字(XX)」,「漢字(NN)」,「漢字(XX)」
-
数字用の「99999」
-
数字編集用の数字編集文字列
「S99999」,「999V9」など。自由な値を定義する場合は,「その他のピクチャ」を選び,[自由な設定]ボタンからピクチャ文字を指定します。
-
- ・桁寄せ
-
データ長が論理マップ上の項目の長さより短い場合に,データを左右のどちらに寄せるかを指定します。使用言語がCOBOLで,次のどちらかの場合に指定できます。その他の場合はオブジェクトの種別やデータ型などに応じた固定値となります。
-
[使用目的]が「数字」で[データ型]が「文字(XX)」
-
[使用目的]が「英数」または「カナ」
-
- ・埋字
-
論理マップの項目長よりデータ長が短い場合に残りの領域を埋める文字を指定します。[桁寄せ]に応じて,項目内の右側/左側に埋字が格納されます。
指定できる内容は,オブジェクトの種別や[使用目的]などに応じて異なります。
「スペース」は,半角のスペースで埋字します。
「LOW(X'00')」は,LOW-VALUE((00)16)で埋字します。
「HIGH(X'FF')」は,HIGH-VALUE((FF)16)で埋字します。
「ゼロ」は,0で埋字します。
「埋めない」は,埋字をしません。領域にはAP内の直前のデータ領域の内容がそのまま残るか,初期クリア文字でクリアされます。
「自由な埋字」は,自由な値を埋字にします。この場合,[自由な設定]ボタンから値を指定してください。
- ・初期値(入力)
-
入力論理マップの項目にあらかじめ設定しておく初期値を指定します。指定できる内容は,[使用目的]などに応じて異なります。
「指定しない」は,初期値の文字を設定しません。
「LOW(X'00')クリア」は,(00)16で領域をクリアします。
「スペースクリア」は,半角のスペースで領域をクリアします。
「ゼロクリア」は,文字の0で領域をクリアします。
「自由な初期値」は,自由な文字で領域をクリアします。この場合,[自由な設定]ボタンから文字を指定してください。
なお,ポップアップやコンボボックスの初期値には,該当メニュー項目に対応する通知コードを指定してください。
- ・下位項目
-
下位項目を設定する場合に,[下位項目]を「オン」にします。[設定]ボタンから表示されるダイアログで必要な設定をしてください。下位項目を指定できるのは,データ型が「文字(XX)」の場合です。
下位項目は,オブジェクトの入出力となる一つのデータ項目を階層化して,複数の項目に細分化するときに使います。この場合,APは細分化された下位項目を使ってデータを参照・格納できます。
- APからデータを表示する
-
出力論理マップに初期値出力用の領域(APが渡す項目)を展開します。この領域にAPから初期値を設定して,オブジェクトに表示します。
なお,次の場合には,この指定を「オフ」にしてください。
-
キーボードからの入力だけに使う(APからデータを表示しない)場合
-
[使用目的]が「パスワード」や「MCR」の場合
-
- データ長を変更する
-
データ長の自由設定の有無を指定します。
-
オン:データ長を自由設定できます。
-
オフ:データ長を標準設定にします。
ターゲットがWindows,AIX(シフトJIS)の場合は非表示になります。また,他のターゲットの場合でも,使用目的が「日本語」で詳細目的が「混在(全角・半角)」の場合だけデータ長が指定できます。
-
- APが渡す項目
-
APからの出力データを代入するデータ項目について指定します。
[データ名]や[桁],[データ長]などの項目は,[APが受け取る項目]に対応して表示されます。
-
下位項目
下位項目を設定する場合に,[下位項目]を「オン」にします。[設定]ボタンから表示されるダイアログで必要な設定をしてください。下位項目を指定できるのは,データ型が「文字(XX)」の場合です。
下位項目は,オブジェクトの入出力となる一つのデータ項目を階層化して,複数の項目に細分化するときに使います。この場合,APは細分化された下位項目を使ってデータを参照・格納できます。
-
- [自由な設定]ボタン
-
[データ型],[埋字],[初期値]を任意の値で設定する場合に,値を指定するためのダイアログが表示されます。
- 動的変更(APから表示属性を変更する)
-
制御項目を論理マップに展開して,画面表示時または帳票印刷時に表示属性を動的に変更できるようにします。表示属性とは,画面に表示するオブジェクトの文字色や活性/不活性,帳票に印字する文字の書体やけい線の種類などの属性です。
制御項目にAPから修飾名を設定することで,動的に属性を変更できます(ただし,GUI/CUI画面でマッピングオプションが「物理マップ」のときは該当しません)。
修飾名と表示属性との対応は,ドローセットアップで設定します。