EN JA
mitem_current(3X)
mitem_current(3X) mitem_current(3X)

名称

mitem_current - 現在のメニューアイテム (項目) を設定するか取得する

書式

#include <menu.h>
 
int set_current_item(MENU *menu, const ITEM *item);
 
ITEM *current_item(const MENU *menu);
 
int set_top_row(MENU *menu, int row);
 
int top_row(const MENU *menu);
 
int item_index(const ITEM *item);
 

解説

関数 set_current_item は現在のアイテム (項目) (メニューカーソルが置かれるアイテム) を設定します。 current_item は、与えられたメニュー中の現在のアイテムのポインタを返します。

関数 set_top_row はメニューのトップ行に与えられた行 (トップの行は最初に 0 で、 O_ROWMAJOR オプションがトグルするときはいつでも、この値はリセットされます) を設定します。与えられた行の左端のアイテムはカレント (現在) となります。関数 top_row は、表示されているトップのメニュー行の数を返します。

関数 item_index は、メニューのアイテムポインタリスト中の item の (0 基点の) インデックスを返します。

戻り値

current_item は、( NULL であるかもしれない) ポインタを返します。それは、 errno を設定しません。

top_rowitem_index は、それらの menu パラメータが NULL であるなら、 (一般的な curses エラー値) ERR を返します。

set_current_itemset_top_row は、次の 1 つを返します:

E_OK
ルーチンが成功した。
E_BAD_ARGUMENT
ルーチンは正しくないか範囲外の引数を検知しました。
E_BAD_STATE
ルーチンは初期化または終了の関数から呼ばれました。
E_NOT_CONNECTED
アイテムはメニューに接続されていません。
E_SYSTEM_ERROR
システムエラーが生じた ( errno 参照)。

関連項目

curses(3X), menu(3X)

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

移植性

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

SVr4 メニューライブラリドキュメンテーションは、 top_rowindex_item のエラー値として -1 ( ERR の値) を仕様化しています。

作者

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