OpenVMS マニュアル

2.2.10 ビューポート

仮想ディスプレイは非常に大きくなる可能性があるため，ディスプレイ全体を一度に画面に表示できるとは限りません。ユーザは大きな仮想ディスプレイの各部分を表示するために，仮想ディスプレイを再ペーストしなければなりません。仮想ディスプレイに対応づけられたビューポートはこの操作を容易にします。

ビューポート操作 とは，仮想ディスプレイの各部分を表示するために，仮想ディスプレイ上で長方形の表示領域を移動する処理のことです。ビューポートは仮想ディスプレイに対応づけられるため，仮想ディスプレイに対して実行され，出力操作はすべて，ビューポート上で反映されます。

SMG$CREATE_VIEWPORT ルーチンは，特定の仮想ディスプレイに対応するビューポートを作成します。仮想ディスプレイは,ビューポートを作成する前に作成しておかなければならず，各仮想ディスプレイに対してビューポートを1つだけ作成できます。

ビューポートを表示するには， SMG$PASTE_VIRTUAL_DISPLAY ルーチンを呼び出すことにより，仮想ディスプレイをペーストしなければなりません。仮想ディスプレイの中で，ビューポートの内部に存在する部分だけが表示されます。

ビューポートは SMG$DELETE_VIEWPORT ルーチンを使用して削除できます。このルーチンを呼び出すと，ビューポートはペーストされているペーストボードから自動的にアンペーストされます。しかし，ビューポートに対応づけられている仮想ディスプレイは削除されません。したがって，SMG$PASTE_VIRTUAL_DISPLAY ルーチンを呼び出すことにより，その仮想ディスプレイを表示できます。

SMG$PASTE_VIRTUAL_DISPLAY ルーチンは，ビューポートまたは仮想ディスプレイをペーストボードにペーストします。ビューポートを仮想ディスプレイに対応づけた後， SMG$PASTE_VIRTUAL_DISPLAY ルーチンを呼び出す場合には，仮想ディスプレイではなく，ビューポートが使用されます。つまり，仮想ディスプレイに対するビューポートを作成した後，その仮想ディスプレイの中で表示できる部分は，ビューポートの内部に含まれる長方形の領域だけです。ビューポートを削除せずに，そのビューポートをアンペーストする場合には， SMG$UNPASTE_VIRTUAL_DISPLAY ルーチンを使用します。

対応する仮想ディスプレイがすでにペーストされているときに，ビューポートを作成する場合には，そのビューポートは表示されません。 SMG$PASTE_VIRTUAL_DISPLAY ルーチンを呼び出すと，仮想ディスプレイはアンペーストされ，その場所にビューポートがペーストされます。

仮想ディスプレイに対応するビューポートは，ペーストボードに全体，またはある一部分をペーストできます。あるいはペーストボードの完全な外に置くこともできます。ただし，ビューポートは対応づけられた仮想ディスプレイを越えて拡大することはできません。仮想ディスプレイの境界をこえてビューポートを拡張しようとした場合には，日本語 SMG は仮想ディスプレイの内部に収まるように，自動的にビューポートを切り詰めます。

ビューポートを "スクロール" するには，そのビューポートに対応する仮想ディスプレイをスクロールします。この場合には，SMG$SCROLL_VIEWPORT ルーチンを呼び出します。実際には，スクロールをシミュレートするために，ビューポートが仮想ディスプレイ上で移動するたびに，ビューポートの座標が変化します。しかし，画面上でのビューポートの位置は変化しません。 SMG$SCROLL_VIEWPORT ルーチンを使用する場合には，スクロールの方向(上，下，左，右)を指定できます。

ビューポートを移動する場合には，SMG$CHANGE_VIEWPORT ルーチンを呼び出します。このルーチンを使用する場合には，ビューポートの新しい開始位置とサイズを指定できます。ビューポートの開始位置とサイズを変更すれば，仮想ディスプレイ上でウィンドウを移動できます。

SMG$GET_VIEWPORT_CHAR ルーチンを使用すれば，ビューポートの現在の属性を検索できます。ビューポートの属性は，ビューポートの開始行と終了行，および開始カラムと終了カラムで構成されます。このルーチンは SMG$CHANGE_VIEWPORT ルーチンと組み合わせて使用でき，既存のビューポートの開始位置と終了位置を変更できます。

開始位置または終了位置以外のビューポート属性を変更する場合には， SMG$CHANGE_VIRTUAL_DISPLAY ルーチンを使用しなければなりません。仮想ディスプレイへのすべての変更は，対応するビューポートで反映されます。

たとえば，仮想ディスプレイに境界がある場合には，対応するビューポートにも境界があります。仮想ディスプレイに境界がない場合には，ビューポートにも境界がありません。ビューポートに境界を追加したり，削除する場合には，SMG$CHANGE_VIRTUAL_DISPLAY ルーチンを使用して仮想ディスプレイに境界を追加するか，または仮想ディスプレイから境界を削除します。この変更操作はビューポートで自動的に反映されます。

2.2.11 メニュー

日本語 SMG には，メニューに選択項目を作成する機能とメニューから項目を選択する機能があります。メニューはブロック・メニュー，垂直メニュー，水平メニューのいずれでもかまいません。ブロック・メニューは項目を2次元に並べた配列であり，おもに使用されるメニュー・タイプです。垂直メニューはメニュー項目を1列に縦に並べて表示し，水平メニューはメニュー項目を1行に横に並べて表示します。ビューポートの境界内に収まらないメニュー項目は，表示領域にスクロールされるまで表示されません。

2.2.11.1 メニューの作成

SMG$CREATE_MENU ルーチンは，指定された仮想ディスプレイのスクロール領域にメニューを作成します ( 省略時の設定では，スクロール領域は仮想ディスプレイ全体です。 SMG$SET_DISPLAY_SCROLL_REGION ルーチンを使用すれば，スクロール領域を変更できます )。メニューを作成するときに，メニューの形式 ( ブロック，垂直，水平のいずれか ) を指定します。

ブロック・メニューはメニューの省略時の形式です。メニュー内の項目は一定の文字列配列の形式でルーチンに渡されます。省略時の設定では，各メニュー項目はシングル・スペースで配置されますが，ダブル・スペースも要求できます。水平方向には，各メニュー項目は4つのスペースで区切られます。さらに，メニュー項目を 固定形式 カラムに表示することも要求できます。この場合には，カラムの幅は渡される固定長文字列のサイズに等しくなります。

各仮想ディスプレイには，1 つのメニューだけを格納できます。また，SMG$CREATE_MENU ルーチンを呼び出した後，ディスプレイ内のメニューを格納した領域に，他の文字を出力することはできません。このような操作を実行すると，予測できない結果になります。メニューは仮想ディスプレイのスクロール領域に出力されます。

2.2.11.2 メニューの削除

メニューを削除するには，SMG$DELETE_MENU ルーチンを使用します。このルーチンは，指定された仮想ディスプレイ内のメニュー項目に対するアクセスを禁止します。さらに，SMG$DELETE_MENU ルーチンがメニューを削除するときに，すべてのメニュー項目をディスプレイから削除することも要求できます。

2.2.11.3 メニューからの選択

メニューを作成した後， SMG$SELECT_FROM_MENU ルーチンを使用してそのメニューから項目を選択できます。 1 つのメニュー項目から別のメニュー項目に移動すると，省略時の設定では，現在選択されている項目が反転表示されます。 SMG$SELECT_FROM_MENU ルーチンを呼び出したときに，省略時の選択項目を指定できます。省略時の選択項目を指定しなかった場合には，前に選択した項目が強調表示されたままになります。

SMG$SELECT_FROM_MENU ルーチンには，3 種類の操作モードがあります。これらのモードは flags 引数を使用して切り換えることができます。各モードについては，この後の項で説明します。

2.2.11.3.1 省略時のモード

SMG$SELECT_FROM_MENU ルーチンの省略時の操作モードは， flags 引数を省略することにより有効になります。このモードでは，矢印キーを使用して各メニュー項目間を移動でき，項目を選択した後，別の項目を追加選択できます。また，省略時のモードでは，すでに選択されている項目を "再選択" できます。

2.2.11.3.2 RETURN_IMMED モード

SMG$SELECT_FROM_MENU ルーチンの flags 引数の値として， SMG$M_RETURN_IMMEDを指定した場合には，矢印キーを使用してメニュー項目間を移動できます。しかし，他のキーを押すと，制御はユーザに戻されます。 [Ctrl/Z] は現在の項目を選択し，SMG$_EOF を戻します。他のキーを押した場合には，現在の項目が選択されます。

省略時のモードが提供するキー定義以外のキー定義が必要な場合には， SMG$M_RETURN_IMMED モードを使用します。

---

目次

索引