# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2022, Python Software Foundation

# This file is distributed under the same license as the Python package.

#

# Translators:

msgid ""

msgstr ""

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

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

"POT-Creation-Date: 2023-07-29 10:36+0000\n"

"PO-Revision-Date: 2018-05-23 14:42+0000\n"

"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"

"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"

"tw)\n"

"Language: zh_TW\n"

"MIME-Version: 1.0\n"

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

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

"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../library/curses.rst:2

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

msgstr ""

#: ../../library/curses.rst:12

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

msgstr "**原始碼：**\\ :source:`Lib/curses`"

#: ../../library/curses.rst:16

msgid ""

"The :mod:`curses` module provides an interface to the curses library, the de-"

"facto standard for portable advanced terminal handling."

msgstr ""

#: ../../library/curses.rst:19

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 ""

#: ../../library/curses.rst:26

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."

msgstr ""

#: ../../library/curses.rst:29

msgid ""

"Whenever the documentation mentions a *character string* it can be specified "

"as a Unicode string or a byte string."

msgstr ""

#: ../../library/curses.rst:35

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

msgstr ""

#: ../../library/curses.rst:35

msgid ""

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

"settings."

msgstr ""

#: ../../library/curses.rst:38

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

msgstr ""

#: ../../library/curses.rst:38

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

msgstr ""

#: ../../library/curses.rst:41

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

msgstr ""

#: ../../library/curses.rst:41

msgid ""

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

"bindings."

msgstr ""

#: ../../library/curses.rst:44

msgid ":ref:`curses-howto`"

msgstr ":ref:`curses-howto`"

#: ../../library/curses.rst:44

msgid ""

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

"Raymond."

msgstr ""

#: ../../library/curses.rst:51

msgid "Functions"

msgstr "函式"

#: ../../library/curses.rst:53

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

msgstr ""

#: ../../library/curses.rst:58

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

msgstr ""

#: ../../library/curses.rst:62

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 ""

#: ../../library/curses.rst:66

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

msgstr ""

#: ../../library/curses.rst:71

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 ""

#: ../../library/curses.rst:79

msgid "Emit a short attention sound."

msgstr ""

#: ../../library/curses.rst:84

msgid ""

"Return ``True`` or ``False``, depending on whether the programmer can change "

"the colors displayed by the terminal."

msgstr ""

#: ../../library/curses.rst:90

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 ""

#: ../../library/curses.rst:99

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)."

msgstr ""

#: ../../library/curses.rst:107

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 ""

#: ../../library/curses.rst:116

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 ""

#: ../../library/curses.rst:125

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 ""

#: ../../library/curses.rst:133

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 ""

#: ../../library/curses.rst:141

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

msgstr ""

#: ../../library/curses.rst:146

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` ground updates "

"the physical screen to match the virtual screen."

msgstr ""

#: ../../library/curses.rst:151

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 ""

#: ../../library/curses.rst:161

msgid ""

"Enter echo mode. In echo mode, each character input is echoed to the screen "

"as it is entered."

msgstr ""

#: ../../library/curses.rst:167

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

msgstr ""

#: ../../library/curses.rst:172

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 ""

#: ../../library/curses.rst:179

msgid ""

"The :func:`.filter` routine, if used, must be called before :func:`initscr` "

"is called. The effect is that, during those calls, :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 ""

#: ../../library/curses.rst:189

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 ""

#: ../../library/curses.rst:196

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 ""

#: ../../library/curses.rst:202

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 ""

#: ../../library/curses.rst:213 ../../library/curses.rst:1774

msgid ""

"The ``BUTTON5_*`` constants are now exposed if they are provided by the "

"underlying curses library."

msgstr ""

#: ../../library/curses.rst:220

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 ""

#: ../../library/curses.rst:226

msgid ""

"Read window related data stored in the file by an earlier :func:`window."

"putwin` call. The routine then creates and initializes a new window using "

"that data, returning the new window object."

msgstr ""

#: ../../library/curses.rst:233

msgid ""

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

"``False``."

msgstr ""

#: ../../library/curses.rst:237

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 (e.g. xterm-256color)."

msgstr ""

#: ../../library/curses.rst:241

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

msgstr ""

#: ../../library/curses.rst:247

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 ""

#: ../../library/curses.rst:254

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 ""

#: ../../library/curses.rst:262

msgid ""

"Take a key value *ch*, and return ``True`` if the current terminal type "

"recognizes a key with that value."

msgstr ""

#: ../../library/curses.rst:268

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 ""

#: ../../library/curses.rst:277

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 ""

#: ../../library/curses.rst:288

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 is wired to white on black and "

"cannot be changed). The value of *fg* and *bg* arguments must be between "

"``0`` and ``COLORS - 1``, or, after calling :func:`use_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 ""

#: ../../library/curses.rst:301

msgid ""

"Initialize the library. Return a :ref:`window <curses-window-objects>` "

"object which represents the whole screen."

msgstr ""

#: ../../library/curses.rst:306

msgid ""

"If there is an error opening the terminal, the underlying curses library may "

"cause the interpreter to exit."

msgstr ""

#: ../../library/curses.rst:312

msgid ""

"Return ``True`` if :func:`resize_term` would modify the window structure, "

"``False`` otherwise."

msgstr ""

#: ../../library/curses.rst:318

msgid ""

"Return ``True`` if :func:`endwin` has been called (that is, the curses "

"library has been deinitialized)."

msgstr ""

#: ../../library/curses.rst:324

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 ""

#: ../../library/curses.rst:334

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 ""

#: ../../library/curses.rst:341

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 ""

#: ../../library/curses.rst:348

msgid ""

"If *flag* is ``True``, allow 8-bit characters to be input. If *flag* is "

"``False``, allow only 7-bit chars."

msgstr ""

#: ../../library/curses.rst:354

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 200 milliseconds, or one "

"fifth of a second."

msgstr ""

#: ../../library/curses.rst:361

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 given window's mouse event mask. If this function is "

"never called, no mouse events are ever reported."

msgstr ""

#: ../../library/curses.rst:370

msgid "Sleep for *ms* milliseconds."

msgstr ""

#: ../../library/curses.rst:375

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 ""

#: ../../library/curses.rst:378

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 ""

#: ../../library/curses.rst:394

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 ""

#: ../../library/curses.rst:397

msgid ""

"By default, the window will extend from the specified position to the lower "

"right corner of the screen."

msgstr ""

#: ../../library/curses.rst:403

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 ""

#: ../../library/curses.rst:410

msgid ""

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

msgstr ""

#: ../../library/curses.rst:415

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

msgstr ""

#: ../../library/curses.rst:420

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 ""

#: ../../library/curses.rst:430

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 ""

#: ../../library/curses.rst:438

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

msgstr ""

#: ../../library/curses.rst:443

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 ""

#: ../../library/curses.rst:449

msgid ""

"Return the number of the color-pair set by the attribute value *attr*. :func:"

"`color_pair` is the counterpart to this function."

msgstr ""

#: ../../library/curses.rst:455

msgid ""

"Equivalent to ``tputs(str, 1, putchar)``; emit the value of a specified "

"terminfo capability for the current terminal. Note that the output of :func:"

"`putp` always goes to standard output."

msgstr ""

#: ../../library/curses.rst:462

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 ""

#: ../../library/curses.rst:469

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 ""

#: ../../library/curses.rst:476

msgid ""

"Restore the terminal to \"program\" mode, as previously saved by :func:"

"`def_prog_mode`."

msgstr ""

#: ../../library/curses.rst:482

msgid ""

"Restore the terminal to \"shell\" mode, as previously saved by :func:"

"`def_shell_mode`."

msgstr ""

#: ../../library/curses.rst:488

msgid ""

"Restore the state of the terminal modes to what it was at the last call to :"

"func:`savetty`."

msgstr ""

#: ../../library/curses.rst:494

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 ""

#: ../../library/curses.rst:504

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 ""

#: ../../library/curses.rst:511

msgid ""

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

"`resetty`."

msgstr ""

#: ../../library/curses.rst:516

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

msgstr ""

#: ../../library/curses.rst:522

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 ""

#: ../../library/curses.rst:530

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

msgstr ""

#: ../../library/curses.rst:536

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 ""

#: ../../library/curses.rst:543

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 ""

#: ../../library/curses.rst:549

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 ""

#: ../../library/curses.rst:558

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 ""

#: ../../library/curses.rst:562

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 ""

#: ../../library/curses.rst:571

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 ""

#: ../../library/curses.rst:578

msgid ""

"Return the value of the environment variable :envvar:`TERM`, as a bytes "

"object, truncated to 14 characters."

msgstr ""

#: ../../library/curses.rst:584

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 ""

#: ../../library/curses.rst:592

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 ""

#: ../../library/curses.rst:600

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 ""

#: ../../library/curses.rst:608

msgid ""

"Instantiate the bytes object *str* with the supplied parameters, where *str* "

"should be a parameterized string obtained from the terminfo database. E.g. "

"``tparm(tigetstr(\"cup\"), 5, 3)`` could result in ``b'\\033[6;4H'``, the "

"exact result depending on terminal type."

msgstr ""

#: ../../library/curses.rst:616

msgid ""

"Specify that the file descriptor *fd* be used for typeahead checking. If "

"*fd* is ``-1``, then no typeahead checking is done."

msgstr ""

#: ../../library/curses.rst:619

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 ""

#: ../../library/curses.rst:628

msgid ""

"Return a bytes object which is a printable representation of the character "

"*ch*. Control characters are represented as a caret followed by the "

"character, for example as ``b'^C'``. Printing characters are left as they "

"are."

msgstr ""

#: ../../library/curses.rst:635

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

msgstr ""

#: ../../library/curses.rst:639

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

msgstr ""

#: ../../library/curses.rst:644

msgid ""

"Update the :const:`LINES` and :const:`COLS` module variables. Useful for "

"detecting manual screen resize."

msgstr ""

#: ../../library/curses.rst:652

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

msgstr ""

#: ../../library/curses.rst:656

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

msgstr ""

#: ../../library/curses.rst:663

msgid ""

"Push a :const:`KEY_MOUSE` event onto the input queue, associating the given "

"state data with it."

msgstr ""

#: ../../library/curses.rst:669

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 ""

#: ../../library/curses.rst:679

msgid ""

"Allow use of default values for colors on terminals supporting this feature. "

"Use this to support transparency in your application. The default color is "

"assigned to the color number ``-1``. After calling this function, "

"``init_pair(x, curses.COLOR_RED, -1)`` initializes, for instance, color pair "

"*x* to a red foreground color on the default background."

msgstr ""

#: ../../library/curses.rst:688

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 ""

#: ../../library/curses.rst:702

msgid "Window Objects"

msgstr ""

#: ../../library/curses.rst:704

msgid ""

"Window objects, as returned by :func:`initscr` and :func:`newwin` above, "

"have the following methods and attributes:"

msgstr ""

#: ../../library/curses.rst:711

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 ""

#: ../../library/curses.rst:717

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 ""

#: ../../library/curses.rst:725

msgid ""

"Paint at most *n* characters of the character string *str* at ``(y, x)`` "

"with attributes *attr*, overwriting anything previously on the display."

msgstr ""

#: ../../library/curses.rst:733

msgid ""

"Paint the character string *str* at ``(y, x)`` with attributes *attr*, "

"overwriting anything previously on the display."

msgstr ""

#: ../../library/curses.rst:738

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 ""

#: ../../library/curses.rst:742

msgid ""

"A `bug in ncurses <https://bugs.python.org/issue35924>`_, the backend for "

"this Python module, can cause SegFaults when resizing windows. This is fixed "

"in ncurses-6.1-20190511. If you are stuck with an earlier ncurses, you can "

"avoid triggering this if you do not call :func:`addstr` with a *str* that "

"has embedded newlines. Instead, call :func:`addstr` separately for each "

"line."

msgstr ""

#: ../../library/curses.rst:752

msgid ""

"Remove attribute *attr* from the \"background\" set applied to all writes to "

"the current window."

msgstr ""

#: ../../library/curses.rst:758

msgid ""

"Add attribute *attr* from the \"background\" set applied to all writes to "

"the current window."

msgstr ""

#: ../../library/curses.rst:764

msgid ""

"Set the \"background\" set of attributes to *attr*. This set is initially "

"``0`` (no attributes)."

msgstr ""

#: ../../library/curses.rst:770

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 ""

#: ../../library/curses.rst:774

msgid ""

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

"background attribute."

msgstr ""

#: ../../library/curses.rst:777

msgid ""

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

"background character."

msgstr ""

#: ../../library/curses.rst:783

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 ""

#: ../../library/curses.rst:793

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 ""

#: ../../library/curses.rst:799

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 ""

#: ../../library/curses.rst:804

msgid "Parameter"

msgstr "參數"

#: ../../library/curses.rst:804

msgid "Description"

msgstr "描述"

#: ../../library/curses.rst:804

msgid "Default value"

msgstr ""

#: ../../library/curses.rst:806

msgid "*ls*"

msgstr "*ls*"

#: ../../library/curses.rst:806

msgid "Left side"

msgstr ""

#: ../../library/curses.rst:806 ../../library/curses.rst:808

msgid ":const:`ACS_VLINE`"

msgstr ":const:`ACS_VLINE`"

#: ../../library/curses.rst:808

msgid "*rs*"

msgstr "*rs*"

#: ../../library/curses.rst:808

msgid "Right side"

msgstr ""

#: ../../library/curses.rst:810

msgid "*ts*"

msgstr "*ts*"

#: ../../library/curses.rst:810

msgid "Top"

msgstr ""

#: ../../library/curses.rst:810 ../../library/curses.rst:812

msgid ":const:`ACS_HLINE`"

msgstr ":const:`ACS_HLINE`"

#: ../../library/curses.rst:812

msgid "*bs*"

msgstr "*bs*"

#: ../../library/curses.rst:812

msgid "Bottom"

msgstr ""

#: ../../library/curses.rst:814

msgid "*tl*"

msgstr "*tl*"

#: ../../library/curses.rst:814

msgid "Upper-left corner"

msgstr ""

#: ../../library/curses.rst:814

msgid ":const:`ACS_ULCORNER`"

msgstr ":const:`ACS_ULCORNER`"

#: ../../library/curses.rst:816

msgid "*tr*"

msgstr "*tr*"

#: ../../library/curses.rst:816

msgid "Upper-right corner"

msgstr ""

#: ../../library/curses.rst:816

msgid ":const:`ACS_URCORNER`"

msgstr ":const:`ACS_URCORNER`"

#: ../../library/curses.rst:818

msgid "*bl*"

msgstr "*bl*"

#: ../../library/curses.rst:818

msgid "Bottom-left corner"

msgstr ""

#: ../../library/curses.rst:818

msgid ":const:`ACS_LLCORNER`"

msgstr ":const:`ACS_LLCORNER`"

#: ../../library/curses.rst:820

msgid "*br*"

msgstr "*br*"

#: ../../library/curses.rst:820

msgid "Bottom-right corner"

msgstr ""

#: ../../library/curses.rst:820

msgid ":const:`ACS_LRCORNER`"

msgstr ":const:`ACS_LRCORNER`"

#: ../../library/curses.rst:826

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 ""

#: ../../library/curses.rst:835

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 ""

#: ../../library/curses.rst:845

msgid ""

"Like :meth:`erase`, but also cause the whole window to be repainted upon "

"next call to :meth:`refresh`."