
:mod:`curses.panel` --- curses のためのパネルスタック拡張
=========================================================

.. module:: curses.panel
   :synopsis: curses ウィンドウに深さの概念を追加するパネルスタック拡張。
.. sectionauthor:: A.M. Kuchling <amk@amk.ca>


パネルは深さ (depth) の機能が追加されたウィンドウです。これにより、ウィンドウをお互いに重ね合わせることができ、各ウィンドウの可視部分だけ
が表示されます。パネルはスタック中に追加したり、スタック内で上下移動させたり、スタックから除去することができます。


.. _cursespanel-functions:

関数
----

:mod:`curses.panel` では以下の関数を定義しています:


.. function:: bottom_panel()

   パネルスタックの最下層のパネルを返します。


.. function:: new_panel(win)

   与えられたウィンドウ *win* に関連付けられたパネルオブジェクトを返します。返されたパネルオブジェクトを参照しておく必要があることに注意
   してください。もし参照しなければ、パネルオブジェクトはガベージコレクションされてパネルスタックから削除されます。


.. function:: top_panel()

   パネルスタックの最上層のパネルを返します。


.. function:: update_panels()

   仮想スクリーンをパネルスタック変更後の状態に更新します。この関数では :func:`curses.doupdate` を呼ばないので、ユーザは自分で呼び出す
   必要があります。


.. _curses-panel-objects:

Panel オブジェクト
------------------

上記の :func:`new_panel` が返す Panel オブジェクトはスタック順の概念を持つウィンドウです。
ウィンドウはパネルに関連付けられており、表示する内容を決定している一方、パネルのメソッドはパネルスタック中のウィンドウの深さ管理を担います。

Panel オブジェクトは以下のメソッドを持っています:


.. method:: Panel.above()

   現在のパネルの上にあるパネルを返します。


.. method:: Panel.below()

   現在のパネルの下にあるパネルを返します。


.. method:: Panel.bottom()

   パネルをスタックの最下層にプッシュします。


.. method:: Panel.hidden()

   パネルが隠れている (不可視である) 場合に真を返し、そうでない場合偽を返します。


.. method:: Panel.hide()

   パネルを隠します。この操作ではオブジェクトは消去されず、スクリーン上のウィンドウを不可視にするだけです。


.. method:: Panel.move(y, x)

   パネルをスクリーン座標 ``(y, x)`` に移動します。


.. method:: Panel.replace(win)

   パネルに関連付けられたウィンドウを *win* に変更します。


.. method:: Panel.set_userptr(obj)

   パネルのユーザポインタを *obj* に設定します。このメソッドは任意のデータをパネルに関連付けるために使われ、任意の Python オブジェクト
   にすることができます。


.. method:: Panel.show()

   (隠れているはずの) パネルを表示します。


.. method:: Panel.top()

   パネルをスタックの最上層にプッシュします。


.. method:: Panel.userptr()

   パネルのユーザポインタを返します。任意の Python オブジェクトです。


.. method:: Panel.window()

   パネルに関連付けられているウィンドウオブジェクトを返します。

