画面・帳票サポートシステム XMAP3 プログラミングガイド 画面編
![[目次]](FIGURE/CONTENT.GIF)
![[用語]](FIGURE/GLOSS.GIF)
![[索引]](FIGURE/INDEX.GIF)
![[前へ]](FIGURE/FRONT.GIF)
(1) 表示形式(可変・固定)
(2) 使用目的(可変・固定)
使用目的によって,入力データをチェックできます。ただし,ラベルのデータ型は,使用目的の指定と連動しません。ラベルのデータ型の「文字(XX)」は「日本語」の属性になります。また,使用目的に「自動−日本語」または「手動−日本語」を選択すると,詳細目的として「混在(全角・半角)」または「漢字」を選択できます。
使用目的と入力データの関係,および詳細目的については,「付録A.9 表示属性の解説」の表A-8および表A-9を参照してください。
(3) 表示サイズとメニュー項目数(可変・固定)
固定ポップアップメニューおよび可変ポップアップメニューを表示する領域(表示サイズ)は,必ずウィンドウに収まるようにドロー上で定義します。ポップアップメニューのメニュー項目数が,表示領域に収まらない場合は,自動的にスクロールバーが付けられます。ドローで定義したポップアップのメニューの行数よりも少ないメニュー項目をAPから設定した場合は,表示するメニューサイズを項目数に合わせて自動的に縮小します。詳細については,「2.4.9(1)(h) メニュー項目数の動的変更(可変コンボボックスの場合)」を参照してください。なお,表示できるメニュー項目数は次のようになります。
- ドローまたはAPで設定したメニュー項目を表示する場合:128個/1階層(階層は1階層だけ)
- ポップアップメニューファイルのメニュー項目を表示する場合
:256項目/1階層(ファイルが階層構造の場合)(階層は8階層まで)
:32,000項目/ファイル
(4) 入出力時のAPインタフェース(可変・固定)
ポップアップテキストには,固定ポップアップと可変ポップアップとがあります。固定ポップアップは,画面設計時に入力データの候補となるメニューが決まっている場合に使用します。可変ポップアップは,メニューのラベルおよびメニューの通知コードを,APまたはポップアップメニューファイルから設定したい場合に使用します。
ポップアップテキストで選択されたメニューはボックス内に表示され,画面確定後には,メニューに対応した通知コードが入力論理マップに格納されます。
ポップアップメニューの表示方法を次の表に示します。
表2-9 ポップアップメニューの表示方法
表示方法 |
内容 |
自動で表示する
POP(自動) |
メニュー項目の選択でだけデータを入力する標準的な使い方。
オブジェクトにフォーカスが位置づくと,メニューが自動的に表示される。 |
手動で表示する
POP(手動) |
キーボードからの入力と,メニュー項目の選択との2とおりでデータを入力できる使い方。
メニューは次に示す方法で表示される。
- 手動で表示する
メニューは,オブジェクトにフォーカスを位置づけ,あらかじめポップアップ表示用に対応づけたファンクションキーかプッシュボタンを押すと,表示される。なお,同じキーまたはボタンを押して,表示されているメニューを閉じることもできる。キー操作に慣れているユーザはキー入力で操作でき,初心者はボタンなどで表示されているメニューから選択して操作できる。
- 「最初にメニューを開く」を指定して表示する
ポップアップメニューダイアログの「最初にメニューを開く」を指定しておくと,オブジェクトにフォーカスが位置づいたとき,自動的にメニューが表示される。
- 注
- アクセスキーでメニュー項目を選択する場合は,キー操作または「最初にメニューを開く」指定をしてメニューを表示しておく必要がある。
|
(5) ポップアップ表示属性の遷移条件(可変・固定)
ポップアップでメニューを選択した場合,入出力テキストに表示される選択ラベルは,そのポップアップの入出力テキスト属性で指定する「遷移条件」の動作はしません。選択したメニューに対応する選択ラベルはそのままの状態で入出力テキストに表示され,右寄せなどの表示はされません。また,次のボックスに自動的にフォーカス遷移する「自動スキップ」の属性は,メニューの表示属性の「選択したらメニューを閉じる」の指定に従います。
ポップアップ表示属性ダイアログの「遷移条件」の定義内容は,使用目的が「POP(手動)」のとき,入出力テキストにキー入力されたテキストにだけ適用されます。使用目的ごとの遷移条件の適用を次の表に示します。
使用目的 |
遷移条件
(手動スキップ・自動スキップ) |
桁寄せ
(右寄せ・全桁必須) |
POP(自動) |
× |
× |
POP(手動)※ |
メニュー選択 |
○ |
× |
キー入力 |
○ |
○ |
- (凡例)
- ○:適用される。
- ×:適用されない。
- 注※
- 「自動スキップ」を指定した場合は,「選択したらメニューを閉じる」を指定してください。「手動スキップ」を指定した場合は,「選択したらメニューを閉じる」を指定しないでください。
(6) アクセスキーと選択ラベル(可変・固定)
ポップアップでは,アクセスキーを利用してポップアップメニューを選んだり,選んだメニュー項目が反映される選択ラベルを使用したりできます。アクセスキーおよび選択ラベルについては「6.2.17 可変ポップアップテキストを使用したデータの入力」または「6.2.19 固定ポップアップテキストを使用したデータの入力」を参照してください。
(a) アクセスキーの利用
アクセスキーは,可変ポップアップおよび固定ポップアップの使用目的が「POP(自動)」または「POP(手動)」のときに利用できます。また,ポップアップメニューファイルにアクセスキーを記述して,メニューをファイルで指定する可変ポップアップでも利用できます。
(b) アクセスキーの入力時の注意
アクセスキーは4桁まで指定できます。ドローでアクセスキーの桁数を指定するには,定義画面のアクセスキーの「長さ」で指定します。ポップアップメニューファイルでアクセスキーの桁数を指定する場合については,マニュアル「XMAP3 開発・実行ガイド」を参照してください。また,ポップアップメニューファイルで階層化されているメニュー項目にアクセスキーを入力するときの注意事項については,「2.4.10(10)(a) ポップアップメニューファイル使用時の注意事項」を参照してください。
次にアクセスキーを入力するときの注意事項を示します。
- アクセスキーは,メニューが表示されているときだけ入力できます。
メニューが表示されていないときに入力すると,通知コードとしてAPに渡されますので注意してください。
- アクセスキーは全桁入力したときに,有効になります。指定した長さより短いアクセスキーを入力して確定させようとしても,エラーになります。
(7) 表示属性の動的変更(可変・固定)
(8) APから初期値を変更する(可変・固定)
「APから初期値を選択する」を指定すると,初期値用のデータエリアが出力論理マップ中に生成されます。ここに値を代入すると,ポップアップテキストの初期表示時に,初期値に対応するメニュー項目が選択された状態で表示されます。
(9) メニュー項目数の動的変更(可変)
ポップアップのダイアログでは,使用するメニュー項目数の最大値を指定しておきます。しかし実際の表示では,メニュー項目数が可変になる場合があります。上から順に項目のデータを代入し,残った項目のラベルに半角の空白(スペースコード)を代入すると,空白を代入したメニュー項目は表示されません。なお,途中のメニュー項目を詰めて表示することはできません。途中のメニュー項目の空白はデータとみなされます。空白のラベルをメニューの最後に表示させたい場合は,ラベルのデータに全角のスペースを代入してください。メニュー項目数の動的変更の詳細については「6.2.32 コンボボックスの項目数の動的変更」を参照してください。なお,コンボボックスはポップアップに置き換えてお読みください。
(10) ポップアップメニューをファイルで指定する(可変)
XMAP3では,ポップアップテキストに表示するメニューデータをAP実行時にファイルから渡せます。このファイルをポップアップメニューファイルといいます。ポップアップメニューファイルは,あらかじめ用意しておきます。
ポップアップメニューファイルは,メニュー項目が大量にある場合や,メニューを大分類,小分類にして表示したい場合に使用します。また,ホスト連携機能を利用する場合,PC側にポップアップメニューファイルを持つことで,ホストとPC間で転送するデータ量を減らせます。ポップアップメニューファイルの使い方については,「6.2.18 ポップアップメニューファイルを使用したデータの入力」を参照してください。
(a) ポップアップメニューファイル使用時の注意事項
次にポップアップメニューファイルを使用するときの注意事項を示します。
- ポップアップメニューファイルの準備
ポップアップメニューファイルを使用する場合は,あらかじめポップアップメニューファイルを作成し,各クライアントPC側に用意しておきます。ポップアップメニューファイルは,ユティリティの「ポップアップメニューエディタ」で作成できます。また,ポップアップメニューファイルを格納しておくフォルダは,実際に表示を実行するPCの「ポップアップメニューフォルダ(ディレクトリ)」です。ポップアップメニューフォルダのパスは,表示・印刷セットアップで設定します。ポップアップメニューファイルの準備および規則の詳細については,マニュアル「XMAP3 開発・実行ガイド」を参照してください。
- ファイル名の初期値の指定
ポップアップメニューファイルで指定したメニューをテスト表示時に確認したい場合は,準備したポップアップメニューファイル名を,定義画面のファイル名の「初期値」に指定しておきます。このとき,必ず拡張子「.csv」※を付けて指定してください。拡張子が「.csv」でないファイル名を指定すると,エラーになります。なお,拡張子は,大文字でも小文字でもかまいません。
- 注※
- CSV形式(Comma Separated Values形式)
- ポップアップメニューファイルで指定できるメニューの階層
ポップアップメニューファイルで指定できるメニューの階層は,1階層から8階層までです。
- ポップアップメニューファイルがない場合
APで指定したポップアップメニューファイルがなかったり,「メニューデータをファイルで指定する」を指定して,ファイル名の指定をしていなかったりした場合,ポップアップテキストには1階層の空のメニューが作成されます。このメニューにフォーカスが位置づくと,エラーになります。
- メニュー項目の制限値を超えている場合
一つのファイルに指定できるメニュー項目数は,32,000項目です。32,000項目を超えるメニュー項目が指定されているファイルを読み込んだ場合,超過したメニュー項目は表示されません。
- ポップアップメニューファイル読み込みの契機(タイミング)
ポップアップメニューファイルを読み込むタイミングは,表示・印刷セットアップで設定できます。メニュー項目が大量の場合など,必要に応じて読み込むタイミングの設定を変更してください。ポップアップメニューファイル読み込みのタイミングの設定については,マニュアル「XMAP3 開発・実行ガイド」を参照してください。
- 選択ラベルおよびアクセスキーの利用
ポップアップメニューファイルでの定義を有効にするために,次の点に注意してください。
- 選択ラベルを定義している場合
ポップアップメニューファイルで選択ラベルを定義している場合は,ドローのポップアップメニューダイアログで「選択ラベルと通知コードを同じ値にする」の指定を外してください。
- アクセスキーを定義している場合
ポップアップメニューファイルでアクセスキーを定義している場合は,ドローのポップアップメニューダイアログで「アクセスキーを指定する」を指定してください。
- 選択ラベルおよびラベルの大きさの指定
選択ラベルおよびラベルの大きさは,ポップアップメニューファイルで定義した選択ラベルおよびラベルのデータ長にかかわらず,ドローで定義した大きさになります。ポップアップメニューダイアログの,選択ラベルの「桁」およびラベルの「桁」で大きさを指定してください。指定できる「桁」の大きさについては,「付録D 画面定義の制限値」を参照してください。
- 使用目的の指定
ポップアップメニューファイルで定義する通知コードを入力データとして正しく扱うには,ポップアップテキストの使用目的の指定を考慮する必要があります。使用目的と通知コードの関係については,「付録A.9 表示属性の解説」の表A-8を参照してください。
AP実行時の通知コードの扱いについては,「5.4.1(2) ポップアップフィールドの論理マップ生成規則とマッピング規則」を参照してください。
- 階層化されたメニューでのアクセスキー入力
階層化されたポップアップメニューでは,アクセスキー入力時に表示されている,最下位のメニュー項目が選択対象になります。階層を超えて,別の階層のアクセスキーを入力できません。上位の層のメニュー項目のアクセスキーを入力する場合は,カーソル移動キーで対象の階層の表示に戻してから入力してください。また,最下位のメニュー項目を選択する場合,マウス操作やカーソル移動キーの操作で最終的に選択するメニュー項目を表示させて選択するか,手動ポップアップであれば,最終的にAPに渡される通知コードを,直接,テキストボックスへ入力して選択してください。
(b) メニューの表示(標準メニューの場合)
ポップアップメニューファイルを使用する場合,メニュー表示の形式を選択できます。メニュー形式で「標準(メニュー)」を指定すると,ポップアップメニューファイルに格納されているメニュー項目が階層構造の場合は,下位のメニュー項目がカスケードメニューで表示されます。
- 表示形式
![[図データ]](FIGURE/ZU020921.GIF)
- メニュー項目の選択
標準表示のメニュー項目は,マウス操作でもキー操作でも選択できます。
- マウスでの操作
マウス操作でメニュー項目を選択する場合,ドラッグするだけでは,下位階層のカスケードメニューは表示されません。必ず,インジケータが付いているメニュー項目をクリックしてください。
- キーでの操作
フォーカスの移動:上下のカーソルキー。
下位階層のカスケードメニューの表示:インジケータが付いているメニュー項目にフォーカスを位置づけ,[スペース]キーまたは[Enter]キーを押す。
キー操作の詳細については「4. マウスとキー操作」を参照してください。
- 選択後のメニュー表示
標準表示では,メニュー項目を選択後,メニューを閉じるかどうかを選択できます。
- アクセスキーの使用
アクセスキーを入力する場合は,必ずメニューを表示してください。入力したアクセスキーに該当するメニュー項目にインジケータが付いている場合は,下位階層のカスケードメニューが表示され,アクセスキーに対応するメニュー項目にフォーカスが位置づきます。
- 通知コードの使用
通知コードをAPから指定したり,メニューが表示されていない状態で,入出力テキストボックスに通知コードを入力すると,指定された通知コードに対応するラベルが選択状態になります。このとき,APに制御が渡されると,指定された通知コードをAPが受け取ります。
(c) メニューの表示(リストの場合)
ポップアップメニューファイルを使用する場合,メニュー表示の形式を選択できます。メニュー形式で「リスト−ポップアップ型」または「リスト−ダイアログ型」を指定すると,ポップアップメニューファイルに格納されているメニュー項目が階層構造の場合,下位のメニュー項目は下位レベルのリストとして表示されます。メニュー形式で「リスト−ポップアップ型」を指定すると,メニューをポップアップ型で表示できます。「リスト−ダイアログ型」で指定すると,メニューをダイアログ型で表示できます。
- 表示形式
![[図データ]](FIGURE/ZU020922.GIF)
- ポップアップ型とダイアログ型の違い
ポップアップ型とダイアログ型の違いを示します。
ポップアップ型
- ポップアップ型は,階層構造のメニュー項目を第1〜第8レベルのリストで表示します。
- ポップアップ型では,下位項目を持たないメニュー項目にフォーカスが位置づいたとき,メニュー項目が選択されたとみなされます。
- ポップアップ型では,メニュー項目を選択後,メニューを閉じるかどうかを選択できます。
- ポップアップ型が表示されても,実行画面は不活性になりません。
- ポップアップ型で表示しているメニューは,単体では移動できません。
- 使用目的で「POP(手動)」が指定されている場合,メニュー項目が選択されて,実行画面のテキストボックスにデータが入力されるときに,メニューは閉じられます。「POP(自動)」が指定されている場合は,メニューは閉じられません。
- ポップアップ型で表示しているメニューには,タイトルを付けません。
ダイアログ型
- ダイアログ型は,階層構造のメニュー項目を第1〜第8レベルのリストで表示し,[OK]ボタンと[キャンセル]ボタンを付けます。
- ダイアログ型では,[OK]ボタンをクリックしたときにフォーカスが位置づいていたメニュー項目が,選択されたメニュー項目とみなされます。このとき,選択されたメニュー項目は下位項目を持たないメニュー項目でなければなりません。下位項目を持っているメニュー項目を選んで[OK]ボタンをクリックすると,エラーになります。
- ダイアログ型では[OK]ボタンをクリックすると,選んだメニュー項目を確定し,メニューを閉じます。
- ダイアログ型が表示されると,実行画面は不活性になります。
- ダイアログ型で表示している場合,メニューだけの移動ができます。
- ダイアログ型で表示しているメニューには,タイトルが必ず付けられます。
- メニュー項目の選択
リスト表示のメニュー項目は,マウス操作でもキー操作でも選択できます。
- キーでの操作
同レベル内のフォーカスの移動:上下のカーソルキーを押す。
メニュー項目の選択:[スペース]キーまたは[Enter]キーを押す※。
第2〜第8レベルのリストの表示:インジケータが付いているメニュー項目にフォーカスを位置づけ[スペース]キーまたは[Enter]キーを押す※。
メニュー内でのフォーカス移動:[Tab]キーを押す※。
第1レベルにフォーカスを戻す:[Home]キーを押す。
なお,[キャンセル]ボタンにフォーカスが位置づいているときに[Tab]キーを押すと,メニューは閉じられます。
キー操作の詳細については「4. マウスとキー操作」を参照してください。
- 注※
- ダイアログ型で表示している場合,フォーカスはプッシュボタンにも位置づきます。
- アクセスキーの使用
アクセスキーを入力すると,対応するメニュー項目が選択状態になります。対応するメニュー項目にインジケータが付いている場合は,第2〜第8レベルのリストが表示され,アクセスキーに対応するメニュー項目にフォーカスが位置づきます。
- 通知コードの使用
通知コードをAPから指定したり,メニューが表示されていない状態で,入出力テキストボックスに通知コードを入力すると,指定された通知コードに対応するラベルが選択状態になります。このとき,APに制御が渡されると,指定された通知コードをAPが受け取ります。
- メニュー項目数の動的変更
リスト表示をしているポップアップメニューでは,メニュー項目数の動的変更はできません。
All Rights Reserved. Copyright (C) 2001, 2006, Hitachi, Ltd.