8.5.7　ポップアップテキスト／ポップアップフィールド

(a)　アクセスキーの利用

アクセスキーは，可変ポップアップおよび固定ポップアップの使用目的が「POP（自動）」または「POP（手動）」のときに利用できます。また，ポップアップメニューファイルにアクセスキーを記述して，メニューをファイルで指定する可変ポップアップでも利用できます。

(b)　アクセスキーの入力時の注意

アクセスキーは4桁まで指定できます。ドローでアクセスキーの桁数を指定するには，定義画面のアクセスキーの「長さ」で指定します。ポップアップメニューファイルでアクセスキーの桁数を指定する場合については，「14.5　ポップアップメニューエディタ」を参照してください。また，ポップアップメニューファイルで階層化されているメニュー項目にアクセスキーを入力するときの注意事項については，「8.5.7(11)(a)　ポップアップメニューファイル使用時の注意」を参照してください。ただし，ポップアップフィールドでは，ポップアップメニューファイルは利用できません。

次にアクセスキーを入力するときの注意事項を示します。

• アクセスキーは，メニューが表示されているときだけ入力できます。

  メニューが表示されていないときに入力すると，通知コードとしてAPに渡されるので注意してください。

• アクセスキーは全桁入力したときに，有効になります。指定した長さより短いアクセスキーを入力して確定させようとしても，エラーになります。

(a)　ポップアップメニューファイル使用時の注意

次にポップアップメニューファイルを使用するときの注意を示します。

• ポップアップメニューファイルの準備

  ポップアップメニューファイルを使用する場合は，あらかじめポップアップメニューファイルを作成し，各クライアントマシン側に用意しておきます。ポップアップメニューファイルは，ポップアップメニューエディタで作成できます。また，ポップアップメニューファイルを格納しておくフォルダは，実際に表示を実行するマシンの「ポップアップメニューフォルダ（ディレクトリ）」です。ポップアップメニューフォルダのパスは，XMAP3実行環境の表示・印刷環境ファイルで設定します。ポップアップメニューファイルの準備および規則については，マニュアル「XMAP3 実行ガイド」を参照してください。

• ファイル名の初期値の指定

  ポップアップメニューファイルで指定したメニューをテスト表示時に確認したい場合は，準備したポップアップメニューファイル名を，定義画面のファイル名の「初期値」に指定しておきます。このとき，必ず拡張子「.csv」^※を付けて指定してください。拡張子が「.csv」でないファイル名を指定すると，エラーになります。なお，拡張子は，大文字でも小文字でもかまいません。

  注※

  CSV形式（Comma Separated Values形式）

• ポップアップメニューファイルで指定できるメニューの階層

  ポップアップメニューファイルで指定できるメニューの階層は，1階層から8階層までです。

• ポップアップメニューファイルがない場合

  APで指定したポップアップメニューファイルがなかったり，「メニューデータをファイルで指定する」を指定して，ファイル名の指定をしていなかったりした場合，ポップアップテキストには1階層の空のメニューが作成されます。このメニューにフォーカスが位置づくと，エラーになります。

• メニュー項目の制限値を超えている場合

  一つのファイルに指定できるメニュー項目数は，32,000項目です。32,000項目を超えるメニュー項目が指定されているファイルを読み込んだ場合，超過したメニュー項目は表示されません。

• ポップアップメニューファイル読み込みの契機（タイミング）

  ポップアップメニューファイルを読み込むタイミングは，XMAP3実行環境の表示・印刷環境ファイルで設定できます。メニュー項目が大量の場合など，必要に応じて読み込むタイミングの設定を変更してください。ポップアップメニューファイル読み込みのタイミングの設定については，マニュアル「XMAP3 実行ガイド」を参照してください。

• 選択ラベルおよびアクセスキーの利用

  ポップアップメニューファイルでの定義を有効にするために，次の点に注意してください。

  • 選択ラベルを定義している場合

    ポップアップメニューファイルで選択ラベルを定義している場合は，ドローのポップアップメニューダイアログで「選択ラベルと通知コードを同じ値にする」の指定を外してください。

  • アクセスキーを定義している場合

    ポップアップメニューファイルでアクセスキーを定義している場合は，ドローのポップアップメニューダイアログで「アクセスキーを指定する」を指定してください。

• 選択ラベルおよびラベルの大きさの指定

  選択ラベルおよびラベルの大きさは，ポップアップメニューファイルで定義した選択ラベルおよびラベルのデータ長にかかわらず，ドローで定義した大きさになります。ポップアップメニューダイアログの，選択ラベルの「桁」およびラベルの「桁」で大きさを指定してください。指定できる「桁」の大きさは，64桁以内です。

• 使用目的の指定

  ポップアップメニューファイルで定義する通知コードを入力データとして正しく扱うには，ポップアップテキストの使用目的の指定を考慮する必要があります。使用目的と通知コードの関係については，「12.1.10　使用目的と詳細目的」の表12-8を参照してください。

  AP実行時の通知コードの扱いについては，マニュアル「XMAP3 プログラミングガイド」の「ポップアップフィールドの論理マップ生成規則とマッピング規則」の説明を参照してください。

• 階層化されたメニューでのアクセスキー入力

  階層化されたポップアップメニューでは，アクセスキー入力時に表示されている，最下位のメニュー項目が選択対象になります。階層を越えて，別の階層のアクセスキーを入力できません。上位の層のメニュー項目のアクセスキーを入力する場合は，カーソル移動キーで対象の階層の表示に戻してから入力してください。また，最下位のメニュー項目を選択する場合，マウス操作やカーソル移動キーの操作で最終的に選択するメニュー項目を表示させて選択するか，手動ポップアップであれば，最終的にAPに渡される通知コードを，直接，テキストボックスへ入力して選択してください。

(b)　メニューの表示（標準メニューの場合）

ポップアップメニューファイルを使用する場合，メニュー表示の形式を選択できます。メニュー形式で「標準（メニュー）」を指定すると，ポップアップメニューファイルに格納されているメニュー項目が階層構造の場合は，下位のメニュー項目がカスケードメニューで表示されます。

• 表示形式

  

• メニュー項目の選択

  標準表示のメニュー項目は，マウス操作でもキー操作でも選択できます。

  • マウスでの操作

    マウス操作でメニュー項目を選択する場合，ドラッグするだけでは，下位階層のカスケードメニューは表示されません。必ず，インジケータが付いているメニュー項目をクリックしてください。

  • キーでの操作

    フォーカスの移動：上下のカーソルキー。

    下位階層のカスケードメニューの表示：インジケータが付いているメニュー項目にフォーカスを位置づけ，［スペース］キーまたは［Enter］キーを押す。

• 選択後のメニュー表示

  標準表示では，メニュー項目を選択後，メニューを閉じるかどうかを選択できます。

• アクセスキーの使用

  アクセスキーを入力する場合は，必ずメニューを表示してください。入力したアクセスキーに該当するメニュー項目にインジケータが付いている場合は，下位階層のカスケードメニューが表示され，アクセスキーに対応するメニュー項目にフォーカスが位置づきます。

• 通知コードの使用

  通知コードをAPから指定，またはメニューが表示されていない状態で入出力テキストボックスに通知コードを入力すると，指定された通知コードに対応するラベルが選択状態になります。このとき，APに制御が渡されると，指定された通知コードをAPが受け取ります。

(c)　メニューの表示（リストの場合）

ポップアップメニューファイルを使用する場合，メニュー表示の形式を選択できます。メニュー形式で「リスト−ポップアップ型」または「リスト−ダイアログ型」を指定すると，ポップアップメニューファイルに格納されているメニュー項目が階層構造の場合，下位のメニュー項目は下位レベルのリストとして表示されます。メニュー形式で「リスト−ポップアップ型」を指定すると，メニューをポップアップ型で表示できます。「リスト−ダイアログ型」で指定すると，メニューをダイアログ型で表示できます。

• 表示形式

  

• ポップアップ型とダイアログ型の違い

  ポップアップ型とダイアログ型の違いを示します。

  ポップアップ型

  • 階層構造のメニュー項目を第1〜第8レベルのリストで表示します。

  • 下位項目を持たないメニュー項目にフォーカスが位置づいたとき，メニュー項目が選択されたと見なされます。

  • メニュー項目を選択後，メニューを閉じるかどうかを選択できます。

  • ポップアップ型が表示されても，実行画面は不活性になりません。

  • ポップアップ型で表示しているメニューは，単体では移動できません。

  • 使用目的で「POP（手動）」が指定されている場合，メニュー項目が選択されて，実行画面のテキストボックスにデータが入力されるときに，メニューは閉じられます。「POP（自動）」が指定されている場合は，メニューは閉じられません。

  • ポップアップ型で表示しているメニューには，タイトルを付けません。

  ダイアログ型

  • 階層構造のメニュー項目を第1〜第8レベルのリストで表示し，［OK］ボタンと［キャンセル］ボタンを付けます。

  • ［OK］ボタンをクリックしたときにフォーカスが位置づいていたメニュー項目が，選択されたメニュー項目と見なされます。このとき，選択されたメニュー項目は下位項目を持たないメニュー項目でなければなりません。下位項目を持っているメニュー項目を選んで［OK］ボタンをクリックすると，エラーになります。

  • ［OK］ボタンをクリックすると，選んだメニュー項目を確定し，メニューを閉じます。

  • ダイアログ型が表示されると，実行画面は不活性になります。

  • ダイアログ型で表示している場合，メニューだけの移動ができます。

  • ダイアログ型で表示しているメニューには，タイトルが必ず付けられます。

• メニュー項目の選択

  リスト表示のメニュー項目は，マウス操作でもキー操作でも選択できます。

  • キーでの操作

    同レベル内のフォーカスの移動：上下のカーソルキーを押す。

    メニュー項目の選択：［スペース］キーまたは［Enter］キーを押す^※。

    第2〜第8レベルのリストの表示：インジケータが付いているメニュー項目にフォーカスを位置づけ［スペース］キーまたは［Enter］キーを押す^※。

    メニュー内でのフォーカス移動：［Tab］キーを押す^※。

    第1レベルにフォーカスを戻す：［Home］キーを押す。

  なお，［キャンセル］ボタンにフォーカスが位置づいているときに［Tab］キーを押すと，メニューは閉じられます。

  注※

  ダイアログ型で表示している場合，フォーカスはプッシュボタンにも位置づきます。

• アクセスキーの使用

  アクセスキーを入力すると，対応するメニュー項目が選択状態になります。対応するメニュー項目にインジケータが付いている場合は，第2〜第8レベルのリストが表示され，アクセスキーに対応するメニュー項目にフォーカスが位置づきます。

• 通知コードの使用

  通知コードをAPから指定，またはメニューが表示されていない状態で入出力テキストボックスに通知コードを入力すると，指定された通知コードに対応するラベルが選択状態になります。このとき，APに制御が渡されると，指定された通知コードをAPが受け取ります。

• メニュー項目数の動的変更

  リスト表示をしているポップアップメニューでは，メニュー項目数の動的変更はできません。