mitem_current(3X) | mitem_current(3X) |
名称
mitem_current - 現在のメニューアイテム (項目) を設定するか取得する書式
#include <menu.h>解説
関数 set_current_item は現在のアイテム (項目) (メニューカーソルが置かれるアイテム) を設定します。 current_item は、与えられたメニュー中の現在のアイテムのポインタを返します。関数 set_top_row はメニューのトップ行に与えられた行 (トップの行は最初に 0 で、 O_ROWMAJOR オプションがトグルするときはいつでも、この値はリセットされます) を設定します。与えられた行の左端のアイテムはカレント (現在) となります。関数 top_row は、表示されているトップのメニュー行の数を返します。
関数 item_index は、メニューのアイテムポインタリスト中の item の (0 基点の) インデックスを返します。
戻り値
current_item は、( NULL であるかもしれない) ポインタを返します。それは、 errno を設定しません。top_row と item_index は、それらの menu パラメータが NULL であるなら、 (一般的な curses エラー値) ERR を返します。
set_current_item と set_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_row と index_item のエラー値として -1 ( ERR の値) を仕様化しています。