curses.panel --- یک افزونهی پشتهی پنل برای curses¶
پنلها پنجرههایی هستند که ویژگی عمق به آنها افزوده شده است، بنابراین میتوان آنها را روی هم چید و تنها بخشهای نمایان هر پنجره نمایش داده خواهند شد. میتوان پنلها را اضافه کرد، در پشته به بالا یا پایین جابهجا کرد و حذف کرد.
توابع¶
ماژول curses.panel استثنای زیر را تعریف میکند:
- exception curses.panel.error¶
استثنایی که هنگام بازگشت خطا از یک تابع کتابخانهی curses panel پرتاب میشود.
ماژول curses.panel توابع زیر را تعریف میکند:
- curses.panel.bottom_panel()¶
پایینترین پنل را در پشتهی پنلها برمیگرداند.
- curses.panel.new_panel(win)¶
یک شیء پنل برمیگرداند، آن را با پنجره دادهشده win مرتبط میکند و پنل جدید را در بالای پشته پنلها قرار میدهد. توجه داشته باشید که باید بهصورت صریح ارجاع به شیء پنل برگرداندهشده را نگه دارید. در غیر این صورت، شیء پنل زبالهروبی میشود و از پشته پنلها حذف میشود.
- curses.panel.top_panel()¶
بالاترین پنل در پشتهی پنلها را برمیگرداند.
- curses.panel.update_panels()¶
صفحه مجازی را پس از تغییرات در پشته پنلها بهروزرسانی میکند. این تابع
curses.doupdate()را فراخوانی نمیکند، بنابراین باید خودتان این کار را انجام دهید.
اشیای پنل¶
- class curses.panel.panel¶
اشیای پنل، همانطور که در بالا توسط
new_panel()برگردانده میشوند، پنجرههایی با ترتیب پشتهبندی هستند. همیشه پنجرهای مرتبط با یک پنل وجود دارد که محتوا را تعیین میکند، در حالی که متدهای پنل مسئول عمق پنجره در پشتهی پنلها هستند.اشیای Panel متدهای زیر را دارند:
- panel.above()¶
پنل بالای پنل جاری را برمیگرداند.
- panel.below()¶
پنل زیر پنل فعلی را برمیگرداند.
- panel.bottom()¶
پنل را به پایین پشته منتقل کنید.
اگر پنل پنهان باشد (قابل مشاهده نباشد)،
Trueو در غیر این صورتFalseرا برمیگرداند.
- panel.hide()¶
پنل را پنهان میکند. این کار شیء را حذف نمیکند، فقط پنجرهی روی صفحه را نامرئی میکند.
- panel.move(y, x)¶
پنل را به مختصات صفحه
(y, x)منتقل کنید.
- panel.replace(win)¶
پنجرهی مرتبط با پنل را به پنجرهی win تغییر دهید.
- panel.set_userptr(obj)¶
اشارهگر کاربر پنل را روی obj تنظیم کنید. این برای مرتبط کردن یک قطعه داده دلخواه با پنل استفاده میشود و میتواند هر شیء پایتون باشد.
- panel.show()¶
پنل را نمایش دهید (که ممکن است پنهان شده باشد) و آن را در بالای پشتهی پنل قرار دهید.
- panel.top()¶
پنل را به بالای پشته منتقل کنید.
- panel.userptr()¶
اشارهگر کاربرِ پنل را برمیگرداند. این ممکن است هر شیء پایتونی باشد.
- panel.window()¶
شیء پنجرهی مرتبط با پنل را برمیگرداند.