"Project-Id-Version: Python 3.14\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-09-21 11:59+0000\n"

"PO-Revision-Date: 2026-09-13 14:57+0330\n"

"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"

"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"

"Language: fa\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=2; plural=(n > 1);\n"

"X-Generator: Poedit 3.6\n"

msgid ":mod:`!curses` --- Terminal handling for character-cell displays"

msgstr ":mod:`!curses` --- مدیریت پایانه برای نمایشگرهای سلول‌نویسه‌ای (character-cell displays)"

msgid "**Source code:** :source:`Lib/curses`"

msgstr "**کد منبع:** :source:`Lib/curses`"

msgid "The :mod:`!curses` module provides an interface to the curses library, the de-facto standard for portable advanced terminal handling."

msgstr "ماژول :mod:`!curses` رابطی به کتابخانه curses فراهم می‌کند؛ استاندارد دوفاکتو برای مدیریت پیشرفته‌ی پایانه به‌صورت قابل‌حمل."

msgid "While curses is most widely used in the Unix environment, versions are available for Windows, DOS, and possibly other systems as well. This extension module is designed to match the API of ncurses, an open-source curses library hosted on Linux and the BSD variants of Unix."

msgstr "اگرچه curses بیشترین کاربرد را در محیط یونیکس دارد، نسخه‌هایی برای ویندوز، DOS و احتمالاً سیستم‌های دیگر نیز در دسترس هستند. این ماژول توسعه به‌گونه‌ای طراحی شده است که با API کتابخانه ncurses مطابقت داشته باشد؛ ncurses یک کتابخانه curses متن‌باز است که روی لینوکس و نسخه‌های BSD یونیکس میزبانی می‌شود."

msgid "Availability"

msgstr "دسترس‌پذیری"

msgid "This module is not supported on :ref:`mobile platforms <mobile-availability>` or :ref:`WebAssembly platforms <wasm-availability>`."

msgstr "این ماژول در :ref:`سکوهای موبایل <mobile-availability>` یا :ref:`سکوهای WebAssembly <wasm-availability>` پشتیبانی نمی‌شود."

msgid "This is an :term:`optional module`. If it is missing from your copy of CPython, look for documentation from your distributor (that is, whoever provided Python to you). If you are the distributor, see :ref:`optional-module-requirements`."

msgstr "این یک :term:`ماژول اختیاری <optional module>` است. اگر در نسخه CPython شما موجود نیست، به مستندات توزیع‌کننده خود (یعنی هر کسی که پایتون را در اختیار شما قرار داده است) مراجعه کنید. اگر شما توزیع‌کننده هستید، :ref:`optional-module-requirements` را ببینید."

msgid "Whenever the documentation mentions a *character* it can be specified as an integer, a one-character Unicode string or a one-byte byte string. An integer is the code of a single encoded byte, optionally combined with attributes and a color pair, as returned by :meth:`window.inch`."

msgstr "هرگاه مستندات به یک *نویسه* اشاره کند، می‌توان آن را به صورت یک عدد صحیح، یک رشته‌ی یونیکد تک‌نویسه یا یک رشته‌ی بایتی تک‌بایتی مشخص کرد. یک عدد صحیح کد یک بایت واحد کدگذاری شده است، که به صورت اختیاری با ویژگی‌ها و یک جفت رنگ ترکیب شده است، همان‌طور که توسط :meth:`window.inch` بازگردانده می‌شود."

msgid "Whenever the documentation mentions a *character string* it can be specified as a Unicode string or a byte string."

msgstr "هرگاه در مستندات به یک *رشته‌ی نویسه‌ای* اشاره شود، می‌توان آن را به‌صورت یک رشته‌ی یونیکد یا یک رشته‌ی بایت مشخص کرد."

msgid "Whether curses may be used from several threads depends on the underlying library and how it was built. In many implementations, including the default build of ncurses, the screen state is shared and not thread-safe; since the blocking and refresh methods (such as :meth:`~window.getch` and :meth:`~window.refresh`) release the :term:`GIL`, unsynchronized use from several threads can then crash the interpreter. Serialize the calls."

msgstr "استفاده از curses از چند نخ به کتابخانه‌ی زیرین و نحوه‌ی ساختِ آن بستگی دارد. در بسیاری از پیاده‌سازی‌ها، از جمله ساخت پیش‌فرض ncurses، وضعیت صفحه مشترک و نخ‌ایمن نیست؛ چون متدهای مسدود‌کننده و تازه‌سازی (مانند :meth:`~window.getch` و :meth:`~window.refresh`) :term:`GIL <GIL>` را رها می‌کنند، استفاده‌ی ناهمگام از چند نخ می‌تواند مفسر را فروپاشی کند. فراخوانی‌ها را به‌ترتیب انجام دهید."

msgid "Module :mod:`curses.ascii`"

msgstr "ماژول :mod:`curses.ascii`"

msgid "Utilities for working with ASCII characters, regardless of your locale settings."

msgstr "ابزارهایی برای کار با نویسه‌های ASCII، صرف‌نظر از تنظیمات locale (locale) شما."

msgid "Module :mod:`curses.panel`"

msgstr "ماژول :mod:`curses.panel`"

msgid "A panel stack extension that adds depth to curses windows."

msgstr "یک افزونه‌ی پشته‌ی پنل که به پنجره‌های curses عمق می‌بخشد."

msgid "Module :mod:`curses.textpad`"

msgstr "ماژول :mod:`curses.textpad`"

msgid "Editable text widget for curses supporting :program:`Emacs`\\ -like bindings."

msgstr "ابزارک متنی قابل‌ویرایش برای curses با پشتیبانی از کلیدبندی‌های مشابه :program:`Emacs`."

msgid ":ref:`curses-howto`"

msgstr ":ref:`curses-howto`"

msgid "Tutorial material on using curses with Python, by Andrew Kuchling and Eric Raymond."

msgstr "مطلب آموزشی درباره‌ی استفاده از curses در پایتون، نوشته‌ی Andrew Kuchling و Eric Raymond."

msgid "Functions"

msgstr "توابع"

msgid "The module :mod:`!curses` defines the following exception:"

msgstr "ماژول :mod:`!curses` استثنای زیر را تعریف می‌کند:"

msgid "Exception raised when a curses library function returns an error."

msgstr "استثنایی که هنگام برگرداندن خطا توسط تابعی از کتابخانه curses پرتاب می‌شود."

msgid "Whenever *x* or *y* arguments to a function or a method are optional, they default to the current cursor location. Whenever *attr* is optional, it defaults to :const:`A_NORMAL`."

msgstr "هرگاه آرگومان‌های *x* یا *y* برای یک تابع یا متد اختیاری باشند، مقدار پیش‌فرض آن‌ها موقعیت فعلی مکان‌نما خواهد بود. هرگاه *attr* اختیاری باشد، مقدار پیش‌فرض آن :const:`A_NORMAL` خواهد بود."

msgid "The module :mod:`!curses` defines the following functions:"

msgstr "ماژول :mod:`!curses` توابع زیر را تعریف می‌کند:"

msgid "Allow use of default values for colors on terminals supporting this feature. Use this to support transparency in your application."

msgstr "اجازه استفاده از مقادیر پیش‌فرض برای رنگ‌ها در پایانه‌هایی که این قابلیت را پشتیبانی می‌کنند. از این برای پشتیبانی از شفافیت در برنامه‌تان استفاده کنید."

msgid "Assign terminal default foreground/background colors to color number ``-1``. So ``init_pair(x, COLOR_RED, -1)`` will initialize pair *x* as red on default background and ``init_pair(x, -1, COLOR_BLUE)`` will initialize pair *x* as default foreground on blue."

msgstr "رنگ‌های پیش‌فرض پیش‌زمینه/پس‌زمینه پایانه را به شماره‌ی رنگ ``-1`` اختصاص می‌دهد. بنابراین ``init_pair(x, COLOR_RED, -1)`` جفت *x* را به‌صورت قرمز روی پس‌زمینه پیش‌فرض مقداردهی اولیه می‌کند و ``init_pair(x, -1, COLOR_BLUE)`` جفت *x* را به‌صورت پیش‌زمینه پیش‌فرض روی پس‌زمینه آبی مقداردهی اولیه می‌کند."

msgid "Change the definition of the color-pair ``0`` to ``(fg, bg)``."

msgstr "تعریف جفت‌رنگ ``0`` را به ``(fg, bg)`` تغییر دهید."

msgid "This is an ncurses extension."

msgstr "این یک افزونه برای ncurses است."

msgid "Return the output speed of the terminal in bits per second. On software terminal emulators it will have a fixed high value. Included for historical reasons; in former times, it was used to write output loops for time delays and occasionally to change interfaces depending on the line speed."

msgstr "سرعت خروجی پایانه را بر حسب بیت بر ثانیه برمی‌گرداند. در شبیه‌سازهای نرم‌افزاری پایانه، این سرعت مقدار ثابت بالایی خواهد داشت. به دلایل تاریخی گنجانده شده است؛ در گذشته، برای نوشتن حلقه‌های خروجی جهت تأخیرهای زمانی و گاهی برای تغییر رابط‌ها بسته به سرعت خط استفاده می‌شد."

msgid "Emit a short attention sound."

msgstr "یک صدای کوتاه برای جلب توجه پخش می‌کند."

msgid "Return ``True`` or ``False``, depending on whether the programmer can change the colors displayed by the terminal."

msgstr "برگرداندن ``True`` یا ``False``، بسته به اینکه برنامه‌نویس بتواند رنگ‌هایی را که پایانه نمایش می‌دهد تغییر دهد."

msgid "Enter cbreak mode. In cbreak mode (sometimes called \"rare\" mode) normal tty line buffering is turned off and characters are available to be read one by one. However, unlike raw mode, special characters (interrupt, quit, suspend, and flow control) retain their effects on the tty driver and calling program. Calling first :func:`raw` then :func:`cbreak` leaves the terminal in cbreak mode."

msgstr "وارد حالت cbreak می‌شود. در حالت cbreak (که گاهی به آن حالت «rare» می‌گویند) بافرینگ خطی معمول tty غیرفعال می‌شود و نویسه‌ها برای خوانده‌شدن به‌صورت یکی‌یکی در دسترس قرار می‌گیرند. با این حال، برخلاف حالت raw، نویسه‌های ویژه (وقفه، خروج، تعلیق و کنترل جریان) اثرات خود را بر راه‌انداز tty و برنامه فراخوان حفظ می‌کنند. اگر ابتدا :func:`raw` و سپس :func:`cbreak` فراخوانی شود، پایانه در حالت cbreak باقی می‌ماند."

msgid "Return the intensity of the red, green, and blue (RGB) components in the color *color_number*, which must be between ``0`` and ``COLORS - 1``. Return a 3-tuple, containing the R,G,B values for the given color, which will be between ``0`` (no component) and ``1000`` (maximum amount of component). Raise an exception if the color is not supported."

msgstr "شدت کامپوننت‌های قرمز، سبز و آبی (RGB) در رنگ *color_number* را برمی‌گرداند. *color_number* باید بین ``0`` و ``COLORS - 1`` باشد. یک تاپل سه‌تایی شامل مقادیر R، G، B برای رنگ داده‌شده برمی‌گرداند؛ این مقادیر بین ``0`` (بدون کامپوننت) و ``1000`` (حداکثر مقدار کامپوننت) خواهند بود. اگر رنگ پشتیبانی نشود، یک استثنا پرتاب می‌کند."

msgid "Return the attribute value for displaying text in the specified color pair. Only the first 256 color pairs are supported. This attribute value can be combined with :const:`A_STANDOUT`, :const:`A_REVERSE`, and the other :const:`!A_\\*` attributes. :func:`pair_number` is the counterpart to this function."

msgstr "مقدار ویژگی را برای نمایش متن در جفت رنگ مشخص‌شده برمی‌گرداند. تنها از نخستین ۲۵۶ جفت رنگ پشتیبانی می‌شود. این مقدار ویژگی را می‌توان با :const:`A_STANDOUT`، :const:`A_REVERSE` و سایر ویژگی‌های :const:`!A_\\*` ترکیب کرد. :func:`pair_number` متقابل این تابع است."

msgid "Set the cursor state. *visibility* can be set to ``0``, ``1``, or ``2``, for invisible, normal, or very visible. If the terminal supports the visibility requested, return the previous cursor state; otherwise raise an exception. On many terminals, the \"visible\" mode is an underline cursor and the \"very visible\" mode is a block cursor."

msgstr "وضعیت مکان‌نما را تنظیم می‌کند. می‌توان *visibility* را روی ``0``، ``1``، یا ``2`` برای حالت‌های نامرئی، عادی، یا بسیار نمایان تنظیم کرد. اگر پایانه از حالت نمایش درخواستی پشتیبانی کند، وضعیت قبلی مکان‌نما را برمی‌گرداند؛ در غیر این صورت استثنایی پرتاب می‌کند. در بسیاری از پایانه‌ها، حالت «نمایان» یک مکان‌نمای خط زیر و حالت «بسیار نمایان» یک مکان‌نمای بلوکی است."

msgid "Save the current terminal mode as the \"program\" mode, the mode when the running program is using curses. (Its counterpart is the \"shell\" mode, for when the program is not in curses.) Subsequent calls to :func:`reset_prog_mode` will restore this mode."

msgstr "حالت فعلی پایانه را به‌عنوان حالت «برنامه» ذخیره می‌کند، حالتی که برنامه‌ی در حال اجرا از curses استفاده می‌کند. (همتای آن حالت «پوسته» است، برای زمانی که برنامه در curses نیست.) فراخوانی‌های بعدی :func:`reset_prog_mode` این حالت را بازمی‌گردانند."

msgid "Save the current terminal mode as the \"shell\" mode, the mode when the running program is not using curses. (Its counterpart is the \"program\" mode, when the program is using curses capabilities.) Subsequent calls to :func:`reset_shell_mode` will restore this mode."

msgstr "حالت جاری پایانه را به‌عنوان حالت «پوسته» ذخیره می‌کند، حالتی که برنامه‌ی در حال اجرا از curses استفاده نمی‌کند. (حالت متناظر آن، حالت «برنامه» است، زمانی که برنامه از قابلیت‌های curses استفاده می‌کند.) فراخوانی‌های بعدی :func:`reset_shell_mode` این حالت را بازگردانی می‌کند."

msgid "Insert an *ms* millisecond pause in output."

msgstr "یک مکث *ms* میلی‌ثانیه‌ای در خروجی درج کنید."

msgid "Update the physical screen. The curses library keeps two data structures, one representing the current physical screen contents and a virtual screen representing the desired next state. The :func:`doupdate` function updates the physical screen to match the virtual screen."

msgstr "صفحه فیزیکی را به‌روزرسانی می‌کند. کتابخانه‌ی curses دو ساختار داده را نگه می‌دارد: یکی نشان‌دهنده‌ی محتویات فعلی صفحه فیزیکی و دیگری یک صفحه مجازی است که وضعیت بعدی مورد نظر را نشان می‌دهد. تابع :func:`doupdate` صفحه فیزیکی را به‌روزرسانی می‌کند تا با صفحه مجازی مطابقت داشته باشد."

msgid "The virtual screen may be updated by a :meth:`~window.noutrefresh` call after write operations such as :meth:`~window.addstr` have been performed on a window. The normal :meth:`~window.refresh` call is simply :meth:`!noutrefresh` followed by :func:`!doupdate`; if you have to update multiple windows, you can speed performance and perhaps reduce screen flicker by issuing :meth:`!noutrefresh` calls on all windows, followed by a single :func:`!doupdate`."

msgstr "صفحه‌ی مجازی می‌تواند پس از انجام عملیات نوشتن مانند :meth:`~window.addstr` روی یک پنجره، با یک فراخوانی :meth:`~window.noutrefresh` به‌روزرسانی شود. فراخوانی معمول :meth:`~window.refresh` صرفاً :meth:`!noutrefresh` و به‌دنبال آن :func:`!doupdate` است؛ اگر لازم است چندین پنجره را به‌روزرسانی کنید، می‌توانید با انجام فراخوانی‌های :meth:`!noutrefresh` روی تمام پنجره‌ها و به‌دنبال آن‌ها یک :func:`!doupdate`، سرعت عملکرد را افزایش دهید و شاید سوسوی صفحه را کاهش دهید."

msgid "Enter echo mode. In echo mode, each character input is echoed to the screen as it is entered."

msgstr "وارد حالت بازتاب (echo mode) شوید. در حالت بازتاب، هر نویسه‌ی ورودی به محض وارد شدن، روی صفحه بازتاب داده می‌شود."

msgid "De-initialize the library, and return terminal to normal status."

msgstr "کتابخانه را از مقداردهی اولیه خارج می‌کند و پایانه را به وضعیت عادی بازمی‌گرداند."

msgid "Return the user's current erase character as a one-byte bytes object. Under Unix operating systems this is a property of the controlling tty of the curses program, and is not set by the curses library itself."

msgstr "نویسه حذف فعلی کاربر را به‌عنوان یک شیء bytes یک‌بایتی برمی‌گرداند. در سیستم‌عامل‌های یونیکسی، این یک ویژگی از tty کنترل‌کننده برنامه curses است و توسط خود کتابخانه curses تنظیم نمی‌شود."

msgid "The :func:`.filter` routine, if used, must be called before :func:`initscr` is called. The effect is that, during the initialization, :envvar:`LINES` is set to ``1``; the capabilities ``clear``, ``cup``, ``cud``, ``cud1``, ``cuu1``, ``cuu``, ``vpa`` are disabled; and the ``home`` string is set to the value of ``cr``. The effect is that the cursor is confined to the current line, and so are screen updates. This may be used for enabling character-at-a-time line editing without touching the rest of the screen."

msgstr "روال :func:`.filter`، در صورتی که استفاده شود، باید پیش از فراخوانی :func:`initscr` فراخوانی شود. اثر آن این است که در حین راه‌اندازی، :envvar:`LINES` روی ``1`` تنظیم می‌شود؛ قابلیت‌های ``clear``، ``cup``، ``cud``، ``cud1``، ``cuu1``، ``cuu`` و ``vpa`` غیرفعال می‌شوند؛ و رشته‌ی ``home`` به مقدار ``cr`` تنظیم می‌شود. اثر آن این است که مکان‌نما به خط جاری محدود می‌شود و به‌روزرسانی‌های صفحه نیز به خط جاری محدود هستند. می‌توان از این امکان برای فعال‌سازی ویرایش خط به‌صورت نویسه‌به‌نویسه بدون دست زدن به سایر بخش‌های صفحه استفاده کرد."

msgid "Flash the screen. That is, change it to reverse-video and then change it back in a short interval. Some people prefer such as 'visible bell' to the audible attention signal produced by :func:`beep`."

msgstr "صفحه را چشمک بزنید. یعنی آن را به حالت ویدیوی معکوس (reverse-video) تغییر دهید و سپس در بازه‌ی کوتاهی آن را به حالت پیشین برگردانید. برخی افراد چنین چیزی را به‌عنوان «زنگ قابل مشاهده (visible bell)» به سیگنال جلب توجه شنیداری تولیدشده توسط :func:`beep` ترجیح می‌دهند."

msgid "Flush all input buffers. This throws away any typeahead that has been typed by the user and has not yet been processed by the program."

msgstr "تمام بافرهای ورودی را تخلیه می‌کند. این کار هرگونه پیش‌تایپ (typeahead) را که کاربر تایپ کرده است و برنامه هنوز آن را پردازش نکرده است، دور می‌ریزد."

msgid "After :meth:`~window.getch` returns :const:`KEY_MOUSE` to signal a mouse event, this method should be called to retrieve the queued mouse event, represented as a 5-tuple ``(id, x, y, z, bstate)``. *id* is an ID value used to distinguish multiple devices, and *x*, *y*, *z* are the event's coordinates. (*z* is currently unused.) *bstate* is an integer value whose bits will be set to indicate the type of event, and will be the bitwise OR of one or more of the following constants, where *n* is the button number from 1 to 5: :const:`BUTTONn_PRESSED`, :const:`BUTTONn_RELEASED`, :const:`BUTTONn_CLICKED`, :const:`BUTTONn_DOUBLE_CLICKED`, :const:`BUTTONn_TRIPLE_CLICKED`, :const:`BUTTON_SHIFT`, :const:`BUTTON_CTRL`, :const:`BUTTON_ALT`."

msgstr "پس از اینکه :meth:`~window.getch` :const:`KEY_MOUSE` را برای اعلام یک رویداد ماوس برگرداند، باید این متد فراخوانی شود تا رویداد ماوس در صف بازیابی شود؛ این رویداد به‌صورت یک ۵-تایی ``(id, x, y, z, bstate)`` نمایش داده می‌شود. *id* یک مقدار شناسه برای تمایز دستگاه‌های متعدد است، و *x*، *y*، *z* مختصات رویداد هستند. (*z* در حال حاضر استفاده نشده است.) *bstate* یک مقدار عدد صحیح است که بیت‌های آن برای نشان دادن نوع رویداد تنظیم خواهند شد و برابر با OR بیتی یک یا چند مورد از ثابت‌های زیر خواهد بود، که در آن *n* شماره‌ی دکمه از ۱ تا ۵ است: :const:`BUTTONn_PRESSED`، :const:`BUTTONn_RELEASED`، :const:`BUTTONn_CLICKED`، :const:`BUTTONn_DOUBLE_CLICKED`، :const:`BUTTONn_TRIPLE_CLICKED`، :const:`BUTTON_SHIFT`، :const:`BUTTON_CTRL`، :const:`BUTTON_ALT`."

msgid "The ``BUTTON5_*`` constants are now exposed if they are provided by the underlying curses library."

msgstr "ثابت‌های ``BUTTON5_*`` اکنون در صورتی که توسط کتابخانه curses زیرین ارائه شده باشند، در دسترس قرار می‌گیرند."

msgid "Return the current coordinates of the virtual screen cursor as a tuple ``(y, x)``. If :meth:`leaveok <window.leaveok>` is currently ``True``, then return ``(-1, -1)``."

msgstr "مختصات فعلی مکان‌نما صفحه‌ی مجازی را به‌صورت یک تاپل ``(y, x)`` برمی‌گرداند. اگر :meth:`leaveok <window.leaveok>` در حال حاضر ``True`` باشد، سپس ``(-1, -1)`` را برمی‌گرداند."

msgid "Read window-related data stored in the file by an earlier :meth:`window.putwin` call. The routine then creates and initializes a new window using that data, returning the new window object. The *file* argument must be a file object opened for reading in binary mode."

msgstr "داده‌های مرتبط با پنجره را که در پرونده توسط یک فراخوانی قبلی :meth:`window.putwin` ذخیره شده‌اند، می‌خواند. سپس این روال با استفاده از آن داده‌ها، پنجره‌ی جدیدی را ایجاد و مقداردهی اولیه می‌کند و شیء پنجره‌ی جدید را برمی‌گرداند. آرگومان *file* باید یک شیء پرونده باشد که برای خواندن در حالت دودویی باز شده است."

msgid "Return ``True`` if the terminal can display colors; otherwise, return ``False``."

msgstr "اگر پایانه بتواند رنگ‌ها را نمایش دهد، ``True`` را برمی‌گرداند؛ در غیر این صورت، ``False`` را برمی‌گرداند."

msgid "Return ``True`` if the module supports extended colors; otherwise, return ``False``. Extended color support allows more than 256 color pairs for terminals that support more than 16 colors (for example, xterm-256color)."

msgstr "اگر ماژول از رنگ‌های گسترش‌یافته پشتیبانی کند، ``True`` را برمی‌گرداند؛ در غیر این صورت، ``False`` را برمی‌گرداند. پشتیبانی از رنگ‌های گسترش‌یافته، بیش از ۲۵۶ جفت‌رنگ را برای پایانه‌هایی که از بیش از ۱۶ رنگ پشتیبانی می‌کنند (برای مثال، xterm-256color) امکان‌پذیر می‌سازد."

msgid "Extended color support requires ncurses version 6.1 or later."

msgstr "پشتیبانی رنگی گسترده به ncurses نسخه 6.1 یا جدیدتر نیاز دارد."

msgid "Return ``True`` if the terminal has insert- and delete-character capabilities. This function is included for historical reasons only, as all modern software terminal emulators have such capabilities."

msgstr "اگر پایانه قابلیت‌های درج و حذف نویسه را داشته باشد، ``True`` را برمی‌گرداند. این تابع فقط به دلایل تاریخی گنجانده شده است، زیرا همه نرم‌افزارهای شبیه‌ساز پایانه امروزی چنین قابلیت‌هایی دارند."

msgid "Return ``True`` if the terminal has insert- and delete-line capabilities, or can simulate them using scrolling regions. This function is included for historical reasons only, as all modern software terminal emulators have such capabilities."

msgstr "اگر پایانه قابلیت‌های درج و حذف خط را داشته باشد، یا بتواند آن‌ها را با استفاده از ناحیه‌های پیمایش شبیه‌سازی کند، ``True`` را برمی‌گرداند. این تابع فقط به دلایل تاریخی گنجانده شده است، زیرا همه‌ی شبیه‌سازهای پایانه‌ای نرم‌افزاری مدرن چنین قابلیت‌هایی دارند."

msgid "Take a key value *ch*, and return ``True`` if the current terminal type recognizes a key with that value."

msgstr "مقدار کلید *ch* را می‌گیرد و اگر نوع پایانه‌ی جاری کلیدی با آن مقدار را بشناسد، ``True`` را برمی‌گرداند."

msgid "Used for half-delay mode, which is similar to cbreak mode in that characters typed by the user are immediately available to the program. However, after blocking for *tenths* tenths of seconds, raise an exception if nothing has been typed. The value of *tenths* must be a number between ``1`` and ``255``. Use :func:`nocbreak` to leave half-delay mode."

msgstr "برای حالت نیمه‌تأخیر (half-delay) استفاده می‌شود؛ این حالت شبیه حالت cbreak است، بدین معنا که نویسه‌های تایپ‌شده توسط کاربر بلافاصله در دسترس برنامه قرار می‌گیرند. با این حال، پس از مسدود شدن به مدت *tenths* دهم ثانیه، اگر چیزی تایپ نشده باشد، یک استثنا پرتاب می‌شود. مقدار *tenths* باید عددی بین ``1`` و ``255`` باشد. برای خروج از حالت نیمه‌تأخیر از :func:`nocbreak` استفاده کنید."

msgid "Change the definition of a color, taking the number of the color to be changed followed by three RGB values (for the amounts of red, green, and blue components). The value of *color_number* must be between ``0`` and ``COLORS - 1``. Each of *r*, *g*, *b*, must be a value between ``0`` and ``1000``. When :func:`init_color` is used, all occurrences of that color on the screen immediately change to the new definition. This function is a no-op on most terminals; it is active only if :func:`can_change_color` returns ``True``."

msgstr "تعریف یک رنگ را تغییر می‌دهد؛ شماره رنگی که باید تغییر کند و سپس سه مقدار RGB (برای میزان کامپوننت‌های قرمز، سبز و آبی) را دریافت می‌کند. مقدار *color_number* باید بین ``0`` و ``COLORS - 1`` باشد. هر یک از *r*، *g* و *b* باید مقداری بین ``0`` و ``1000`` باشد. هنگامی که از :func:`init_color` استفاده شود، تمام موارد آن رنگ روی صفحه بلافاصله به تعریف جدید تغییر می‌کنند. این تابع در بیشتر پایانه‌ها هیچ عملیاتی انجام نمی‌دهد؛ تنها زمانی فعال است که :func:`can_change_color` مقدار ``True`` را برگرداند."

msgid "Change the definition of a color-pair. It takes three arguments: the number of the color-pair to be changed, the foreground color number, and the background color number. The value of *pair_number* must be between ``1`` and ``COLOR_PAIRS - 1`` (the ``0`` color pair can only be changed by :func:`use_default_colors` and :func:`assume_default_colors`). The value of *fg* and *bg* arguments must be between ``0`` and ``COLORS - 1``, or, after calling :func:`!use_default_colors` or :func:`!assume_default_colors`, ``-1``. If the color-pair was previously initialized, the screen is refreshed and all occurrences of that color-pair are changed to the new definition."

msgstr "تعریف یک جفت‌رنگ را تغییر می‌دهد. این تابع سه آرگومان دریافت می‌کند: شماره‌ی جفت‌رنگی که باید تغییر کند، شماره‌ی رنگ پیش‌زمینه و شماره‌ی رنگ پس‌زمینه. مقدار *pair_number* باید بین ``1`` و ``COLOR_PAIRS - 1`` باشد (جفت‌رنگ ``0`` فقط با :func:`use_default_colors` و :func:`assume_default_colors` قابل تغییر است). مقدار آرگومان‌های *fg* و *bg* باید بین ``0`` و ``COLORS - 1`` باشد، یا پس از فراخوانی :func:`!use_default_colors` یا :func:`!assume_default_colors`، ``-1`` باشد. اگر جفت‌رنگ پیش‌تر مقداردهی اولیه شده باشد، صفحه تازه‌سازی می‌شود و تمام موارد استفاده از آن جفت‌رنگ به تعریف جدید تغییر می‌کنند."

msgid "Initialize the library. Return a :ref:`window <curses-window-objects>` object which represents the whole screen."

msgstr "کتابخانه را مقداردهی اولیه می‌کند. یک شیء :ref:`پنجره <curses-window-objects>` را برمی‌گرداند که نمایانگر کل صفحه است."

msgid "See :func:`setupterm` for a caveat about calling it before this function."

msgstr "برای آگاهی از هشداری درباره‌ی فراخوانی آن پیش از این تابع، :func:`setupterm` را ببینید."

msgid "If there is an error opening the terminal, the underlying curses library may cause the interpreter to exit."

msgstr "اگر در باز کردن پایانه خطایی رخ دهد، ممکن است کتابخانه curses زیربنایی باعث خروج مفسر شود."

msgid "If *flag* is ``True``, pressing an interrupt key (interrupt, break, or quit) will flush all output in the terminal driver queue. If *flag* is ``False``, no flushing is done."

msgstr "اگر *flag* برابر ``True`` باشد، فشردن یک کلید وقفه (وقفه، قطع یا خروج) تمام خروجی موجود در صف راه‌انداز پایانه را تخلیه می‌کند. اگر *flag* برابر ``False`` باشد، هیچ تخلیه‌ای انجام نمی‌شود."

msgid "Return ``True`` if :func:`resize_term` would modify the window structure, ``False`` otherwise."

msgstr "اگر :func:`resize_term` ساختار پنجره را تغییر دهد، ``True`` و در غیر این صورت ``False`` را برمی‌گرداند."

msgid "Return ``True`` if :func:`endwin` has been called (that is, the curses library has been deinitialized)."

msgstr "اگر :func:`endwin` فراخوانی شده باشد (یعنی کتابخانه curses از مقداردهی اولیه خارج شده باشد)، ``True`` را برمی‌گرداند."

msgid "Return the name of the key numbered *k* as a bytes object. The name of a key generating printable ASCII character is the key's character. The name of a control-key combination is a two-byte bytes object consisting of a caret (``b'^'``) followed by the corresponding printable ASCII character. The name of an alt-key combination (128--255) is a bytes object consisting of the prefix ``b'M-'`` followed by the name of the corresponding ASCII character."

msgstr "نام کلید با شماره‌ی *k* را به‌عنوان یک شیء bytes برمی‌گرداند. نام کلیدی که یک نویسه‌ی ASCII قابل‌چاپ تولید می‌کند، همان نویسه‌ی کلید است. نام یک ترکیب کلید کنترل، یک شیء bytes دو بایتی است که از یک نویسه‌ی caret (``b'^'``) و به‌دنبال آن نویسه‌ی ASCII قابل‌چاپ متناظر تشکیل شده است. نام یک ترکیب کلید Alt (۱۲۸--۲۵۵) یک شیء bytes است که از پیشوند ``b'M-'`` و به‌دنبال آن نام نویسه‌ی ASCII متناظر تشکیل شده است."

msgid "Raise a :exc:`ValueError` if *k* is negative."

msgstr "اگر *k* منفی باشد، یک :exc:`ValueError` پرتاب می‌کند."

msgid "Return the user's current line kill character as a one-byte bytes object. Under Unix operating systems this is a property of the controlling tty of the curses program, and is not set by the curses library itself."

msgstr "نویسه حذف خط فعلی کاربر را به‌صورت یک شیء bytes یک‌بایتی برمی‌گرداند. در سیستم‌عامل‌های یونیکسی، این یک ویژگی از tty کنترل‌کننده برنامه curses است و توسط خود کتابخانه curses تنظیم نمی‌شود."

msgid "Return a bytes object containing the terminfo long name field describing the current terminal. The maximum length of a verbose description is 128 characters. It is defined only after the call to :func:`initscr`."

msgstr "یک شیء بایتی حاوی فیلد نام بلند terminfo را برمی‌گرداند که پایانه فعلی را توصیف می‌کند. حداکثر طول یک توصیف پرجزئیات ۱۲۸ نویسه است. این فیلد فقط پس از فراخوانی :func:`initscr` تعریف می‌شود."

msgid "If *flag* is ``True``, allow 8-bit characters to be input. If *flag* is ``False``, allow only 7-bit chars."

msgstr "اگر *flag* برابر ``True`` باشد، اجازه داده می‌شود که نویسه‌های ۸ بیتی ورودی داده شوند. اگر *flag* برابر ``False`` باشد، فقط اجازه داده می‌شود که نویسه‌های ۷ بیتی ورودی داده شوند."

msgid "Set the maximum time in milliseconds that can elapse between press and release events in order for them to be recognized as a click, and return the previous interval value. The default value is 166 milliseconds, or one sixth of a second. Use a negative *interval* to obtain the interval value without changing it."

msgstr "حداکثر زمان بر حسب میلی‌ثانیه که می‌تواند بین رویدادهای فشردن و رها کردن سپری شود تا آن‌ها به‌عنوان یک کلیک شناخته شوند را تنظیم می‌کند و مقدار فاصله پیشین را برمی‌گرداند. مقدار پیش‌فرض ۱۶۶ میلی‌ثانیه، یا یک‌ششم ثانیه است. برای دریافت مقدار فاصله بدون تغییر آن، از یک *interval* منفی استفاده کنید."

msgid "Set the mouse events to be reported, and return a tuple ``(availmask, oldmask)``. *availmask* indicates which of the specified mouse events can be reported; on complete failure it returns ``0``. *oldmask* is the previous value of the mouse event mask. If this function is never called, no mouse events are ever reported."

msgstr "رویدادهای ماوس را برای گزارش‌شدن تنظیم می‌کند و یک تاپل ``(availmask, oldmask)`` را برمی‌گرداند. *availmask* نشان می‌دهد کدام‌یک از رویدادهای تعیین‌شده ماوس می‌توانند گزارش شوند؛ در صورت شکست کامل، ``0`` برگردانده می‌شود. *oldmask* مقدار قبلی نقاب رویدادهای ماوس است. اگر این تابع هرگز فراخوانی نشود، هیچ رویداد ماوسی گزارش نخواهد شد."

msgid "Sleep for *ms* milliseconds."

msgstr "به مدت *ms* میلی‌ثانیه متوقف میشود."

msgid "Create and return a pointer to a new pad data structure with the given number of lines and columns. Return a pad as a window object."

msgstr "یک اشاره‌گر به ساختار داده‌ای جدید پد با تعداد سطرهای و ستون‌های داده‌شده ایجاد کرده و برمی‌گرداند. یک پد را به‌عنوان یک شیء پنجره برمی‌گرداند."

msgid "A pad is like a window, except that it is not restricted by the screen size, and is not necessarily associated with a particular part of the screen. Pads can be used when a large window is needed, and only a part of the window will be on the screen at one time. Automatic refreshes of pads (such as from scrolling or echoing of input) do not occur. The :meth:`~window.refresh` and :meth:`~window.noutrefresh` methods of a pad require 6 arguments to specify the part of the pad to be displayed and the location on the screen to be used for the display. The arguments are *pminrow*, *pmincol*, *sminrow*, *smincol*, *smaxrow*, *smaxcol*; the *p* arguments refer to the upper-left corner of the pad region to be displayed and the *s* arguments define a clipping box on the screen within which the pad region is to be displayed."

msgstr "یک پد مانند یک پنجره است، با این تفاوت که به اندازه‌ی صفحه‌نمایش محدود نمی‌شود و لزوماً با بخش خاصی از صفحه‌نمایش مرتبط نیست. هنگامی که به یک پنجره‌ی بزرگ نیاز است و تنها بخشی از پنجره در یک زمان روی صفحه‌نمایش قرار می‌گیرد، می‌توان از پدها استفاده کرد. بازسازی خودکار پدها (مانند ناشی از پیمایش یا بازتاب ورودی) رخ نمی‌دهد. متدهای :meth:`~window.refresh` و :meth:`~window.noutrefresh` یک پد برای مشخص کردن بخشی از پد که باید نمایش داده شود و مکان روی صفحه‌نمایش که برای نمایش استفاده می‌شود، به ۶ آرگومان نیاز دارند. آرگومان‌ها *pminrow*، *pmincol*، *sminrow*، *smincol*، *smaxrow*، *smaxcol* هستند؛ آرگومان‌های *p* به گوشه‌ی بالا-چپ ناحیه‌ی پد که باید نمایش داده شود اشاره دارند و آرگومان‌های *s* یک جعبه‌ی اسلایس (clipping box) روی صفحه‌نمایش تعریف می‌کنند که ناحیه‌ی پد باید درون آن نمایش داده شود."

msgid "Return a new :ref:`window <curses-window-objects>`, whose left-upper corner is at ``(begin_y, begin_x)``, and whose height/width is *nlines*/*ncols*."

msgstr "یک :ref:`پنجره <curses-window-objects>` جدید برمی‌گرداند که گوشه‌ی بالا-چپ آن در ``(begin_y, begin_x)`` قرار دارد و ارتفاع/عرض آن *nlines*/*ncols* است."

msgid "By default, the window will extend from the specified position to the lower right corner of the screen."

msgstr "به‌طور پیش‌فرض، پنجره از موقعیت مشخص‌شده تا گوشه‌ی پایین سمت راست صفحه‌نمایش گسترش خواهد یافت."

msgid "Enter newline mode. This mode translates the return key into newline on input, and translates newline into return and line-feed on output. Newline mode is initially on."

msgstr "ورود به حالت خط جدید. این حالت، کلید بازگشت را در ورودی به خط جدید تبدیل می‌کند و خط جدید را در خروجی به بازگشت و تغذیه‌ی سطر تبدیل می‌کند. حالت خط جدید در ابتدا فعال است."

msgid "If *flag* is ``False``, the effect is the same as calling :func:`nonl`."

msgstr "اگر *flag* برابر ``False`` باشد، اثر آن همان فراخوانی :func:`nonl` است."

msgid "Leave cbreak mode. Return to normal \"cooked\" mode with line buffering."

msgstr "از حالت cbreak خارج شوید. به حالت عادی «cooked» همراه با بافرینگ خطی (line buffering) بازگردید."

msgid "Leave echo mode. Echoing of input characters is turned off."

msgstr "از حالت echo خارج شوید. بازتاب نویسه‌های ورودی خاموش می‌شود."

msgid "Leave newline mode. Disable translation of return into newline on input, and disable low-level translation of newline into newline/return on output (but this does not change the behavior of ``addch('\\n')``, which always does the equivalent of return and line feed on the virtual screen). With translation off, curses can sometimes speed up vertical motion a little; also, it will be able to detect the return key on input."

msgstr "حالت خط جدید را ترک می‌کند. تبدیل بازگشت به خط جدید در ورودی را غیرفعال می‌کند، و تبدیل سطح پایین خط جدید به خط جدید/بازگشت در خروجی را غیرفعال می‌کند (اما این موضوع رفتار ``addch('\\n')`` را تغییر نمی‌دهد، که همواره معادل بازگشت و پیشروی خط را روی صفحه‌ی مجازی انجام می‌دهد). با غیرفعال بودن تبدیل، curses گاهی می‌تواند کمی سرعت حرکت عمودی را افزایش دهد؛ همچنین، قادر خواهد بود کلید بازگشت را در ورودی تشخیص دهد."

msgid "When the :func:`!noqiflush` routine is used, normal flush of input and output queues associated with the ``INTR``, ``QUIT`` and ``SUSP`` characters will not be done. You may want to call :func:`!noqiflush` in a signal handler if you want output to continue as though the interrupt had not occurred, after the handler exits."

msgstr "وقتی از روال :func:`!noqiflush` استفاده می‌شود، تخلیه‌ی عادی صف‌های ورودی و خروجی مرتبط با نویسه‌های ``INTR``، ``QUIT`` و ``SUSP`` انجام نخواهد شد. ممکن است بخواهید :func:`!noqiflush` را در یک هندلر سیگنال فراخوانی کنید، اگر می‌خواهید پس از خروج هندلر، خروجی همان‌طور ادامه یابد که گویی وقفه‌ای رخ نداده است."

msgid "Leave raw mode. Return to normal \"cooked\" mode with line buffering."

msgstr "از حالت raw خارج شوید. به حالت عادی «cooked» با بافرینگ خطی (line buffering) بازگردید."

msgid "Return a tuple ``(fg, bg)`` containing the colors for the requested color pair. The value of *pair_number* must be between ``0`` and ``COLOR_PAIRS - 1``."

msgstr "یک تاپل ``(fg, bg)`` را برمی‌گرداند که شامل رنگ‌های جفت‌رنگ درخواستی است. مقدار *pair_number* باید بین ``0`` و ``COLOR_PAIRS - 1`` باشد."

msgid "Return the number of the color-pair set by the attribute value *attr*. :func:`color_pair` is the counterpart to this function."

msgstr "شماره‌ی جفت‌رنگ تنظیم‌شده با مقدار ویژگی *attr* را برمی‌گرداند. :func:`color_pair` همتای این تابع است."

msgid "Equivalent to ``tputs(str, 1, putchar)``; emit the value of a specified terminfo capability, a bytes object, for the current terminal. Note that the output of :func:`putp` always goes to standard output."

msgstr "معادل با ``tputs(str, 1, putchar)`` است؛ مقدار یک قابلیت terminfo مشخص، که یک شیء بایتی است، را برای ترمینال جاری صادر می‌کند. توجه داشته باشید که خروجی :func:`putp` همیشه به خروجی استاندارد می‌رود."

msgid ":func:`setupterm` (or :func:`initscr`) must be called first."

msgstr "ابتدا باید :func:`setupterm` (یا :func:`initscr`) فراخوانی شود."

msgid "If *flag* is ``False``, the effect is the same as calling :func:`noqiflush`. If *flag* is ``True``, or no argument is provided, the queues will be flushed when these control characters are read."

msgstr "اگر *flag* برابر ``False`` باشد، نتیجه همانند فراخوانی :func:`noqiflush` است. اگر *flag* برابر ``True`` باشد، یا آرگومانی ارائه نشود، صف‌ها هنگام خوانده شدن این نویسه‌های کنترلی تخلیه می‌شوند."

msgid "Enter raw mode. In raw mode, normal line buffering and processing of interrupt, quit, suspend, and flow control keys are turned off; characters are presented to curses input functions one by one."

msgstr "وارد حالت خام می‌شود. در حالت خام، بافر کردن خطی عادی و پردازش کلیدهای وقفه، خروج، تعلیق و کنترل جریان غیرفعال می‌شوند؛ نویسه‌ها یک‌به‌یک به توابع ورودی curses ارائه می‌شوند."

msgid "Restore the terminal to \"program\" mode, as previously saved by :func:`def_prog_mode`."

msgstr "پایانه را به حالت «program» بازمی‌گرداند، همان‌طور که پیش‌تر توسط :func:`def_prog_mode` ذخیره‌شده است."

msgid "Restore the terminal to \"shell\" mode, as previously saved by :func:`def_shell_mode`."

msgstr "پایانه را به حالت «پوسته» بازمی‌گرداند، همان‌طور که پیش‌تر با :func:`def_shell_mode` ذخیره‌شده است."

msgid "Restore the state of the terminal modes to what it was at the last call to :func:`savetty`."

msgstr "وضعیت حالت‌های پایانه را به وضعیتی که در آخرین فراخوانی :func:`savetty` داشت، بازگردانید."

msgid "Backend function used by :func:`resizeterm`, performing most of the work; when resizing the windows, :func:`resize_term` blank-fills the areas that are extended. The calling application should fill in these areas with appropriate data. The :func:`!resize_term` function attempts to resize all windows. However, due to the calling convention of pads, it is not possible to resize these without additional interaction with the application."

msgstr "تابع بک‌اند استفاده‌شده توسط :func:`resizeterm` که بیشتر کار را انجام می‌دهد؛ هنگام تغییر اندازه پنجره‌ها، :func:`resize_term` ناحیه‌هایی را که گسترش می‌یابند با نویسه‌های خالی پر می‌کند. برنامه فراخوان باید این ناحیه‌ها را با داده‌های مناسب پر کند. تابع :func:`!resize_term` تلاش می‌کند اندازه همه پنجره‌ها را تغییر دهد. با این حال، به دلیل قرارداد فراخوانی پدها (pads)، تغییر اندازه آن‌ها بدون تعامل اضافی با برنامه ممکن نیست."

msgid "Resize the standard and current windows to the specified dimensions, and adjusts other bookkeeping data used by the curses library that record the window dimensions (in particular the SIGWINCH handler)."

msgstr "اندازه‌ی پنجره‌های استاندارد و جاری را به ابعاد مشخص‌شده تغییر می‌دهد و سایر داده‌های مدیریتی مورد استفاده‌ی کتابخانه‌ی curses را که ابعاد پنجره را ثبت می‌کنند، تنظیم می‌کند (به‌ویژه هندلری SIGWINCH)."

msgid "Save the current state of the terminal modes in a buffer, usable by :func:`resetty`."

msgstr "وضعیت فعلی حالت‌های پایانه را در یک بافر ذخیره می‌کند که توسط :func:`resetty` قابل استفاده است."

msgid "Retrieves the value set by :func:`set_escdelay`."

msgstr "مقدار تنظیم‌شده توسط :func:`set_escdelay` را بازیابی می‌کند."

msgid "Sets the number of milliseconds to wait after reading an escape character, to distinguish between an individual escape character entered on the keyboard from escape sequences sent by cursor and function keys."

msgstr "تعداد میلی‌ثانیه‌های انتظار پس از خواندن یک نویسه‌ی خنثی‌سازی را تنظیم می‌کند، تا میان یک نویسه‌ی خنثی‌سازی منفرد که از صفحه‌کلید وارد شده است و دنباله‌های خنثی‌سازی ارسال‌شده توسط کلیدهای مکان‌نما و کلیدهای تابعی تمایز قائل شود."

msgid "Retrieves the value set by :func:`set_tabsize`."

msgstr "مقدار تنظیم‌شده توسط :func:`set_tabsize` را بازیابی می‌کند."

msgid "Sets the number of columns used by the curses library when converting a tab character to spaces as it adds the tab to a window."

msgstr "تعداد ستون‌هایی را که کتابخانه curses هنگام تبدیل یک نویسه tab به فاصله‌ها، در زمان افزودن tab به یک پنجره استفاده می‌کند، تنظیم می‌کند."

msgid "Set the virtual screen cursor to *y*, *x*. If *y* and *x* are both ``-1``, then :meth:`leaveok <window.leaveok>` is set ``True``."

msgstr "مکان‌نمای صفحه‌ی مجازی را روی *y*، *x* تنظیم می‌کند. اگر *y* و *x* هر دو ``-1`` باشند، :meth:`leaveok <window.leaveok>` روی ``True`` تنظیم می‌شود."

msgid "Initialize the terminal. *term* is a string giving the terminal name, or ``None``; if omitted or ``None``, the value of the :envvar:`TERM` environment variable will be used. *fd* is the file descriptor to which any initialization sequences will be sent; if not supplied or ``-1``, the file descriptor for ``sys.stdout`` will be used."

msgstr "پایانه را راه‌اندازی می‌کند. *term* رشته‌ای است که نام پایانه را مشخص می‌کند، یا ``None``؛ اگر حذف شود یا ``None`` باشد، از مقدار متغیر محیطی :envvar:`TERM` استفاده خواهد شد. *fd* توصیف‌گر پرونده‌ای است که هر دنباله‌ی راه‌اندازی به آن فرستاده می‌شود؛ اگر ارائه نشود یا ``-1`` باشد، از توصیف‌گر پرونده برای ``sys.stdout`` استفاده خواهد شد."

msgid "Raise a :exc:`curses.error` if the terminal could not be found or its terminfo database entry could not be read. If the terminal has already been initialized, this function has no effect."

msgstr "اگر پایانه پیدا نشود یا ورودی پایگاه داده‌ی terminfo آن خوانده نشود، یک :exc:`curses.error` پرتاب می‌شود. اگر پایانه از قبل راه‌اندازی شده باشد، این تابع هیچ تأثیری ندارد."

msgid "Calling :func:`initscr` after :func:`setupterm` leaks the terminal that :func:`setupterm` allocated: the curses library keeps only a single current terminal and does not free the previously allocated one."

msgstr "فراخوانی :func:`initscr` پس از :func:`setupterm` باعث نشت پایانه‌ای می‌شود که :func:`setupterm` آن را اختصاص داده است: کتابخانه curses تنها یک پایانه جاری را نگه می‌دارد و پایانه‌ای را که پیش‌تر اختصاص داده شده است آزاد نمی‌کند."

msgid "Must be called if the programmer wants to use colors, and before any other color manipulation routine is called. It is good practice to call this routine right after :func:`initscr`."

msgstr "در صورتی که برنامه‌نویس بخواهد از رنگ‌ها استفاده کند، و پیش از فراخوانی هر رویه‌ی دیگری برای دستکاری رنگ‌ها، باید فراخوانی شود. بهتر است این رویه درست پس از :func:`initscr` فراخوانی شود."

msgid ":func:`start_color` initializes eight basic colors (black, red, green, yellow, blue, magenta, cyan, and white), and two global variables in the :mod:`!curses` module, :const:`COLORS` and :const:`COLOR_PAIRS`, containing the maximum number of colors and color-pairs the terminal can support. It also restores the colors on the terminal to the values they had when the terminal was just turned on."

msgstr ":func:`start_color` هشت رنگ پایه (سیاه، قرمز، سبز، زرد، آبی، سرخابی، فیروزه‌ای و سفید) و دو متغیر سراسری در ماژول :mod:`!curses` یعنی :const:`COLORS` و :const:`COLOR_PAIRS` را مقداردهی اولیه می‌کند که حاوی بیشینه تعداد رنگ‌ها و جفت‌رنگ‌هایی هستند که پایانه می‌تواند پشتیبانی کند. همچنین رنگ‌های پایانه را به مقادیری بازمی‌گرداند که پایانه هنگام روشن شدن داشت."

msgid "Return a logical OR of all video attributes supported by the terminal. This information is useful when a curses program needs complete control over the appearance of the screen."

msgstr "یک OR منطقی از تمام ویژگی‌های ویدیویی مورد پشتیبانی پایانه را برمی‌گرداند. این اطلاعات زمانی مفید است که یک برنامه curses به کنترل کامل بر ظاهر صفحه نیاز داشته باشد."

msgid "Return the value of the environment variable :envvar:`TERM`, as a bytes object, truncated to 14 characters."

msgstr "مقدار متغیر محیطی :envvar:`TERM` را به‌عنوان یک شیء بایتی برمی‌گرداند، که به ۱۴ نویسه کوتاه شده است."

msgid "Return the value of the Boolean capability corresponding to the terminfo capability name *capname* as an integer. Return the value ``-1`` if *capname* is not a Boolean capability, or ``0`` if it is canceled or absent from the terminal description."

msgstr "مقدار قابلیت بولی متناظر با نام قابلیت *capname* در terminfo را به‌صورت یک عدد صحیح برمی‌گرداند. اگر *capname* یک قابلیت بولی نباشد، مقدار ``-1`` و اگر لغو شده یا در توضیح پایانه وجود نداشته باشد، مقدار ``0`` را برمی‌گرداند."

msgid "Return the value of the numeric capability corresponding to the terminfo capability name *capname* as an integer. Return the value ``-2`` if *capname* is not a numeric capability, or ``-1`` if it is canceled or absent from the terminal description."

msgstr "مقدار قابلیت عددی متناظر با نام قابلیت terminfo به نام *capname* را به‌صورت عدد صحیح برمی‌گرداند. اگر *capname* یک قابلیت عددی نباشد، مقدار ``-2`` و اگر لغوشده یا در توصیف پایانه موجود نباشد، مقدار ``-1`` را برمی‌گرداند."

msgid "Return the value of the string capability corresponding to the terminfo capability name *capname* as a bytes object. Return ``None`` if *capname* is not a terminfo \"string capability\", or is canceled or absent from the terminal description."

msgstr "مقدار قابلیت رشته‌ای متناظر با نام قابلیت *capname* در terminfo را به‌عنوان یک شیء bytes برمی‌گرداند. اگر *capname* یک «قابلیت رشته‌ای» terminfo نباشد، یا لغو شده باشد یا در توصیف پایانه وجود نداشته باشد، ``None`` را برمی‌گرداند."

msgid "Instantiate the bytes object *str* with the supplied parameters, where *str* should be a parameterized byte string obtained from the terminfo database. For example, ``tparm(tigetstr(\"cup\"), 5, 3)`` could result in ``b'\\033[6;4H'``, the exact result depending on terminal type. Up to nine integer parameters may be supplied."

msgstr "شیء بایتی *str* را با پارامترهای داده شده نمونه‌سازی کنید، جایی که *str* باید یک رشته‌ی بایتی پارامتره‌یافته شده از پایگاه داده‌ی terminfo باشد. برای مثال، ``tparm(tigetstr(\"cup\"), 5, 3)`` می‌تواند منجر به ``b'\\033[6;4H'`` شود، نتیجه‌ی دقیق بستگی به نوع ترمینال دارد. حداکثر نه پارامتر عدد صحیح می‌تواند داده شود."

msgid "Specify that the file descriptor *fd* be used for typeahead checking. If *fd* is ``-1``, then no typeahead checking is done."

msgstr "مشخص می‌کند که توصیف‌گر پرونده *fd* برای بررسی پیش‌تایپ (typeahead) به کار رود. اگر *fd* ``-1`` باشد، هیچ‌گونه بررسی پیش‌تایپ (typeahead) انجام نمی‌شود."

msgid "The curses library does \"line-breakout optimization\" by looking for typeahead periodically while updating the screen. If input is found, and it is coming from a tty, the current update is postponed until refresh or doupdate is called again, allowing faster response to commands typed in advance. This function allows specifying a different file descriptor for typeahead checking."

msgstr "کتابخانه curses با بررسی دوره‌ای ورودی از پیش‌تایپ‌شده (typeahead) در حین به‌روزرسانی صفحه، «بهینه‌سازی شکست خط» (line-breakout optimization) را انجام می‌دهد. اگر ورودی یافت شود و از یک tty بیاید، به‌روزرسانی فعلی تا زمانی که refresh یا doupdate دوباره فراخوانی شود، به تعویق می‌افتد تا پاسخ سریع‌تری به فرمان‌هایی که از پیش‌تایپ‌شده‌اند داده شود. این تابع امکان تعیین یک توصیف‌گر پرونده متفاوت برای بررسی typeahead را فراهم می‌کند."

msgid "Return a bytes object which is a printable representation of the character *ch*; any attributes and color pair are ignored. Control characters are represented as a caret followed by the character, for example as ``b'^C'``. Printing characters are left as they are."

msgstr "یک شیء بایتی بازمی‌گرداند که نمایانگر قابل چاپ نویسه *ch* است؛ هرگونه ویژگی و جفت رنگ نادیده گرفته می‌شوند. نویسه‌های کنترلی به صورت یک نشانک به دنبال خود نویسه نمایش داده می‌شوند، برای مثال به صورت ``b'^C'``. نویسه‌های قابل چاپ همان‌طور که هستند باقی می‌مانند."

msgid "Push *ch* so the next :meth:`~window.getch` will return it."

msgstr "*ch* را فشار دهید تا :meth:`~window.getch` بعدی آن را برگرداند."

msgid "*ch* may be an integer (a key code or the code of an encoded byte), a byte, or a string of length 1 which encodes to a single byte."

msgstr "*ch* می‌تواند یک عدد صحیح (یک کد کلید یا کد یک بایت کدگذاری شده)، یک بایت، یا یک رشته با طول 1 باشد که به یک بایت واحد کدگذاری می‌شود."

msgid "Only one *ch* can be pushed before :meth:`!getch` is called."

msgstr "تنها یک *ch* را می‌توان پیش از فراخوانی :meth:`!getch` پوش کرد (push)."

msgid "Update the :const:`LINES` and :const:`COLS` module variables. Useful for detecting manual screen resize."

msgstr "متغیرهای ماژول :const:`LINES` و :const:`COLS` را به‌روزرسانی کنید. برای تشخیص تغییر دستی اندازه‌ی صفحه مفید است."

msgid "Push *ch* so the next :meth:`~window.get_wch` will return it."

msgstr "*ch* را فشار دهید تا :meth:`~window.get_wch` بعدی آن را برگرداند."

msgid "*ch* may be an integer (a character code, not a key code) or a string of length 1."

msgstr "*ch* می‌تواند یک عدد صحیح (یک کد نویسه، نه کد کلید) یا یک رشته با طول 1 باشد."

msgid "Only one *ch* can be pushed before :meth:`!get_wch` is called."

msgstr "تنها یک *ch* را می‌توان پیش از فراخوانی :meth:`!get_wch` فشار داد."

msgid "Push a :const:`KEY_MOUSE` event onto the input queue, associating the given state data with it."

msgstr "یک رویداد :const:`KEY_MOUSE` را به صف ورودی اضافه کنید و داده‌های وضعیت داده‌شده را با آن مرتبط کنید."

msgid "If used, this function should be called before :func:`initscr` or newterm are called. When *flag* is ``False``, the values of lines and columns specified in the terminfo database will be used, even if environment variables :envvar:`LINES` and :envvar:`COLUMNS` (used by default) are set, or if curses is running in a window (in which case default behavior would be to use the window size if :envvar:`LINES` and :envvar:`COLUMNS` are not set)."

msgstr "در صورت استفاده، این تابع باید پیش از فراخوانی :func:`initscr` یا newterm فراخوانی شود. هنگامی که *flag* برابر ``False`` باشد، مقادیر سطرهای و ستون‌های تعیین‌شده در پایگاه داده‌ی terminfo استفاده خواهند شد، حتی اگر متغیرهای محیطی :envvar:`LINES` و :envvar:`COLUMNS` (که به‌طور پیش‌فرض استفاده می‌شوند) تنظیم‌شده باشند، یا اگر curses در یک پنجره در حال اجرا باشد (که در این حالت، رفتار پیش‌فرض استفاده از اندازه‌ی پنجره خواهد بود اگر :envvar:`LINES` و :envvar:`COLUMNS` تنظیم‌نشده باشند)."

msgid "Equivalent to ``assume_default_colors(-1, -1)``."

msgstr "معادل ``assume_default_colors(-1, -1)``."

msgid "Initialize curses and call another callable object, *func*, which should be the rest of your curses-using application. If the application raises an exception, this function will restore the terminal to a sane state before re-raising the exception and generating a traceback. The callable object *func* is then passed the main window 'stdscr' as its first argument, followed by any other arguments passed to :func:`!wrapper`. Before calling *func*, :func:`!wrapper` turns on cbreak mode, turns off echo, enables the terminal keypad, and initializes colors if the terminal has color support. On exit (whether normally or by exception) it restores cooked mode, turns on echo, and disables the terminal keypad."

msgstr "curses را مقداردهی اولیه می‌کند و شیء فراخوانی‌پذیر دیگری به نام *func* را فراخوانی می‌کند که باید بخش باقی‌مانده‌ی برنامه‌ی استفاده‌کننده از curses شما باشد. اگر برنامه استثنایی را پرتاب کند، این تابع پیش از پرتاب دوباره‌ی استثنا و ایجاد ردگیری پشته، پایانه را به وضعیت سالم بازمی‌گرداند. سپس شیء فراخوانی‌پذیر *func*، پنجره‌ی اصلی 'stdscr' را به‌عنوان نخستین آرگومان خود و پس از آن، هر آرگومان دیگری را که به :func:`!wrapper` داده شده باشد دریافت می‌کند. پیش از فراخوانی *func*، :func:`!wrapper` حالت cbreak را روشن می‌کند، بازتاب را خاموش می‌کند، صفحه‌کلید پایانه را فعال می‌کند و اگر پایانه پشتیبانی از رنگ داشته باشد، رنگ‌ها را مقداردهی اولیه می‌کند. هنگام خروج (چه به‌صورت عادی و چه در اثر استثنا) حالت cooked را بازمی‌گرداند، بازتاب را روشن می‌کند و صفحه‌کلید پایانه را غیرفعال می‌کند."

msgid "Window objects"

msgstr "اشیای پنجره"

msgid "Window objects, as returned by :func:`initscr` and :func:`newwin` above, have the following methods and attributes:"

msgstr "اشیای پنجره، که توسط :func:`initscr` و :func:`newwin` در بالا بازگردانده می‌شوند، دارای متدها و ویژگی‌های زیر هستند:"

msgid "Paint character *ch* at ``(y, x)`` with attributes *attr*, overwriting any character previously painted at that location. By default, the character position and attributes are the current settings for the window object."

msgstr "نویسه‌ی *ch* را در ``(y, x)`` با ویژگی‌های *attr* ترسیم می‌کند و هر نویسه‌ای را که پیش‌تر در آن مکان ترسیم شده باشد، بازنویسی می‌کند. به‌طور پیش‌فرض، موقعیت نویسه و ویژگی‌ها، تنظیمات جاری شیء پنجره هستند."

msgid "Writing outside the window, subwindow, or pad raises a :exc:`curses.error`. Attempting to write to the lower-right corner of a window, subwindow, or pad will cause an exception to be raised after the character is printed."

msgstr "نوشتن خارج از پنجره، زیرپنجره یا پد، باعث پرتاب یک :exc:`curses.error` می‌شود. تلاش برای نوشتن در گوشه‌ی پایین سمت راست یک پنجره، زیرپنجره یا پد، باعث می‌شود پس از چاپ نویسه، یک استثنا پرتاب شود."

msgid "Paint at most *n* characters of the character string *str* at ``(y, x)`` with attributes *attr*, overwriting anything previously on the display."

msgstr "حداکثر *n* نویسه از رشته‌ی نویسه‌ای *str* را در ``(y, x)`` با ویژگی‌های *attr* رسم کنید و هر آنچه را که پیش‌تر روی نمایشگر بوده است بازنویسی کنید."

msgid "Paint the character string *str* at ``(y, x)`` with attributes *attr*, overwriting anything previously on the display."

msgstr "رشته‌ی نویسه‌ای *str* را در ``(y, x)`` با ویژگی‌های *attr* ترسیم می‌کند و هر چیزی را که پیش‌تر روی نمایشگر بوده، بازنویسی می‌کند."

msgid "Writing outside the window, subwindow, or pad raises :exc:`curses.error`. Attempting to write to the lower-right corner of a window, subwindow, or pad will cause an exception to be raised after the string is printed."

msgstr "نوشتن بیرون از پنجره، زیرپنجره یا پد موجب پرتاب :exc:`curses.error` می‌شود. تلاش برای نوشتن در گوشه‌ی پایین سمت راست یک پنجره، زیرپنجره یا پد منجر به پرتاب یک استثنا پس از چاپ رشته می‌شود."

msgid "A bug in ncurses, the backend for this Python module, could cause segfaults when resizing windows. This was fixed in ncurses-6.1-20190511. If you are stuck with an earlier ncurses, you can avoid triggering it by not calling :meth:`!addstr` with a *str* that has embedded newlines; instead, call :meth:`!addstr` separately for each line."

msgstr "یک اشکال در ncurses، بک‌اند این ماژول پایتون، می‌توانست هنگام تغییر اندازه‌ی پنجره‌ها باعث ایجاد خطاهای قطعه‌بندی حافظه (segfaults) شود. این اشکال در ncurses-6.1-20190511 برطرف شد. اگر مجبور به استفاده از نسخه‌ی قدیمی‌تر ncurses هستید، می‌توانید با خودداری از فراخوانی :meth:`!addstr` با یک *str* که حاوی نویسه‌های خط جدید داخلی است، از بروز آن جلوگیری کنید؛ در عوض، :meth:`!addstr` را برای هر خط به‌صورت جداگانه فراخوانی کنید."

msgid "Remove attribute *attr* from the \"background\" set applied to all writes to the current window."

msgstr "ویژگی *attr* را از مجموعه «background» اعمال‌شده بر همه نوشتن‌ها در پنجره جاری حذف کنید."

msgid "Add attribute *attr* to the \"background\" set applied to all writes to the current window."

msgstr "ویژگی *attr* را به مجموعه‌ی «background» اضافه کنید که بر تمام نوشتن‌ها در پنجره‌ی جاری اعمال می‌شود."

msgid "Set the \"background\" set of attributes to *attr*. This set is initially ``0`` (no attributes)."

msgstr "مجموعه‌ی ویژگی‌های «پس‌زمینه» را روی *attr* تنظیم کنید. این مجموعه در ابتدا ``0`` است (بدون ویژگی)."

msgid "Set the background property of the window to the character *ch*, with attributes *attr*. The change is then applied to every character position in that window:"

msgstr "ویژگی پس‌زمینه‌ی پنجره را روی نویسه‌ی *ch*، با صفت‌های *attr* تنظیم کنید. سپس این تغییر روی همه‌ی موقعیت‌های نویسه در آن پنجره اعمال می‌شود:"

msgid "The attribute of every character in the window is changed to the new background attribute."

msgstr "ویژگی هر نویسه در پنجره به ویژگی پس‌زمینه جدید تغییر می‌کند."

msgid "Wherever the former background character appears, it is changed to the new background character."

msgstr "هر جا نویسه‌ی پس‌زمینه‌ی پیشین ظاهر شود، به نویسه‌ی پس‌زمینه‌ی جدید تغییر می‌یابد."

msgid "Set the window's background. A window's background consists of a character and any combination of attributes. The attribute part of the background is combined (OR'ed) with all non-blank characters that are written into the window. Both the character and attribute parts of the background are combined with the blank characters. The background becomes a property of the character and moves with the character through any scrolling and insert/delete line/character operations."

msgstr "پس‌زمینه پنجره را تنظیم کنید. پس‌زمینه یک پنجره از یک نویسه و هر ترکیبی از ویژگی‌ها تشکیل شده است. بخش ویژگی پس‌زمینه با تمام نویسه‌های غیرخالی که در پنجره نوشته می‌شوند، ترکیب (OR) می‌شود. هر دو بخش نویسه و ویژگی پس‌زمینه با نویسه‌های خالی ترکیب می‌شوند. پس‌زمینه به یک خصوصیت نویسه تبدیل می‌شود و همراه با نویسه در هر عملیات پیمایش و درج/حذف خط/نویسه جابه‌جا می‌شود."

msgid "Draw a border around the edges of the window. Each parameter specifies the character to use for a specific part of the border; see the table below for more details."

msgstr "یک فریم دور لبه‌های پنجره ترسیم می‌کند. هر پارامتر، نویسه‌ی مورد استفاده برای بخش مشخصی از فریم را تعیین می‌کند؛ برای جزئیات بیشتر، جدول زیر را ببینید."

msgid "A ``0`` value for any parameter will cause the default character to be used for that parameter. Keyword parameters can *not* be used. The defaults are listed in this table:"

msgstr "مقدار ``0`` برای هر پارامتر باعث می‌شود که نویسه‌ی پیش‌فرض برای آن پارامتر استفاده شود. از آرگومان‌های کلیدواژه‌ای *نمی‌توان* استفاده کرد. مقادیر پیش‌فرض در این جدول فهرست شده‌اند:"

msgid "Parameter"

msgstr "پارامتر"

msgid "Description"

msgstr "توضیحات"

msgid "Default value"

msgstr "مقدار پیش‌فرض"

msgid "*ls*"

msgstr "*ls*"

msgid "Left side"

msgstr "سمت چپ"

msgid ":const:`ACS_VLINE`"

msgstr ":const:`ACS_VLINE`"

msgid "*rs*"

msgstr "*rs*"

msgid "Right side"

msgstr "سمت راست"

msgid "*ts*"

msgstr "*ts*"

msgid "Top"

msgstr "بالا"

msgid ":const:`ACS_HLINE`"

msgstr ":const:`ACS_HLINE`"

msgid "*bs*"

msgstr "*bs*"

msgid "Bottom"

msgstr "پایین"

msgid "*tl*"

msgstr "*tl*"

msgid "Upper-left corner"

msgstr "گوشه‌ی بالا-چپ"

msgid ":const:`ACS_ULCORNER`"

msgstr ":const:`ACS_ULCORNER`"

msgid "*tr*"

msgstr "*tr*"

msgid "Upper-right corner"

msgstr "گوشه‌ی بالا-راست"

msgid ":const:`ACS_URCORNER`"

msgstr ":const:`ACS_URCORNER`"

msgid "*bl*"

msgstr "*bl*"

msgid "Bottom-left corner"

msgstr "گوشه پایین چپ"

msgid ":const:`ACS_LLCORNER`"

msgstr ":const:`ACS_LLCORNER`"

msgid "*br*"

msgstr "*br*"

msgid "Bottom-right corner"

msgstr "گوشه پایین-راست"

msgid ":const:`ACS_LRCORNER`"

msgstr ":const:`ACS_LRCORNER`"

msgid "Similar to :meth:`border`, but both *ls* and *rs* are *vertch* and both *ts* and *bs* are *horch*. The default corner characters are always used by this function."

msgstr "مشابه :meth:`border`، اما هر دو *ls* و *rs* برابر با *vertch* و هر دو *ts* و *bs* برابر با *horch* هستند. این تابع همیشه از نویسه‌های گوشه پیش‌فرض استفاده می‌کند."

msgid "Set the attributes of *num* characters at the current cursor position, or at position ``(y, x)`` if supplied. If *num* is not given or is ``-1``, the attribute will be set on all the characters to the end of the line. This function moves cursor to position ``(y, x)`` if supplied. The changed line will be touched using the :meth:`touchline` method so that the contents will be redisplayed by the next window refresh."

msgstr "ویژگی‌های *num* نویسه را در موقعیت فعلی مکان‌نما، یا در موقعیت ``(y, x)`` در صورت ارائه شدن، تنظیم می‌کند. اگر *num* داده نشده باشد یا ``-1`` باشد، ویژگی برای تمام نویسه‌ها تا پایان خط تنظیم خواهد شد. این تابع مکان‌نما را در صورت ارائه شدن به موقعیت ``(y, x)`` منتقل می‌کند. خط تغییرکرده با استفاده از متد :meth:`touchline` علامت‌گذاری می‌شود تا محتویات در بازخوانی بعدی پنجره دوباره نمایش داده شوند."

msgid "Like :meth:`erase`, but also cause the whole window to be repainted upon next call to :meth:`refresh`."

msgstr "مانند :meth:`erase`، اما باعث می‌شود در فراخوانی بعدی :meth:`refresh`، کل پنجره دوباره ترسیم شود."

msgid "If *flag* is ``True``, the next call to :meth:`refresh` will clear the window completely."

msgstr "اگر *flag* برابر ``True`` باشد، فراخوانی بعدی :meth:`refresh` پنجره را به‌طور کامل پاک می‌کند."

msgid "Erase from cursor to the end of the window: all lines below the cursor are deleted, and then the equivalent of :meth:`clrtoeol` is performed."

msgstr "پاک کردن از مکان‌نما تا انتهای پنجره: همه سطرهای زیر مکان‌نما حذف می‌شوند، سپس معادل :meth:`clrtoeol` اجرا می‌شود."

msgid "Erase from cursor to the end of the line."

msgstr "از مکان‌نما تا انتهای خط را پاک می‌کند."

msgid "Update the current cursor position of all the ancestors of the window to reflect the current cursor position of the window."

msgstr "موقعیت فعلی مکان‌نمای همه‌ی نیاکان پنجره را به‌روزرسانی کنید تا موقعیت فعلی مکان‌نمای پنجره منعکس شود."

msgid "Delete the character under the cursor, or at ``(y, x)`` if specified. All characters to the right on the same line are shifted one position left."

msgstr "نویسه‌ی زیر مکان‌نما، یا در ``(y, x)`` در صورت مشخص شدن، حذف می‌کند. همه‌ی نویسه‌های سمت راست در همان خط یک موقعیت به چپ جابه‌جا می‌شوند."

msgid "Delete the line under the cursor. All following lines are moved up by one line."

msgstr "خط زیر مکان‌نما حذف می‌شود. همه‌ی سطرهای بعدی یک خط به بالا جابه‌جا می‌شوند."

msgid "An abbreviation for \"derive window\", :meth:`derwin` is the same as calling :meth:`subwin`, except that *begin_y* and *begin_x* are relative to the origin of the window, rather than relative to the entire screen. Return a window object for the derived window."

msgstr ":meth:`derwin` که مخفف «derive window» است، همانند فراخوانی :meth:`subwin` است، با این تفاوت که *begin_y* و *begin_x* نسبت به مبدأ پنجره هستند، نه نسبت به کل صفحه‌نمایش. یک شیء پنجره برای پنجره مشتق‌شده برمی‌گرداند."

msgid "Add character *ch* with attribute *attr*, and immediately call :meth:`refresh` on the window."

msgstr "نویسه‌ی *ch* را با ویژگی *attr* اضافه کنید و بلافاصله :meth:`refresh` را روی پنجره فراخوانی کنید."

msgid "Test whether the given pair of screen-relative character-cell coordinates are enclosed by the given window, returning ``True`` or ``False``. It is useful for determining what subset of the screen windows enclose the location of a mouse event."

msgstr "آزمایش می‌کند که آیا جفت داده‌شده از مختصات سلول‌نویسه‌ای نسبت به صفحه، درون پنجره‌ی داده‌شده قرار دارد یا خیر، و ``True`` یا ``False`` برمی‌گرداند. این برای تعیین اینکه چه زیرمجموعه‌ای از پنجره‌های صفحه محل یک رویداد ماوس را دربر می‌گیرد، مفید است."

msgid "Previously it returned ``1`` or ``0`` instead of ``True`` or ``False``."

msgstr "پیش‌تر، به‌جای ``True`` یا ``False``، ``1`` یا ``0`` را برمی‌گرداند."

msgid "Encoding used to encode the string arguments of the methods and to decode their results on a build without wide-character support. The encoding attribute is inherited from the parent window when a subwindow is created, for example with :meth:`window.subwin`. By default, current locale encoding is used (see :func:`locale.getencoding`)."

msgstr "کدگذاری مورد استفاده برای کدگذاری آرگومان‌های رشته‌ای متدها و کدگشایی نتایج آن‌ها در ساخت بدون پشتیبانی از نویسه‌های پهن. ویژگی کدگذاری از پنجره والد هنگام ایجاد یک زیرپنجره ارث می‌شود، برای مثال با :meth:`window.subwin`. به طور پیش‌فرض، کدگذاری locale جاری استفاده می‌شود (به :func:`locale.getencoding` مراجعه کنید)."

msgid "Clear the window."

msgstr "پنجره را پاک کنید."

msgid "Return a tuple ``(y, x)`` of coordinates of upper-left corner."

msgstr "یک تاپل ``(y, x)`` از مختصات گوشه‌ی بالا سمت چپ برمی‌گرداند."

msgid "Return the given window's current background character/attribute pair. Its components can be extracted like those of :meth:`inch`."

msgstr "جفت نویسه/ویژگی پس‌زمینه‌ی جاری پنجره‌ی داده‌شده را برمی‌گرداند. اجزای آن را می‌توان مانند اجزای :meth:`inch` استخراج کرد."

msgid "Read a key press, after moving the cursor to *y*, *x* if specified, and return it as an integer. The window is refreshed first if it is not a pad and was modified since the last refresh. Wait until a key is pressed, or return ``-1`` if the read is non-blocking or times out (see :meth:`nodelay` and :meth:`timeout`)."

msgstr "یک فشردنِ کلید را بخوانید، پس از انتقال نشانگر به *y*، *x* در صورت تعیین، و آن را به عنوان یک عدد صحیح برگردانید. پنجره ابتدا تازه‌سازی می‌شود اگر پد نباشد و از آخرین تازه‌سازی تغییر کرده باشد. تا فشردن یک کلید صبر کنید، یا ``-1`` برگردانید اگر خواندن غیرمسدودکننده باشد یا زمان‌به‌حد برسد (به :meth:`nodelay` و :meth:`timeout` مراجعه کنید)."

msgid "An ordinary key is returned as the code of a single byte of its encoding in the current locale, so a character encoded with several bytes takes several calls. For example, in a UTF-8 locale ``'é'`` is read as ``195``, then ``169``. Use :meth:`get_wch` to read it as a single character."

msgstr "یک کلید معمولی به عنوان کد یک بایتِ تکی از کدگذاریِ آن در locale جاری برگردانده می‌شود، بنابراین یک نویسه که با چند بایت کدگذاری شده است، چند فراخوانی می‌طلبد. برای مثال، در یک locale از نوع UTF-8، ``'é'`` به عنوان ``195`` خوانده می‌شود، سپس ``169``. برای خواندن آن به عنوان یک نویسه تکی از :meth:`get_wch` استفاده کنید."

msgid "In keypad mode (see :meth:`keypad`) function keys and other special keys are returned as one of the :ref:`KEY_* constants <curses-key-constants>`, which cannot be mistaken for an ordinary key. Otherwise, or if their escape sequence does not arrive in time (see :meth:`notimeout` and :func:`set_escdelay`), their bytes are returned one at a time."

msgstr "در حالت کی‌پد (به :meth:`keypad` مراجعه کنید) کلیدهای تابع و سایر کلیدهای ویژه به عنوان یکی از :ref:`ثابت‌های KEY_* <curses-key-constants>` برگردانده می‌شوند، که نمی‌توان آن‌ها را با یک کلید معمولی اشتباه گرفت. در غیر این صورت، یا اگر دنباله‌ی گریز آن‌ها به موقع نرسد (به :meth:`notimeout` و :func:`set_escdelay` مراجعه کنید)، بایت‌های آن‌ها یکی‌یکی برگردانده می‌شوند."

msgid "In echo mode (see :func:`echo`) the key is added to the window as by :meth:`addch`; special keys are not echoed."

msgstr "در حالت اکو (به :func:`echo` مراجعه کنید) کلید همانند :meth:`addch` به پنجره اضافه می‌شود؛ کلیدهای ویژه اکو نمی‌شوند."

msgid "Read a key press, after moving the cursor to *y*, *x* if specified, and return it as a one-character :class:`str`. The window is refreshed first if it is not a pad and was modified since the last refresh. Wait until a key is pressed, or raise :exc:`error` if the read is non-blocking or times out (see :meth:`nodelay` and :meth:`timeout`)."

msgstr "یک فشردنِ کلید را بخوانید، پس از انتقال نشانگر به *y*، *x* در صورت تعیین، و آن را به عنوان یک :class:`str` تک‌نویسه برگردانید. پنجره ابتدا تازه‌سازی می‌شود اگر پد نباشد و از آخرین تازه‌سازی تغییر کرده باشد. تا فشردن یک کلید صبر کنید، یا :exc:`error` را پرتاب کنید اگر خواندن غیرمسدودکننده باشد یا زمان‌به‌حد برسد (به :meth:`nodelay` و :meth:`timeout` مراجعه کنید)."

msgid "In keypad mode (see :meth:`keypad`) function keys and other special keys are returned as one of the :ref:`KEY_* constants <curses-key-constants>`, an integer. Otherwise, or if their escape sequence does not arrive in time (see :meth:`notimeout` and :func:`set_escdelay`), their characters are returned one at a time."

msgstr "در حالت کی‌پد (به :meth:`keypad` مراجعه کنید) کلیدهای تابع و سایر کلیدهای ویژه به عنوان یکی از :ref:`ثابت‌های KEY_* <curses-key-constants>` برگردانده می‌شوند، یک عدد صحیح. در غیر این صورت، یا اگر دنباله‌ی گریز آن‌ها به موقع نرسد (به :meth:`notimeout` و :func:`set_escdelay` مراجعه کنید)، نویسه‌های آن‌ها یکی‌یکی برگردانده می‌شوند."

msgid "Read a key press as :meth:`getch` does, but return it as a :class:`str`: an ordinary key as a one-character string, the byte decoded as Latin-1, and a special key as its name, such as ``'KEY_UP'`` (see :func:`keyname`). Raise :exc:`error` instead of returning ``-1`` if there is no input."

msgstr "یک فشردنِ کلید را همانند :meth:`getch` بخوانید، اما آن را به عنوان یک :class:`str` برگردانید: یک کلید معمولی به عنوان یک رشته‌ی تک‌نویسه، بایت رمزگشایی‌شده به عنوان Latin-1، و یک کلید ویژه به عنوان نام آن، مانند ``'KEY_UP'`` (به :func:`keyname` مراجعه کنید). اگر ورودی وجود نداشته باشد، به جای برگرداندن ``-1``، :exc:`error` را پرتاب کنید."

msgid "Return a tuple ``(y, x)`` of the height and width of the window."

msgstr "یک تاپل ``(y, x)`` شامل ارتفاع و عرض پنجره برمی‌گرداند."

msgid "Return the beginning coordinates of this window relative to its parent window as a tuple ``(y, x)``. Return ``(-1, -1)`` if this window has no parent."

msgstr "مختصات آغازین این پنجره را نسبت به پنجره والد آن به‌صورت یک تاپل ``(y, x)`` برمی‌گرداند. اگر این پنجره والدی نداشته باشد، ``(-1, -1)`` را برمی‌گرداند."

msgid "Read a line of input from the user, with primitive line editing capacity, after moving the cursor to *y*, *x* if specified. Return it as a bytes object, in the encoding of the current locale and without the terminating newline. At most *n* bytes are read; *n* defaults to and cannot exceed 2047."

msgstr "یک سطر ورودی را از کاربر بخوانید، با قابلیتِ ابتداییِ ویرایش سطر، پس از انتقال نشانگر به *y*، *x* در صورت تعیین. آن را به عنوان یک شیء بایت‌ها برگردانید، در کدگذاریِ locale جاری و بدون کاراکترِ خط‌جداکننده‌ی پایانی. حداکثر *n* بایت خوانده می‌شود؛ *n* به پیش‌فرض ۲۰۴۷ است و نمی‌تواند از آن بیشتر باشد."

msgid "The maximum value for *n* was increased from 1023 to 2047."

msgstr "حداکثر مقدار برای *n* از ۱۰۲۳ به ۲۰۴۷ افزایش یافت."

msgid "Return a tuple ``(y, x)`` of current cursor position relative to the window's upper-left corner."

msgstr "یک تاپل ``(y, x)`` از موقعیت فعلی مکان‌نما نسبت به گوشه‌ی بالا-چپ پنجره برمی‌گرداند."

msgid "Display a horizontal line starting at ``(y, x)`` with length *n* consisting of the character *ch* with attributes *attr*. The line stops at the right edge of the window if fewer than *n* cells are available."

msgstr "یک خط افقی را نمایش می‌دهد که از ``(y, x)`` آغاز می‌شود، به طول *n* است و از نویسه *ch* با ویژگی‌های *attr* تشکیل شده است. اگر کمتر از *n* خانه در دسترس باشد، خط در لبه‌ی راست پنجره متوقف می‌شود."

msgid "If *flag* is ``False``, curses no longer considers using the hardware insert/delete character feature of the terminal; if *flag* is ``True``, use of character insertion and deletion is enabled. When curses is first initialized, use of character insert/delete is enabled by default."

msgstr "اگر *flag* برابر ``False`` باشد، curses دیگر استفاده از قابلیت سخت‌افزاری درج/حذف نویسه پایانه را در نظر نمی‌گیرد؛ اگر *flag* برابر ``True`` باشد، استفاده از درج و حذف نویسه فعال می‌شود. هنگامی که curses برای نخستین بار مقداردهی اولیه می‌شود، استفاده از درج/حذف نویسه به‌طور پیش‌فرض فعال است."

msgid "If *flag* is ``True``, :mod:`!curses` will try to use hardware line editing facilities. Otherwise, curses will not use them."

msgstr "اگر *flag* برابر ``True`` باشد، :mod:`!curses` تلاش می‌کند از امکانات سخت‌افزاری ویرایش خط استفاده کند. در غیر این صورت، curses از آن‌ها استفاده نخواهد کرد."

msgid "If *flag* is ``True``, any change in the window image automatically causes the window to be refreshed; you no longer have to call :meth:`refresh` yourself. However, it may degrade performance considerably, due to repeated calls to wrefresh. This option is disabled by default."

msgstr "اگر *flag* برابر ``True`` باشد، هر تغییری در تصویر پنجره به‌طور خودکار باعث تازه‌سازی پنجره می‌شود؛ دیگر نیازی نیست خودتان :meth:`refresh` را فراخوانی کنید. با این حال، ممکن است به دلیل فراخوانی‌های مکرر wrefresh، کارایی را به‌طور قابل‌توجهی کاهش دهد. این گزینه به‌طور پیش‌فرض غیرفعال است."

msgid "Return the character at the given position in the window. The bottom 8 bits are the character proper and the upper bits are the attributes; extract them with the :data:`A_CHARTEXT` and :data:`A_ATTRIBUTES` bit-masks, and the color pair with :func:`pair_number`. The character byte is the locale-encoded byte of the cell's character, consistent with :meth:`instr`. On a wide-character build, a character that does not fit in a single byte in the current locale has a character byte of ``0``; use :meth:`instr` to read such characters."

msgstr "نویسه را در موقعیت داده‌شده در پنجره برمی‌گرداند. ۸ بیت پایینی، خود نویسه است و بیت‌های بالایی، ویژگی‌ها هستند؛ آن‌ها را با نقاب‌های بیتی :data:`A_CHARTEXT` و :data:`A_ATTRIBUTES`، و جفت رنگ را با :func:`pair_number` استخراج کنید. بایت نویسه، بایت کدگذاری‌شده بر اساس تنظیمات locale برای نویسه‌ی سلول است و با :meth:`instr` سازگار است. در یک ساخت با نویسه‌های پهن (wide-character build)، نویسه‌ای که در تنظیمات locale فعلی در یک بایت جا نمی‌شود، بایت نویسه‌ی آن ``0`` است؛ برای خواندن چنین نویسه‌هایی از :meth:`instr` استفاده کنید."

msgid "Insert character *ch* with attributes *attr* before the character under the cursor, or at ``(y, x)`` if specified. All characters to the right of the cursor are shifted one position right, with the rightmost character on the line being lost. The cursor position does not change."

msgstr "نویسه *ch* را با ویژگی‌های *attr* پیش از نویسه زیر مکان‌نما، یا در ``(y, x)`` در صورت مشخص بودن، درج می‌کند. تمام نویسه‌های سمت راست مکان‌نما یک موقعیت به راست جابه‌جا می‌شوند و راست‌ترین نویسه خط از بین می‌رود. موقعیت مکان‌نما تغییر نمی‌کند."

msgid "Insert *nlines* lines into the specified window above the current line. The *nlines* bottom lines are lost. For negative *nlines*, delete *nlines* lines starting with the one under the cursor, and move the remaining lines up. The bottom *nlines* lines are cleared. The current cursor position remains the same."

msgstr "*nlines* خط را در پنجره‌ی مشخص‌شده، بالای خط فعلی درج می‌کند. *nlines* خط پایینی از دست می‌روند. برای *nlines* منفی، *nlines* خط را شروع از خط زیر مکان‌نما حذف می‌کند و سطرهای باقی‌مانده را به بالا حرکت می‌دهد. *nlines* خط پایینی پاک می‌شوند. موقعیت فعلی مکان‌نما بدون تغییر باقی می‌ماند."

msgid "Insert a blank line under the cursor. All following lines are moved down by one line."

msgstr "یک خط خالی زیر مکان‌نما درج می‌کند. همه‌ی سطرهای بعدی یک خط به پایین جابه‌جا می‌شوند."

msgid "Insert a character string (as many characters as will fit on the line) before the character under the cursor, up to *n* characters. If *n* is zero or negative, the entire string is inserted. All characters to the right of the cursor are shifted right, with the rightmost characters on the line being lost. The cursor position does not change (after moving to *y*, *x*, if specified)."

msgstr "یک رشته از نویسه‌ها (هر تعداد نویسه که در خط جا شود) را پیش از نویسه‌ی زیر مکان‌نما، تا سقف *n* نویسه درج کنید. اگر *n* صفر یا منفی باشد، تمام رشته درج می‌شود. همه‌ی نویسه‌های سمت راست مکان‌نما به سمت راست جابه‌جا می‌شوند و راست‌ترین نویسه‌های خط از دست می‌روند. موقعیت مکان‌نما تغییر نمی‌کند (پس از حرکت به *y*، *x*، در صورت مشخص بودن)."

msgid "Insert a character string (as many characters as will fit on the line) before the character under the cursor. All characters to the right of the cursor are shifted right, with the rightmost characters on the line being lost. The cursor position does not change (after moving to *y*, *x*, if specified)."

msgstr "یک رشته‌ی نویسه‌ای (به تعداد نویسه‌هایی که در خط جا می‌شوند) پیش از نویسه‌ی زیر مکان‌نما درج می‌شود. همه‌ی نویسه‌های سمت راست مکان‌نما به سمت راست جابه‌جا می‌شوند و راست‌ترین نویسه‌های خط از دست می‌روند. موقعیت مکان‌نما تغییر نمی‌کند (پس از حرکت به *y*، *x*، در صورت مشخص بودن)."

msgid "Read the text of the window from the current cursor position, or from *y*, *x* if specified, to the end of the line, and return it as a bytes object, in the encoding of the current locale. Attributes and color pairs are stripped. At most *n* bytes are read; *n* defaults to and cannot exceed 2047."

msgstr "متن پنجره را از موقعیتِ جاریِ نشانگر، یا از *y*، *x* در صورت تعیین، تا پایانِ سطر بخوانید، و آن را به عنوان یک شیء بایت‌ها برگردانید، در کدگذاریِ locale جاری. ویژگی‌ها و جفت‌های رنگ حذف می‌شوند. حداکثر *n* بایت خوانده می‌شود؛ *n* به پیش‌فرض ۲۰۴۷ است و نمی‌تواند از آن بیشتر باشد."

msgid "Return ``True`` if the specified line was modified since the last call to :meth:`refresh`; otherwise return ``False``. Raise a :exc:`curses.error` exception if *line* is not valid for the given window."

msgstr "اگر سطر مشخص‌شده از آخرین فراخوانی :meth:`refresh` تغییر کرده باشد، ``True`` را برمی‌گرداند؛ در غیر این صورت ``False`` را برمی‌گرداند. اگر *line* برای پنجره داده‌شده معتبر نباشد، استثنای :exc:`curses.error` پرتاب می‌شود."

msgid "Return ``True`` if the specified window was modified since the last call to :meth:`refresh`; otherwise return ``False``."

msgstr "اگر پنجره‌ی مشخص‌شده از آخرین فراخوانی :meth:`refresh` تغییر کرده باشد، ``True`` را برمی‌گرداند؛ در غیر این صورت ``False`` را برمی‌گرداند."

msgid "If *flag* is ``True``, escape sequences generated by some keys (keypad, function keys) will be interpreted by :mod:`!curses`. If *flag* is ``False``, escape sequences will be left as is in the input stream. Keypad mode is disabled by default, but :func:`wrapper` enables it for the main window."

msgstr "اگر *flag* برابر ``True`` باشد، دنباله‌های گریز تولیدشده توسط برخی کلیدها (کی‌پد، کلیدهای تابع) توسط :mod:`!curses` تفسیر می‌شوند. اگر *flag* برابر ``False`` باشد، دنباله‌های گریز در جریان ورودی بدون تغییر باقی می‌مانند. حالت کی‌پد به پیش‌فرض غیرفعال است، اما :func:`wrapper` آن را برای پنجره‌ی اصلی فعال می‌کند."

msgid "If *flag* is ``True``, cursor is left where it is on update, instead of being at \"cursor position.\" This reduces cursor movement where possible."

msgstr "اگر *flag* برابر ``True`` باشد، مکان‌نما هنگام به‌روزرسانی در همان جای خود باقی می‌ماند، به جای آنکه در «موقعیت مکان‌نما» قرار گیرد. این کار حرکت مکان‌نما را تا حد ممکن کاهش می‌دهد."

msgid "If *flag* is ``False``, cursor will always be at \"cursor position\" after an update."

msgstr "اگر *flag* برابر ``False`` باشد، مکان‌نما پس از یک به‌روزرسانی همیشه در «موقعیت مکان‌نما» خواهد بود."

msgid "Move cursor to ``(new_y, new_x)``."

msgstr "مکان‌نما را به ``(new_y, new_x)`` حرکت دهید."

msgid "Move the window inside its parent window. The screen-relative parameters of the window are not changed. This routine is used to display different parts of the parent window at the same physical position on the screen."

msgstr "پنجره را درون پنجره‌ی والد آن جابه‌جا کنید. پارامترهای پنجره نسبت به صفحه‌ی نمایش تغییر داده نمی‌شوند. این رویه برای نمایش بخش‌های مختلف پنجره‌ی والد در یک موقعیت فیزیکی یکسان روی صفحه‌ی نمایش استفاده می‌شود."

msgid "Move the window so its upper-left corner is at ``(new_y, new_x)``."

msgstr "پنجره را جابه‌جا کنید تا گوشه‌ی بالا-چپ آن در ``(new_y, new_x)`` قرار گیرد."

msgid "Moving the window so that any part of it would be off the screen is an error: the window is not moved and :exc:`curses.error` is raised."

msgstr "جابه‌جایی پنجره به گونه‌ای که هر بخشی از آن خارج از صفحه باشد، خطا است: پنجره جابه‌جا نمی‌شود و :exc:`curses.error` پرتاب می‌شود."

msgid "If *flag* is ``True``, :meth:`getch` will be non-blocking."

msgstr "اگر *flag* برابر ``True`` باشد، :meth:`getch` غیرمسدود خواهد بود."

msgid "If *flag* is ``True``, escape sequences will not be timed out."

msgstr "اگر *flag* برابر ``True`` باشد، زمان انقضا برای دنباله‌های خنثی‌سازی اعمال نخواهد شد."

msgid "If *flag* is ``False``, after a few milliseconds, an escape sequence will not be interpreted, and will be left in the input stream as is."

msgstr "اگر *flag* برابر ``False`` باشد، پس از چند میلی‌ثانیه، یک دنباله‌ی گریز (escape sequence) تفسیر نخواهد شد و همان‌گونه که هست در جریان ورودی باقی خواهد ماند."

msgid "Mark for refresh but wait. This function updates the data structure representing the desired state of the window, but does not force an update of the physical screen. To accomplish that, call :func:`doupdate`."

msgstr "برای نوسازی علامت‌گذاری می‌کند، اما درنگ می‌کند. این تابع ساختار داده‌ای را که نشان‌دهنده وضعیت مطلوب پنجره است به‌روزرسانی می‌کند، اما به‌روزرسانی صفحه نمایش فیزیکی را تحمیل نمی‌کند. برای انجام آن، :func:`doupdate` را فراخوانی کنید."

msgid "The 6 arguments can only be specified, and are then required, when the window is a pad created with :func:`newpad`; they have the same meaning as for :meth:`refresh`."

msgstr "این ۶ آرگومان را فقط زمانی می‌توان تعیین کرد، و در آن صورت الزامی هستند، که پنجره یک پد ساخته‌شده با :func:`newpad` باشد؛ معنای آن‌ها همان معنایی است که برای :meth:`refresh` وجود دارد."

msgid "Overlay the window on top of *destwin*. The windows need not be the same size, only the overlapping region is copied. This copy is non-destructive, which means that the current background character does not overwrite the old contents of *destwin*."

msgstr "پنجره را بر روی *destwin* همپوشانی می‌کند. لازم نیست پنجره‌ها هم‌اندازه باشند، تنها ناحیه‌ی همپوشانی کپی می‌شود. این کپی غیرمخرب است، به این معنا که نویسه‌ی پس‌زمینه‌ی فعلی محتوای قبلی *destwin* را بازنویسی نمی‌کند."

msgid "To get fine-grained control over the copied region, the second form of :meth:`overlay` can be used. *sminrow* and *smincol* are the upper-left coordinates of the source window, and the other variables mark a rectangle in the destination window."

msgstr "برای به‌دست آوردن کنترل دقیق بر ناحیه‌ی کپی‌شده، می‌توان از دومین فرم :meth:`overlay` استفاده کرد. *sminrow* و *smincol* مختصات گوشه‌ی بالا-چپ پنجره‌ی مبدأ هستند، و سایر متغیرها یک مستطیل را در پنجره‌ی مقصد مشخص می‌کنند."

msgid "Overwrite the window on top of *destwin*. The windows need not be the same size, in which case only the overlapping region is copied. This copy is destructive, which means that the current background character overwrites the old contents of *destwin*."

msgstr "پنجره را روی *destwin* بازنویسی می‌کند. لازم نیست پنجره‌ها هم‌اندازه باشند؛ در این صورت فقط ناحیه‌ی هم‌پوشانی کپی می‌شود. این کپی مخرب است، به این معنا که نویسه‌ی پس‌زمینه‌ی فعلی محتوای قدیمی *destwin* را بازنویسی می‌کند."

msgid "To get fine-grained control over the copied region, the second form of :meth:`overwrite` can be used. *sminrow* and *smincol* are the upper-left coordinates of the source window, the other variables mark a rectangle in the destination window."

msgstr "برای به دست آوردن کنترل ریزدانه بر ناحیه‌ی کپی‌شده، می‌توان از دومین شکل :meth:`overwrite` استفاده کرد. *sminrow* و *smincol* مختصات گوشه‌ی بالا-چپ پنجره‌ی مبدأ هستند، سایر متغیرها یک مستطیل را در پنجره‌ی مقصد مشخص می‌کنند."

msgid "Write all data associated with the window into the provided file object. This information can be later retrieved using the :func:`getwin` function."

msgstr "تمام داده‌های مرتبط با پنجره را در شیء پرونده ارائه‌شده می‌نویسد. این اطلاعات را می‌توان بعداً با استفاده از تابع :func:`getwin` بازیابی کرد."

msgid "Indicate that the *num* screen lines, starting at line *beg*, are corrupted and should be completely redrawn on the next :meth:`refresh` call."

msgstr "نشان می‌دهد که *num* خط از سطرهای صفحه، که از خط *beg* شروع می‌شوند، آسیب‌دیده‌اند و باید در فراخوانی بعدی :meth:`refresh` به‌طور کامل بازترسیم شوند."

msgid "Touch the entire window, causing it to be completely redrawn on the next :meth:`refresh` call."

msgstr "کل پنجره را لمس (touch) کنید؛ این کار باعث می‌شود در فراخوانی بعدی :meth:`refresh` به‌طور کامل بازترسیم شود."

msgid "Update the display immediately (sync actual screen with previous drawing/deleting methods)."

msgstr "نمایش را بلافاصله به‌روزرسانی کنید (صفحه واقعی را با متدهای قبلی ترسیم/حذف همگام‌سازی کنید)."

msgid "The 6 arguments can only be specified, and are then required, when the window is a pad created with :func:`newpad`. The additional parameters are needed to indicate what part of the pad and screen are involved. *pminrow* and *pmincol* specify the upper-left corner of the rectangle to be displayed in the pad. *sminrow*, *smincol*, *smaxrow*, and *smaxcol* specify the edges of the rectangle to be displayed on the screen. The lower-right corner of the rectangle to be displayed in the pad is calculated from the screen coordinates, since the rectangles must be the same size. Both rectangles must be entirely contained within their respective structures. Negative values of *pminrow*, *pmincol*, *sminrow*, or *smincol* are treated as if they were zero."

msgstr "این ۶ آرگومان فقط زمانی می‌توانند مشخص شوند، و در آن صورت الزامی هستند، که پنجره یک پد باشد که با :func:`newpad` ایجاد شده است. پارامترهای اضافی برای مشخص‌کردن اینکه چه بخشی از پد و صفحه درگیر است، لازم هستند. *pminrow* و *pmincol* گوشه‌ی بالا سمت چپ مستطیلی را که باید در پد نمایش داده شود مشخص می‌کنند. *sminrow*، *smincol*، *smaxrow* و *smaxcol* لبه‌های مستطیلی را که باید روی صفحه نمایش داده شود مشخص می‌کنند. گوشه‌ی پایین سمت راست مستطیلی که باید در پد نمایش داده شود، از مختصات صفحه محاسبه می‌شود، زیرا اندازه‌ی مستطیل‌ها باید یکسان باشد. هر دو مستطیل باید به‌طور کامل درون ساختارهای مربوط به خود قرار داشته باشند. مقادیر منفی *pminrow*، *pmincol*، *sminrow* یا *smincol* به‌عنوان صفر در نظر گرفته می‌شوند."

msgid "Reallocate storage for a curses window to adjust its dimensions to the specified values. If either dimension is larger than the current values, the window's data is filled with blanks that have the current background rendition (as set by :meth:`bkgdset`) merged into them."

msgstr "فضای ذخیره‌سازی برای یک پنجره curses را دوباره تخصیص می‌دهد تا ابعاد آن با مقادیر مشخص‌شده تنظیم شود. اگر هر یک از ابعاد بزرگ‌تر از مقادیر فعلی باشد، داده‌های پنجره با نویسه‌های خالی پر می‌شوند که جلوه پس‌زمینه فعلی (که با :meth:`bkgdset` تنظیم شده است) در آن‌ها ادغام شده است."

msgid "Scroll the screen or scrolling region. Scroll upward by *lines* lines if *lines* is positive, or downward if it is negative. Scrolling has no effect unless it has been enabled for the window with :meth:`scrollok`."

msgstr "صفحه یا ناحیه‌ی پیمایش را پیمایش می‌کند. اگر *lines* مثبت باشد، به اندازه‌ی *lines* خط به بالا پیمایش می‌شود و اگر منفی باشد، به پایین پیمایش می‌شود. پیمایش هیچ اثری ندارد مگر اینکه با :meth:`scrollok` برای پنجره فعال شده باشد."

msgid "Control what happens when the cursor of a window is moved off the edge of the window or scrolling region, either as a result of a newline action on the bottom line, or typing the last character of the last line. If *flag* is ``False``, the cursor is left on the bottom line. If *flag* is ``True``, the window is scrolled up one line. Note that in order to get the physical scrolling effect on the terminal, it is also necessary to call :meth:`idlok`."

msgstr "کنترل کنید که وقتی مکان‌نمای یک پنجره از لبه‌ی پنجره یا ناحیه‌ی پیمایش خارج می‌شود، چه اتفاقی رخ می‌دهد؛ خواه در نتیجه‌ی یک عمل خط جدید روی خط پایین، خواه با تایپ آخرین نویسه‌ی خط آخر. اگر *flag* برابر ``False`` باشد، مکان‌نما روی خط پایین باقی می‌ماند. اگر *flag* برابر ``True`` باشد، پنجره یک خط به بالا پیمایش می‌شود. توجه داشته باشید که برای دریافت اثر پیمایش فیزیکی روی پایانه، لازم است :meth:`idlok` نیز فراخوانی شود."

msgid "Set the scrolling region from line *top* to line *bottom*. All scrolling actions will take place in this region."

msgstr "ناحیه‌ی پیمایش را از خط *top* تا خط *bottom* تنظیم کنید. تمام عملیات‌های پیمایش در این ناحیه انجام خواهند شد."

msgid "Turn off the standout attribute. On some terminals this has the side effect of turning off all attributes."

msgstr "ویژگی standout را خاموش کنید. در برخی پایانه‌ها، این کار به‌عنوان اثر جانبی، تمام ویژگی‌ها را خاموش می‌کند."

msgid "Turn on attribute *A_STANDOUT*."

msgstr "ویژگی *A_STANDOUT* را روشن کنید."

msgid "Return a sub-pad, whose upper-left corner is at ``(begin_y, begin_x)``, and whose width/height is *ncols*/*nlines*. The coordinates are relative to the parent pad (unlike :meth:`subwin`, which uses screen coordinates). This method is only available for pads created with :func:`newpad`."

msgstr "یک زیرپد (sub-pad) برمی‌گرداند که گوشه‌ی بالا-چپ آن در ``(begin_y, begin_x)`` قرار دارد و عرض/ارتفاع آن *ncols*/*nlines* است. مختصات نسبت به پد والد است (برخلاف :meth:`subwin`، که از مختصات صفحه استفاده می‌کند). این متد فقط برای پدهای ایجادشده با :func:`newpad` در دسترس است."

msgid "Return a sub-window, whose upper-left corner is at the screen-relative coordinates ``(begin_y, begin_x)``, and whose width/height is *ncols*/*nlines*."

msgstr "یک زیرپنجره را برمی‌گرداند که گوشه‌ی بالا-چپ آن در مختصات نسبت به صفحه‌ی نمایش ``(begin_y, begin_x)`` قرار دارد و عرض/ارتفاع آن *ncols*/*nlines* است."

msgid "By default, the sub-window will extend from the specified position to the lower right corner of the window."

msgstr "به‌طور پیش‌فرض، زیرپنجره از موقعیت مشخص‌شده تا گوشه‌ی پایین سمت راست پنجره امتداد خواهد یافت."

msgid "Touch each location in the window that has been touched in any of its ancestor windows. This routine is called by :meth:`refresh`, so it should almost never be necessary to call it manually."

msgstr "هر موقعیت در پنجره را که در هر یک از پنجره‌های نیاکان آن لمس شده باشد، لمس کنید. این روال توسط :meth:`refresh` فراخوانی می‌شود، بنابراین تقریباً هرگز نباید لازم باشد آن را به‌صورت دستی فراخوانی کنید."

msgid "If *flag* is ``True``, then :meth:`syncup` is called automatically whenever there is a change in the window."

msgstr "اگر *flag* برابر ``True`` باشد، :meth:`syncup` به‌طور خودکار هر زمان که تغییری در پنجره وجود داشته باشد فراخوانی می‌شود."

msgid "Touch all locations in ancestors of the window that have been changed in the window."

msgstr "تمام مکان‌های موجود در نیاکان پنجره را که در پنجره تغییر کرده‌اند، لمس کنید."

msgid "Set blocking or non-blocking read behavior for the window. If *delay* is negative, blocking read is used (which will wait indefinitely for input). If *delay* is zero, then non-blocking read is used, and :meth:`getch` will return ``-1`` if no input is waiting. If *delay* is positive, then :meth:`getch` will block for *delay* milliseconds, and return ``-1`` if there is still no input at the end of that time."

msgstr "تنظیم رفتار خواندن مسدودکننده یا غیرمسدودکننده برای پنجره. اگر *delay* منفی باشد، از خواندن مسدودکننده استفاده می‌شود (که به‌طور نامحدود برای ورودی منتظر می‌ماند). اگر *delay* صفر باشد، از خواندن غیرمسدودکننده استفاده می‌شود و :meth:`getch` در صورتی که هیچ ورودی در انتظار نباشد، ``-1`` را برمی‌گرداند. اگر *delay* مثبت باشد، :meth:`getch` به مدت *delay* میلی‌ثانیه مسدود می‌شود و اگر در پایان آن زمان هنوز ورودی وجود نداشته باشد، ``-1`` را برمی‌گرداند."

msgid "Pretend *count* lines have been changed, starting with line *start*. If *changed* is supplied, it specifies whether the affected lines are marked as having been changed (*changed*\\ ``=True``) or unchanged (*changed*\\ ``=False``)."

msgstr "فرض کنید *count* خط با شروع از خط *start* تغییر کرده‌اند. اگر *changed* ارائه شود، مشخص می‌کند که سطرهای متأثر به‌عنوان تغییر یافته علامت‌گذاری شده‌اند (*changed*\\ ``=True``) یا بدون تغییر علامت‌گذاری شده‌اند (*changed*\\ ``=False``)."

msgid "Pretend the whole window has been changed, for purposes of drawing optimizations."

msgstr "برای بهینه‌سازی ترسیم، فرض کنید کل پنجره تغییر کرده است."

msgid "Mark all lines in the window as unchanged since the last call to :meth:`refresh`."

msgstr "تمام سطرهای پنجره را از آخرین فراخوانی :meth:`refresh` به‌عنوان بدون تغییر علامت‌گذاری می‌کند."

msgid "Display a vertical line starting at ``(y, x)`` with length *n* consisting of the character *ch* with attributes *attr*."

msgstr "یک خط عمودی را از ``(y, x)`` با طول *n* نمایش می‌دهد که از نویسه‌ی *ch* با ویژگی‌های *attr* تشکیل شده است."

msgid "Constants"

msgstr "ثابت‌ها"

msgid "The :mod:`!curses` module defines the following data members:"

msgstr "ماژول :mod:`!curses` اعضای داده‌ای زیر را تعریف می‌کند:"

msgid "Some curses routines that return an integer, such as :meth:`~window.getch`, return :const:`ERR` upon failure."

msgstr "برخی از روال‌های curses که عدد صحیحی برمی‌گردانند، مانند :meth:`~window.getch`، در صورت شکست :const:`ERR` را برمی‌گردانند."

msgid "Some curses routines that return an integer, such as :func:`napms`, return :const:`OK` upon success."

msgstr "برخی روتین‌های curses که یک عدد صحیح برمی‌گردانند، مانند :func:`napms`، در صورت موفقیت :const:`OK` را برمی‌گردانند."

msgid "A bytes object representing the current version of the module."

msgstr "یک شیء bytes که نسخه‌ی فعلی ماژول را نشان می‌دهد."

msgid "A named tuple containing the three components of the ncurses library version: *major*, *minor*, and *patch*. All values are integers. The components can also be accessed by name, so ``curses.ncurses_version[0]`` is equivalent to ``curses.ncurses_version.major`` and so on."

msgstr "یک تاپل نام‌دار (named tuple) شامل سه کامپوننت از نسخه‌ی کتابخانه‌ی ncurses: *major*، *minor* و *patch*. همه‌ی مقدارها عدد صحیح هستند. همچنین می‌توان به این کامپوننت‌ها با نام دسترسی داشت، بنابراین ``curses.ncurses_version[0]`` معادل ``curses.ncurses_version.major`` است و به همین ترتیب."

msgid "Availability: if the ncurses library is used."

msgstr "دسترس‌پذیری: اگر از کتابخانه ncurses استفاده شود."

msgid "The maximum number of colors the terminal can support. It is defined only after the call to :func:`start_color`."

msgstr "حداکثر تعداد رنگ‌هایی که پایانه می‌تواند از آن‌ها پشتیبانی کند. این مقدار فقط پس از فراخوانی :func:`start_color` تعریف می‌شود."

msgid "The maximum number of color pairs the terminal can support. It is defined only after the call to :func:`start_color`."

msgstr "حداکثر تعداد جفت‌های رنگی که پایانه می‌تواند از آن‌ها پشتیبانی کند. این مقدار فقط پس از فراخوانی :func:`start_color` تعریف می‌شود."

msgid "The width of the screen, that is, the number of columns. It is defined only after the call to :func:`initscr`. Updated by :func:`update_lines_cols`, :func:`resizeterm` and :func:`resize_term`."

msgstr "عرض صفحه، یعنی تعداد ستون‌ها. این مقدار فقط پس از فراخوانی :func:`initscr` تعریف می‌شود. توسط :func:`update_lines_cols`، :func:`resizeterm` و :func:`resize_term` به‌روزرسانی می‌شود."

msgid "The height of the screen, that is, the number of lines. It is defined only after the call to :func:`initscr`. Updated by :func:`update_lines_cols`, :func:`resizeterm` and :func:`resize_term`."

msgstr "ارتفاع صفحه، یعنی تعداد سطرهای. این مقدار تنها پس از فراخوانی :func:`initscr` تعریف می‌شود. توسط :func:`update_lines_cols`، :func:`resizeterm` و :func:`resize_term` به‌روزرسانی می‌شود."

msgid "Some constants are available to specify character cell attributes. The exact constants available are system dependent."

msgstr "برخی ثابت‌ها برای تعیین ویژگی‌های سلول نویسه در دسترس هستند. ثابت‌های دقیقی که در دسترس هستند، به سیستم وابسته‌اند."

msgid "Attribute"

msgstr "ویژگی"

msgid "Meaning"

msgstr "معنی"

msgid "Alternate character set mode"

msgstr "حالت مجموعه‌نویسه‌ی جایگزین"

msgid "Blink mode"

msgstr "حالت چشمک‌زن"

msgid "Bold mode"

msgstr "حالت پررنگ"

msgid "Dim mode"

msgstr "حالت کم‌نور"

msgid "Invisible or blank mode"

msgstr "حالت نامرئی یا خالی"

msgid "Italic mode"

msgstr "حالت کج"

msgid "Normal attribute"

msgstr "ویژگی عادی"

msgid "Protected mode"

msgstr "حالت محافظت‌شده"

msgid "Reverse background and foreground colors"

msgstr "معکوس کردن رنگ‌های پس‌زمینه و پیش‌زمینه"

msgid "Standout mode"

msgstr "حالت برجسته (Standout mode)"

msgid "Underline mode"

msgstr "حالت زیرخط"

msgid "Horizontal highlight"

msgstr "برجسته‌سازی افقی"

msgid "Left highlight"

msgstr "برجسته‌سازی سمت چپ"

msgid "Low highlight"

msgstr "برجسته‌سازی کم"

msgid "Right highlight"

msgstr "برجسته‌سازی راست"

msgid "Top highlight"

msgstr "برجسته‌سازی بالا"

msgid "Vertical highlight"

msgstr "برجسته‌سازی عمودی"

msgid "``A_ITALIC`` was added."

msgstr "``A_ITALIC`` افزوده شد."

msgid "Several constants are available to extract corresponding attributes returned by some methods."

msgstr "چندین ثابت برای استخراج ویژگی‌های متناظری که توسط برخی متدها برگردانده می‌شوند، در دسترس هستند."

msgid "Bit-mask"

msgstr "نقاب بیتی"

msgid "Bit-mask to extract attributes"

msgstr "نقاب بیتی (bit-mask) برای استخراج ویژگی‌ها"

msgid "Bit-mask to extract a character"

msgstr "نقاب بیتی برای استخراج یک نویسه"

msgid "Bit-mask to extract color-pair field information"

msgstr "نقاب بیتی (bit-mask) برای استخراج اطلاعات فیلد جفت‌رنگ"

msgid "Keys are referred to by integer constants with names starting with ``KEY_``. The exact keycaps available are system dependent."

msgstr "کلیدها با ثابت‌های عدد صحیح با نام‌هایی که با ``KEY_`` آغاز می‌شوند، ارجاع داده می‌شوند. کلیدهای دقیق موجود، به سیستم وابسته‌اند."

msgid "Key constant"

msgstr "ثابت کلید"

msgid "Key"

msgstr "کلید"

msgid "Minimum key value"

msgstr "کمینه مقدار کلید"

msgid "Break key (unreliable)"

msgstr "کلید Break (غیرقابل‌اعتماد)"

msgid "Down-arrow"

msgstr "فلش پایین"

msgid "Up-arrow"

msgstr "فلش بالا"

msgid "Left-arrow"

msgstr "پیکان چپ"

msgid "Right-arrow"

msgstr "فلش راست"

msgid "Home key (upward+left arrow)"

msgstr "کلید Home (فلش بالا+چپ)"

msgid "Backspace (unreliable)"

msgstr "پس‌بر (غیرقابل‌اطمینان)"

msgid "Function keys. Up to 64 function keys are supported."

msgstr "کلیدهای تابعی. تا ۶۴ کلید تابعی پشتیبانی می‌شود."

msgid "Value of function key *n*"

msgstr "مقدار کلید تابعی *n*"

msgid "Delete line"

msgstr "حذف خط"

msgid "Insert line"

msgstr "درج خط"

msgid "Delete character"

msgstr "نویسه‌ی حذف"

msgid "Insert char or enter insert mode"

msgstr "درج نویسه یا ورود به حالت درج"

msgid "Exit insert char mode"

msgstr "خروج از حالت درج نویسه"

msgid "Clear screen"

msgstr "پاک‌کردن صفحه"

msgid "Clear to end of screen"

msgstr "پاک کردن تا انتهای صفحه"

msgid "Clear to end of line"

msgstr "پاک‌سازی تا انتهای خط"

msgid "Scroll 1 line forward"

msgstr "پیمایش ۱ خط به جلو"

msgid "Scroll 1 line backward (reverse)"

msgstr "پیمایش ۱ خط به عقب (معکوس)"

msgid "Next page"

msgstr "صفحه بعدی"

msgid "Previous page"

msgstr "صفحه قبلی"

msgid "Set tab"

msgstr "تنظیم زبانه"

msgid "Clear tab"

msgstr "پاک‌کردن زبانه"

msgid "Clear all tabs"

msgstr "پاک کردن همه زبانه‌ها"

msgid "Enter or send (unreliable)"

msgstr "Enter یا ارسال (غیرقابل‌اعتماد)"

msgid "Soft (partial) reset (unreliable)"

msgstr "بازنشانی نرم (جزئی) (غیرقابل‌اطمینان)"

msgid "Reset or hard reset (unreliable)"

msgstr "بازنشانی یا بازنشانی سخت (غیرقابل‌اطمینان)"

msgid "Print"

msgstr "چاپ"

msgid "Home down or bottom (lower left)"

msgstr "Home down یا bottom (پایین سمت چپ)"

msgid "Upper left of keypad"

msgstr "بالا سمت چپ صفحه‌کلید"

msgid "Upper right of keypad"

msgstr "بالا سمت راست صفحه‌کلید"

msgid "Center of keypad"

msgstr "مرکز صفحه‌کلید عددی"

msgid "Lower left of keypad"

msgstr "پایین سمت چپ صفحه‌کلید عددی"

msgid "Lower right of keypad"

msgstr "پایین سمت راست صفحه‌کلید عددی"

msgid "Back tab"

msgstr "تب معکوس (Back tab)"

msgid "Beg (beginning)"

msgstr "Beg (آغاز)"

msgid "Cancel"