名称

menu_format - メニューサイズを設定するか取得する

書式

#include <menu.h> int set_menu_format(MENU *menu, int rows, int cols); void menu_format(const MENU *menu, int *rows, int *cols);

解説

関数 set_menu_format は、与えられたメニューの最大のディスプレイサイズを設定します。このサイズがすべてのメニュー項目を表示するには小さすぎるなら、メニューはスクロールすることができるでしょう。このサイズがメニューサブウィンドウより大きく、サブウィンドウがすべてのメニュー項目を表示するには小さすぎるなら、 post_menu() は失敗するでしょう。

デフォルトフォーマットは、16 行、1 列です。 NULL メニューポインタで set_menu_format を呼ぶことはこのデフォルトを変更するでしょう。 set_menu_format への 0 行か列引数は、現在値を変更しないリクエストとして解釈されます。

関数 menu_format は、 rows と cols によってアドレスづけされた記憶域へ与えられたメニューのためのに最大サイズ制限を返します。

戻り値

これらのルーチンは次の一つを返します:

E_OK

ルーチンが成功した。

E_SYSTEM_ERROR

システムエラーが生じた ( errno 参照)。

E_BAD_ARGUMENT

ルーチンは正しくないか範囲外の引数を検知しました。

E_POSTED

メニューは既に記入されています。

E_NOT_CONNECTED

項目はメニューに接続されていません。

関連項目

curses(3X), menu(3X)

注

ヘッダファイル <menu.h> は自動的にヘッダファイル <curses.h> を含んでいます。

移植性

これらのルーチンは、System V メニューライブラリをエミュレートします。それらは、Version 7 または BSD バージョンではサポートされませんでした。

作者

Juergen Pfeifer。マニュアルページと新しい curses の適応は、Eric S. Raymond。