OpenVMS マニュアル

第 6 章
Curses 画面管理関数とマクロ

この章では， HP C for OpenVMS システムで提供される画面管理ルーチンについて説明します。

OpenVMS Curses 画面管理パッケージは，すべての OpenVMS システムでサポートされます。

OpenVMS Alpha システムでは， 2 つの画面管理パッケージがサポートされます。それは OpenVMS Curses と，UNIX との互換性がより高く， BSD (Berkeley Standard Distribution) Curses ソフトウェア ¹ 第 6.1 節 を参照してください。

さらに， HP C RTL では，4.4BSD Berkeley Software Distribution をベースにした Curses パッケージも提供されるようになりました。 4.4BSD Curses パッケージに関する情報は，Kenneth C.R.C. Arnold 著，『Screen Updating and Cursor Movement Optimization: A Library Package』に記載されています。

OpenVMS と BSD ベースの Curses パッケージの関数およびマクロはほぼ同じです。両者の相違点の大部分については，この章で説明しています。それ以外の場合は，この章では 2 つの Curses パッケージを区別せず，単に「Curses」または「Curses 関数とマクロ」と呼んでいます。

6.1 BSD ベースの Curses パッケージの使用 (Alpha only)

BSD ベースの Curses の実装を使用するのに必要な <curses.h>ヘッダ・ファイルは， OpenVMS Alpha システムでは HP C コンパイラで提供されます。

OpenVMS Curses 関数はデフォルトの Curses パッケージとして提供されるため，既存のプログラムは BSD ベースの Curses 関数の影響を受けません ( この点は，BSD ベースの Curses がデフォルトであった HP C の以前のバージョンから変更された点です)。

4.4BSD Curses の実装を入手するには，次の修飾子を使用して <curses.h>を取り込むモジュールをコンパイルする必要があります。

/DEFINE=_BSD44_CURSES

BSD ベースの Curses 関数では，Curses 関数によって割り当てられたペーストボードとキーボードを使用する OpenVMS SMG$ ルーチンを呼び出すのに必要なサポートは提供されません。したがって， SMG$ エントリ・ポイントの呼び出しおよび Curses 関数に依存する Curses プログラムは，今後も OpenVMS の Curses を使用する必要があります。

BSD ベースの Curses は，以前の実装との間で相互運用性がありません。新しい関数と古い関数の呼び出しが混在している場合，画面に不正な出力が表示され，SMG$ ルーチンから例外が発生する可能性があります。

6.2 Curses の概要

Curses，つまり HP C Screen Management Package は，端末画面の定義されたセクションの作成と変更，およびカーソルの最適な移動を行う HP C RTL 関数およびマクロで構成されています。画面管理パッケージを使用すると，ユーザにとって親しみやすく，魅力のあるユーザ・インタフェースを開発できます。 Curses は端末に依存しておらず，端末画面の書式設定を簡単に行うことができ，効率のよいカーソルの移動を実現できます。

ほとんどの Curses 関数とマクロは 2 つ 1 組で示されます。最初のルーチンがマクロで，2 番目が "ウィンドウ" を表す接頭語 "w" から始まる関数です。これらの接頭語は角括弧 ([ ]) で囲んで示されます。たとえば， [w]addstrは， addstrマクロと waddstr関数を示します。マクロのウィンドウは，デフォルトで stdscrに設定され，関数は，引数として指定されたウィンドウを受け付けます。

Curses 関数およびマクロにアクセスするには， <curses.h>ヘッダ・ファイルを取り込みます。

端末に依存しない Screen Management Software は OpenVMS RTL の一部であり， Curses を実装するために使用されます。移植性を確保するために，ほとんどの関数とマクロは他の C の実装と同様の方法で動作するように設計されています。しかし，Curses ルーチンは OpenVMS システムおよびその Screen Management Software に依存しているため，一部の関数とマクロの動作は他の実装の関数およびマクロと少し異なる可能性があります。

他のシステムで提供される関数とマクロの中には， HP C RTL Curses パッケージで提供されないものがあります。

[w]clrattr， [w]insstr， mv[w]insstr， [w]setattrなどの一部の関数は， HP C for OpenVMS Systems 固有であり，移植できません。

表 6-1 は， HP C RTL で提供されるすべての Curses 関数とマクロを示しています。各関数とマクロの詳細については，『HP C ランタイム・ライブラリ・リファレンス・マニュアル (下巻)』「リファレンス・セクション」を参照してください。

6.3 Curses の用語

ここでは，Curses の用語について説明し， Curses で端末画面がどのように取り扱われるかを示します。

Curses アプリケーションは重なり合う複数のウィンドウであると考えることができます。ウィンドウの重なり合いのことを重なり (occlusion) と呼びます。これらの重なり合うウィンドウの境界を区別するには，四角形のウィンドウに指定の文字で輪郭をつけるか，または反転表示オプションをオンにします ( ウィンドウの表示を明るい背景，暗い描画色に設定します )。

6.3.1 定義済みウィンドウ (stdscr と curscr)

端末画面の初期サイズ設定は， Curses で 2 つのウィンドウによってあらかじめ定義されています。これらのウィンドウを stdscrと curscrと呼びます。 stdscrウィンドウはユーザが使用するために定義されています。多くの Curses マクロのデフォルトはこのウィンドウに設定されています。たとえば， stdscrの周囲に四角形を描き，画面の左上にカーソルを移動し，文字列を stdscrに書き込み，端末画面に stdscrを表示すると，表示は 図 6-1 に示すようになります。

図 6-1 stdscr ウィンドウの例

---

2 番目の定義済みウィンドウである curscrは，内部的な Curses の動作のために設計されています。これは，端末画面に現在表示されているもののイメージです。このウィンドウを引数として受け付ける HP C for OpenVMS Curses 関数は clearokだけです。 curscrに対して，書き込みや読み込みを行うことはできません。すべての Curses アプリケーションで， stdscrおよびユーザ定義ウィンドウを使用してください。

6.3.2 ユーザ定義ウィンドウ

ユーザは， stdscrの上に自分のウィンドウを重ねることができます。各ウィンドウのサイズと位置は，行数，列数，開始位置によって示されます。

端末画面の行と列によって座標系，つまりウィンドウが作成されるグリッドが形成されます。ウィンドウの開始位置は，ウィンドウの左上の角の (y,x) 座標によって指定します。たとえば，端末画面の座標 (0,0) は画面の左上の角です。

ウィンドウの領域全体が端末画面の境界線の内部になければなりません。ウィンドウのサイズは 1 文字の大きさから端末画面全体の大きさまで，自由に設定できます。また，メモリの範囲内であれば，ウィンドウはいくつでも作成できます。

ウィンドウに書き込んだり，ウィンドウから削除しても，ウィンドウを再表示するまで，端末画面に変更結果は表示されません。ウィンドウを再表示すると，更新されたウィンドウが端末画面に表示されますが，画面の他の部分はそのまま変更されません。

デフォルト設定では，すべてのユーザ定義ウィンドウが stdscrに重なります。 stdscrと重なるだけでなく，互いに重なり合う 2 つ以上のウィンドウを作成することができます。重なり合う一方のウィンドウにデータを書き込んでも，もう一方のウィンドウにデータは書き込まれません。

オーバーラップ・ウィンドウ (サブウィンドウと呼びます) を作成することができます。宣言されるウィンドウには，サブウィンドウの領域全体を収納しなければなりません。データをサブウィンドウに書き込んだり，サブウィンドウがオーバーラップしているウィンドウの部分にデータを書き込むと，どちらのウィンドウにも新しいデータが表示されます。たとえば，サブウィンドウにデータを書き込んだ後，そのサブウィンドウを削除しても，データは下にあるウィンドウにそのまま残されます。

stdscrと重なるウィンドウ，および stdscrのサブウィンドウを作成すると，端末画面は 図 6-2 のようになります。

図 6-2 ウィンドウとサブウィンドウの表示

---

ユーザ定義ウィンドウとサブウィンドウの両方を削除した後，新しいイメージで端末画面を更新すると，端末画面は 図 6-3 のようになります。

図 6-3 端末画面の更新

---

ウィンドウに書き込んだ文字列は削除されますが，サブウィンドウに書き込んだ文字列は stdscrの上に残されます。

---

目次

索引