import locale
locale.setlocale(locale.LC_ALL, '')
code = locale.getpreferredencoding()

15.11.1. Функции¶Functions

Модуль curses определяет следующее исключение:

exception curses.error¶

Исключение, возникающее, когда функция библиотеки curses возвращает ошибку.

Модуль curses определяет следующие функции:

curses.baudrate()¶

Возвращает скорость вывода терминала в битах в секунду. На программных терминальных эмуляторах она будет иметь фиксированное высокое значение. Включена по историческим причинам; в прежние времена она использовалась для написания циклов вывода с временными задержками и иногда для изменения интерфейсов в зависимости от скорости линии.

curses.beep()¶

Издаёт короткий звуковой сигнал.

curses.can_change_color()¶

Возвращает True или False в зависимости от того, может ли программа изменять цвета, отображаемые терминалом.

curses.cbreak()¶

Включает режим cbreak. В режиме cbreak (иногда называемом режимом «rare») обычная построчная буферизация tty отключается и символы становятся доступными для посимвольного чтения. Однако, в отличие от raw-режима, специальные символы (прерывание, завершение, приостановка и управление потоком) сохраняют своё действие на драйвер tty и вызывающую программу. Вызов сначала raw(), а затем cbreak() оставляет терминал в режиме cbreak.

curses.color_content(color_number)¶

Возвращает интенсивность красного, зелёного и синего (RGB) компонентов цвета color_number, который должен быть в диапазоне от 0 до COLORS. Возвращается кортеж из трёх элементов, содержащий значения R, G, B для указанного цвета, которые будут в диапазоне от 0 (нет компонента) до 1000 (максимальное значение компонента).

curses.color_pair(color_number)¶

Возвращает значение атрибута для отображения текста указанным цветом. Это значение атрибута можно комбинировать с A_STANDOUT, A_REVERSE и другими атрибутами A_*. pair_number() является аналогом этой функции.

curses.curs_set(visibility)¶

Устанавливает состояние курсора. visibility может быть установлено в 0, 1 или 2 для невидимого, нормального или очень видимого режима. Если терминал поддерживает запрошенную видимость, возвращается предыдущее состояние курсора; в противном случае вызывается исключение. На многих терминалах режим «visible» – это подчёркнутый курсор, а режим «very visible» – блочный курсор.

curses.def_prog_mode()¶

Сохраняет текущий режим терминала как режим «program» – режим, когда запущенная программа использует curses. (Его аналог – режим «shell», для времени, когда программа не в curses.) Последующие вызовы reset_prog_mode() восстановят этот режим.

curses.def_shell_mode()¶

Сохраняет текущий режим терминала как режим «shell» – режим, когда запущенная программа не использует curses. (Его аналог – режим «program», когда программа использует возможности curses.) Последующие вызовы reset_shell_mode() восстановят этот режим.

curses.delay_output(ms)¶

Вставляет паузу в вывод на ms миллисекунд.

curses.doupdate()¶

Обновляет физический экран. Библиотека curses хранит две структуры данных: одна представляет текущее содержимое физического экрана, а виртуальный экран – желаемое следующее состояние. Функция doupdate() обновляет физический экран, чтобы он соответствовал виртуальному.

Виртуальный экран можно обновить вызовом noutrefresh() после выполнения операций записи, таких как addstr(), над окном. Обычный вызов refresh() – это просто noutrefresh(), за которым следует doupdate(); если нужно обновить несколько окон, можно ускорить работу и, возможно, уменьшить мерцание экрана, выполнив вызовы noutrefresh() для всех окон, а затем один вызов doupdate().

curses.echo()¶

Включает режим эхоповтора. В режиме эхоповтора каждый введённый символ отображается на экране по мере ввода.

curses.endwin()¶

Деинициализирует библиотеку и возвращает терминал в обычное состояние.

curses.erasechar()¶

Возвращает текущий символ стирания пользователя. В операционных системах Unix это свойство управляющего tty программы curses и не устанавливается самой библиотекой curses.

curses.filter()¶

Процедура filter(), если используется, должна быть вызвана до вызова initscr(). Эффект заключается в том, что во время этих вызовов LINES устанавливается в 1; возможности clear, cup, cud, cud1, cuu1, cuu, vpa отключаются; а строка home устанавливается в значение cr. В результате курсор ограничен текущей строкой, и обновления экрана тоже. Это может быть использовано для посимвольного редактирования строки без затрагивания остального экрана.

curses.flash()¶

Мигает экраном. То есть переключает его в инверсный режим, а затем обратно через короткий интервал. Некоторые люди предпочитают такой «видимый звонок» звуковому сигналу внимания, который воспроизводит beep().

curses.flushinp()¶

Очищает все входные буферы. Отбрасывает любой упреждающий ввод, который был набран пользователем, но ещё не обработан программой.

curses.getmouse()¶

После того как getch() возвращает KEY_MOUSE, сигнализируя о событии мыши, этот метод должен быть вызван для получения поставленного в очередь события мыши, представленного в виде 5-кортежа (id, x, y, z, bstate). id – это значение идентификатора, используемое для различения нескольких устройств, а x, y, z – координаты события. (z в настоящее время не используется.) bstate – целочисленное значение, биты которого установлены для указания типа события, и оно будет представлять собой побитовое ИЛИ одной или нескольких следующих констант, где n – номер кнопки от 1 до 4: BUTTONn_PRESSED, BUTTONn_RELEASED, BUTTONn_CLICKED, BUTTONn_DOUBLE_CLICKED, BUTTONn_TRIPLE_CLICKED, BUTTON_SHIFT, BUTTON_CTRL, BUTTON_ALT.

curses.getsyx()¶

Возвращает текущие координаты виртуального курсора экрана по y и x. Если leaveok в данный момент истинно, возвращается -1,-1.

curses.getwin(file)¶

Читает данные окна, сохранённые в файле более ранним вызовом putwin(). Затем процедура создаёт и инициализирует новое окно с использованием этих данных, возвращая новый объект окна.

curses.has_colors()¶

Возвращает True, если терминал может отображать цвета; в противном случае возвращает False.

curses.has_ic()¶

Возвращает True, если терминал имеет возможности вставки и удаления символов. Эта функция включена только по историческим причинам, так как все современные программные эмуляторы терминалов обладают такими возможностями.

curses.has_il()¶

Возвращает True, если терминал имеет возможности вставки и удаления строк или может имитировать их с помощью областей прокрутки. Эта функция включена только по историческим причинам, так как все современные программные эмуляторы терминалов обладают такими возможностями.

curses.has_key(ch)¶

Принимает значение ключа ch и возвращает True, если текущий тип терминала распознаёт ключ с таким значением.

curses.halfdelay(tenths)¶

Используется для полузадержанного режима, который похож на режим cbreak тем, что символы, вводимые пользователем, немедленно становятся доступными программе. Однако после блокировки на tenths десятых долей секунды возникает исключение, если ничего не было введено. Значение tenths должно быть числом между 1 и 255. Используйте nocbreak() для выхода из полузадержанного режима.

curses.init_color(color_number, r, g, b)¶

Изменяет определение цвета, принимая номер изменяемого цвета, за которым следуют три значения RGB (для количества красной, зелёной и синей составляющих). Значение color_number должно быть между 0 и COLORS. Каждое из r, g, b должно быть значением между 0 и 1000. Когда используется init_color(), все вхождения этого цвета на экране немедленно изменяются на новое определение. Эта функция ничего не делает на большинстве терминалов; она активна только если can_change_color() возвращает 1.

curses.init_pair(pair_number, fg, bg)¶

Изменяет определение цветовой пары. Требует три аргумента: номер изменяемой цветовой пары, номер цвета переднего плана и номер цвета фона. Значение pair_number должно быть между 1 и COLOR_PAIRS - 1 (цветовая пара 0 жёстко задана как белый на чёрном и не может быть изменена). Значения аргументов fg и bg должны быть между 0 и COLORS. Если цветовая пара была предварительно инициализирована, экран обновляется и все вхождения этой цветовой пары изменяются на новое определение.

curses.initscr()¶

Инициализирует библиотеку. Возвращает WindowObject, представляющий весь экран.

Примечание

Если при открытии терминала возникает ошибка, базовая библиотека curses может вызвать завершение интерпретатора.

curses.is_term_resized(nlines, ncols)¶

Возвращает True, если resize_term() изменит структуру окна, в противном случае – False.

curses.isendwin()¶

Возвращает True, если функция endwin() была вызвана (то есть библиотека curses была деинициализирована).

curses.keyname(k)¶

Возвращает имя клавиши с номером k. Имя клавиши, генерирующей печатный символ ASCII, совпадает с этим символом. Имя управляющей комбинации клавиш – это строка из двух символов: знак ^, за которым следует соответствующий печатный символ ASCII. Имя комбинации с клавишей Alt (128–255) – это строка с префиксом «M-», за которым следует имя соответствующего символа ASCII.

curses.killchar()¶

Возвращает текущий символ удаления строки пользователя. В операционных системах Unix это свойство управляющего tty программы curses и не устанавливается самой библиотекой curses.

curses.longname()¶

Возвращает строку, содержащую поле длинного имени terminfo, описывающее текущий терминал. Максимальная длина подробного описания – 128 символов. Оно определено только после вызова initscr().

curses.meta(yes)¶

Если yes равно 1, разрешает ввод 8-битных символов. Если yes равно 0, разрешает только 7-битные символы.

curses.mouseinterval(interval)¶

Устанавливает максимальное время в миллисекундах, которое может пройти между событиями нажатия и отпускания, чтобы они были распознаны как щелчок, и возвращает предыдущее значение интервала. Значение по умолчанию – 200 мс, то есть одна пятая секунды.

curses.mousemask(mousemask)¶

Устанавливает, какие события мыши должны сообщаться, и возвращает кортеж (availmask, oldmask). availmask указывает, какие из указанных событий мыши могут быть сообщены; в случае полного отказа возвращается 0. oldmask – предыдущее значение маски событий мыши для данного окна. Если эта функция никогда не вызывается, события мыши не сообщаются.

curses.napms(ms)¶

Приостанавливает выполнение на ms миллисекунд.

curses.newpad(nlines, ncols)¶

Создаёт и возвращает указатель на новую структуру данных pad с указанным количеством строк и столбцов. Pad возвращается как объект окна.

Pad напоминает окно, но не ограничен размером экрана и не обязательно связан с определённой частью экрана. Pad можно использовать, когда требуется большое окно, а на экране в каждый момент видна только его часть. Автоматическое обновление pad (например, при прокрутке или эхо-вводе) не происходит. Методы refresh() и noutrefresh() pad требуют 6 аргументов для указания отображаемой области pad и места на экране для её отображения. Аргументы: pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol; аргументы с p относятся к верхнему левому углу отображаемой области pad и аргументы с s определяют ограничивающий прямоугольник на экране, в пределах которого область pad будет отображаться.

curses.newwin(begin_y, begin_x)¶

curses.newwin(nlines, ncols, begin_y, begin_x)

Возвращает новое окно, левый верхний угол которого находится в (begin_y, begin_x), а его высота/ширина равна nlines/ncols.

По умолчанию окно будет расширяться от указанной позиции до нижнего правого угла экрана.

curses.nl()¶

Включает режим перевода строки. В этом режиме клавиша возврата каретки преобразуется в перевод строки при вводе, а перевод строки преобразуется в возврат каретки и перевод строки при выводе. Режим перевода строки изначально включен.

curses.nocbreak()¶

Выходит из режима cbreak. Возвращается к обычному «cooked»-режиму с буферизацией строк.

curses.noecho()¶

Выходит из режима эхопечати. Эхо-вывод вводимых символов отключается.

curses.nonl()¶

Выходит из режима новой строки. Отключает преобразование возврата каретки в новую строку при вводе и oтключает низкоуровневое преобразование новой строки в новую строку/возврат каретки при выводе (но это не меняет поведение addch('\n'), которая всегда выполняет eквивалент возврата каретки и перевода строки на виртуальном экране). При отключённом преобразовании curses иногда может немного ускорить вертикальное перемещение; кроме того, он сможет обнаруживать нажатие клавиши возврата каретки при вводе.

curses.noqiflush()¶

При использовании процедуры noqiflush() обычная очистка очередей ввода и вывода, связанных с символами INTR, QUIT и SUSP, не производится. Возможно, вы захотите вызвать noqiflush() в обработчике сигнала, если хотите, чтобы вывод продолжался, как если бы прерывание не произошло, после завершения обработчика.

curses.noraw()¶

Выходит из режима raw. Возвращается к обычному «cooked»-режиму с буферизацией строк.

curses.pair_content(pair_number)¶

Возвращает кортеж (fg, bg), содержащий цвета для запрошенной цветовой пары. Значение pair_number должно быть между 1 и COLOR_PAIRS - 1.

curses.pair_number(attr)¶

Возвращает номер цветовой пары, заданной значением атрибута attr. color_pair() является аналогом этой функции.

curses.putp(string)¶

Эквивалентно tputs(str, 1, putchar); выводит значение указанной возможности terminfo для текущего терминала. Обратите внимание, что вывод putp() всегда направляется в стандартный вывод.

curses.qiflush([flag])¶

Если flag равен False, эффект аналогичен вызову noqiflush(). Если flag равен True или аргумент не указан, очереди будут сброшены при чтении этих управляющих символов.

curses.raw()¶

Переход в необработанный режим. В необработанном режиме отключаются обычная буферизация строк и обработка клавиш прерывания, выхода, приостановки и управления потоком; символы передаются функциям ввода curses по одному.

curses.reset_prog_mode()¶

Восстанавливает терминал в «программный» режим, как было сохранено ранее с помощью def_prog_mode().

curses.reset_shell_mode()¶

Восстанавливает терминал в «оболочечный» режим, как было сохранено ранее с помощью def_shell_mode().

curses.resetty()¶

Восстанавливает состояние режимов терминала до того, каким оно было при последнем вызове savetty().

curses.resize_term(nlines, ncols)¶

Внутренняя функция, используемая resizeterm(), выполняющая большую часть работы; при изменении размера окон resize_term() заполняет пробелами расширяемые области. Вызывающая программа должна заполнить эти области соответствующими данными. Функция resize_term() пытается изменить размер всех окон. Однако из-за соглашения о вызовах для панелей изменить их размер без дополнительного взаимодействия с приложением невозможно.

curses.resizeterm(nlines, ncols)¶

Изменяет размеры стандартного и текущего окон до указанных размеров и корректирует другие служебные данные, используемые библиотекой curses для записи размеров окон (в частности, обработчик SIGWINCH).

curses.savetty()¶

Сохраняет текущее состояние режимов терминала в буфере, который может быть использован resetty().

curses.setsyx(y, x)¶

Устанавливает виртуальный курсор экрана в позицию y, x. Если y и x оба равны -1, то устанавливается leaveok.

curses.setupterm([termstr, fd])¶

Инициализирует терминал. termstr – строка, задающая имя терминала; если опущено, будет использовано значение переменной окружения TERM. fd – это файловый дескриптор, на который будут отправлены все последовательности инициализации; если не указан, будет использован файловый дескриптор для sys.stdout.

curses.start_color()¶

Должна быть вызвана, если программист хочет использовать цвета, и до вызова любой другой процедуры управления цветом. Рекомендуется вызывать эту процедуру сразу после initscr().

start_color() инициализирует восемь основных цветов (чёрный, красный, зелёный, жёлтый, синий, пурпурный, голубой и белый), а также две глобальные переменные в модуле curses – COLORS и COLOR_PAIRS, содержащие максимальное количество цветов и цветовых пар, которое поддерживает терминал. Кроме того, она восстанавливает цвета на терминале до значений, которые были при его включении.

curses.termattrs()¶

Возвращает логическое ИЛИ всех видеоатрибутов, поддерживаемых терминалом. Эта\nинформация полезна, когда программа curses требует полного контроля над\nвнешним видом экрана.

curses.termname()¶

Возвращает значение переменной окружения TERM, усечённое до 14 символов.

curses.tigetflag(capname)¶

Возвращает значение логической возможности, соответствующей имени возможности terminfo capname. Значение -1 возвращается, если capname не является логической возможностью, или 0, если она отменена или отсутствует в описании терминала.

curses.tigetnum(capname)¶

Возвращает значение числовой возможности, соответствующей имени возможности terminfo capname. Значение -2 возвращается, если capname не является числовой возможностью, или -1, если она отменена или отсутствует в описании терминала.

curses.tigetstr(capname)¶

Возвращает значение строковой возможности, соответствующей имени возможности terminfo capname. None возвращается, если capname не является строковой возможностью, либо отменена или отсутствует в описании терминала.

curses.tparm(str[, ...])¶

Инстанцирует строку str с переданными параметрами, где str должна быть параметризованной строкой, полученной из базы данных terminfo. Например, tparm(tigetstr("cup"), 5, 3) может дать b'\033[6;4H'; точный результат зависит от типа терминала.

curses.typeahead(fd)¶

Указывает, что файловый дескриптор fd должен использоваться для проверки упреждающего ввода. Если fd равен -1, то проверка упреждающего ввода не выполняется.

Библиотека curses выполняет «оптимизацию прерывания строки» (line-breakout optimization), периодически проверяя упреждающий ввод\nво время обновления экрана. Если ввод обнаружен и поступает с tty,\nтекущее обновление откладывается до следующего вызова refresh или doupdate,\nчто обеспечивает более быстрый ответ на заранее введённые команды. Эта функция\nпозволяет указать другой файловый дескриптор для проверки упреждающего ввода.

curses.unctrl(ch)¶

Возвращает строку, которая является печатным представлением символа ch. Управляющие символы отображаются как символ каретки, за которым следует символ, например, как ^C. Печатные символы остаются без изменений.

curses.ungetch(ch)¶

Помещает ch в очередь, чтобы следующий вызов getch() вернул его.

Примечание

Только один ch может быть помещён до вызова getch().

curses.ungetmouse(id, x, y, z, bstate)¶

Помещает событие KEY_MOUSE во входную очередь, связывая с ним переданные данные состояния.

curses.use_env(flag)¶

Если используется, эту функцию следует вызывать до вызова initscr() или newterm. Когда flag равен False, будут использоваться значения строк и столбцов, указанные в базе данных terminfo, даже если установлены переменные окружения LINES и COLUMNS (используемые по умолчанию), или если curses выполняется в окне (в этом случае поведение по умолчанию – использовать размер окна, если LINES и COLUMNS не заданы).

curses.use_default_colors()¶

Разрешает использование значений по умолчанию для цветов на терминалах, поддерживающих эту возможность. Это позволяет поддерживать прозрачность в приложении. Цвет по умолчанию назначается номеру цвета -1. После вызова этой функции init_pair(x, curses.COLOR_RED, -1) инициализирует, например, цветовую пару x с красным цветом переднего плана на фоне по умолчанию.

curses.wrapper(func, ...)¶

Инициализирует curses и вызывает другой вызываемый объект func, который должен быть остальной частью вашего приложения, использующего curses. Если приложение вызывает исключение, эта функция восстановит терминал в нормальное состояние перед повторным возбуждением исключения и генерацией трассировки. Вызываемому объекту func затем передаётся главное окно 'stdscr' в качестве первого аргумента, за которым следуют любые другие аргументы, переданные в wrapper(). Перед вызовом func, wrapper() включает режим cbreak, отключает эхо, включает клавиатуру терминала и инициализирует цвета, если терминал поддерживает цвет. При выходе (как нормальном, так и по исключению) она восстанавливает cooked-режим, включает эхо и отключает клавиатуру терминала.

15.11.2. Объекты окон¶Window Objects

Объекты окон, возвращаемые initscr() и newwin() выше, имеют следующие методы:

window.addch(ch[, attr])¶

window.addch(y, x, ch[, attr])

Примечание

Под character понимается символ C (код ASCII), а не символ Python (строка длины 1). (Это замечание верно везде, где в документации упоминается символ.) Встроенная функция ord() удобна для преобразования строк в коды.

Рисует символ ch в позиции (y, x) с атрибутами attr, перезаписывая любой символ, ранее нарисованный в этой позиции. По умолчанию позиция символа и атрибуты берутся из текущих настроек объекта окна.

window.addnstr(str, n[, attr])¶

window.addnstr(y, x, str, n[, attr])

Рисует не более n символов строки str в позиции (y, x) с атрибутами attr, перезаписывая всё, что было на экране ранее.

window.addstr(str[, attr])¶

window.addstr(y, x, str[, attr])

Рисует строку str в позиции (y, x) с атрибутами attr, перезаписывая всё, что было на экране ранее.

window.attroff(attr)¶

Удаляет атрибут attr из набора «фоновых» атрибутов, применяемых ко всем записям в текущее окно.

window.attron(attr)¶

Добавить атрибут attr из набора «фоновых» атрибутов, применяемых ко всем записям в текущее окно.

window.attrset(attr)¶

Устанавливает «фоновый» набор атрибутов в attr. Изначально этот набор равен 0 (нет атрибутов).

window.bkgd(ch[, attr])¶

Устанавливает фоновое свойство окна на символ ch с атрибутами attr. Затем изменение применяется ко всем позициям символов в этом окне:

• Атрибут каждого символа в окне изменяется на новый фоновый атрибут.
• Везде, где встречается прежний фоновый символ, он заменяется на новый фоновый символ.

window.bkgdset(ch[, attr])¶

Устанавливает фон окна. Фон окна состоит из символа и любой комбинации атрибутов. Часть атрибута фона комбинируется (логическим ИЛИ) со всеми непустыми символами, которые записываются в окно. Как символьная, так и атрибутная части фона комбинируются с пустыми символами. Фон становится свойством символа и перемещается вместе с символом при любых операциях прокрутки, вставки/удаления строк/символов.

window.border([ls[, rs[, ts[, bs[, tl[, tr[, bl[, br]]]]]]]])¶

Рисует рамку по краям окна. Каждый параметр задаёт символ для определённой части рамки; подробнее см. таблицу ниже. Символы могут быть заданы как целые числа или как строки из одного символа.

Примечание

Значение 0 для любого параметра приводит к использованию символа по умолчанию для этого параметра. Именованные параметры могут не быть использованы. Значения по умолчанию перечислены в этой таблице:

Параметр	Описание	Значение по умолчанию
ls	Левая сторона	ACS_VLINE
rs	Правая сторона	ACS_VLINE
ts	Верх	ACS_HLINE
bs	Низ	ACS_HLINE
tl	Верхний левый угол	ACS_ULCORNER
tr	Верхний правый угол	ACS_URCORNER
bl	Нижний левый угол	ACS_LLCORNER
br	Нижний правый угол	ACS_LRCORNER

window.box([vertch, horch])¶

Аналогична border(), но оба параметра ls и rs задаются vertch, а ts и bs – horch. Эта функция всегда использует символы углов по умолчанию.

window.chgat(attr)¶

window.chgat(num, attr)

window.chgat(y, x, attr)

window.chgat(y, x, num, attr)

Устанавливает атрибуты num символов на текущей позиции курсора или, если задана, на позиции (y, x). Если значение num не указано или num = -1, атрибут будет установлен для всех символов до конца строки. Эта функция не перемещает курсор. Изменённая строка помечается с помощью метода touchline(), чтобы её содержимое было перерисовано при следующем обновлении окна.

window.clear()¶

Как erase(), но также вызывает перерисовку всего окна при следующем вызове refresh().

window.clearok(yes)¶

Если yes равно 1, следующий вызов refresh() полностью очистит окно.

window.clrtobot()¶

Стирает от курсора до конца окна: все строки ниже курсора удаляются, а затем выполняется действие, эквивалентное clrtoeol().

window.clrtoeol()¶

Стирает от курсора до конца строки.

window.cursyncup()¶

Обновляет текущую позицию курсора всех родительских окон, чтобы она отражала текущую позицию курсора данного окна.

window.delch([y, x])¶

Удаляет символ на позиции (y, x).

window.deleteln()¶

Удаляет строку под курсором. Все последующие строки сдвигаются вверх на одну.

window.derwin(begin_y, begin_x)¶

window.derwin(nlines, ncols, begin_y, begin_x)

Аббревиатура от «derive window» (производное окно), derwin() аналогична вызову subwin(), за исключением того, что begin_y и begin_x задаются относительно начала окна, а не всего экрана. Возвращает объект окна для производного окна.

window.echochar(ch[, attr])¶

Добавляет символ ch с атрибутом attr и сразу же вызывает refresh() для окна.

window.enclose(y, x)¶

Проверяет, принадлежат ли заданные координаты символьной ячейки (относительно экрана) данному окну. Возвращает True или False. Полезно для определения того, какие окна экрана содержат позицию события мыши.

window.erase()¶

Очищает окно.

window.getbegyx()¶

Возвращает кортеж (y, x) координат верхнего левого угла.

window.getbkgd()¶

Возвращает текущую пару символ/атрибут фона для указанного окна.

window.getch([y, x])¶

Возвращает символ. Обратите внимание: возвращаемое целое число не обязательно должно быть в диапазоне ASCII: функциональные клавиши, клавиши цифровой клавиатуры и тому подобное возвращают числа больше 256. В режиме без задержки возвращается -1, если нет ввода, иначе getch() ожидает нажатия клавиши.

window.getkey([y, x])¶

Получает символ, возвращая строку вместо целого числа, как getch() делает. Функциональные клавиши, клавиши цифровой клавиатуры и тому подобное возвращают многобайтовую строку, содержащую имя клавиши. В режиме без задержки при отсутствии ввода генерируется исключение.

window.getmaxyx()¶

Возвращает кортеж (y, x) высоты и ширины окна.

window.getparyx()¶

Возвращает начальные координаты этого окна относительно его родительского окна в две целые переменные y и x. Возвращает -1, -1, если это окно не имеет родителя.

window.getstr([y, x])¶

Читает строку от пользователя, с примитивной возможностью редактирования строки.

window.getyx()¶

Возвращает кортеж (y, x) текущей позиции курсора относительно верхнего левого угла окна.

window.hline(ch, n)¶

window.hline(y, x, ch, n)

Отображает горизонтальную линию, начинающуюся в точке (y, x), длиной n, состоящую из символа ch.

window.idcok(flag)¶

Если flag равен False, curses больше не использует аппаратную функцию вставки/удаления символов терминала; если flag равен True, использование вставки и удаления символов включается. При первой инициализации curses использование вставки/удаления символов включено по умолчанию.

window.idlok(yes)¶

Если вызвать с yes, равным 1, curses попытается использовать аппаратные средства редактирования строк. В противном случае вставка/удаление строк отключены.

window.immedok(flag)¶

Если flag равен True, любое изменение изображения окна автоматически вызывает его обновление; больше не нужно вызывать refresh() самостоятельно. Однако это может существенно снизить производительность из-за многократных вызовов wrefresh. Эта опция по умолчанию отключена.

window.inch([y, x])¶

Возвращает символ в указанной позиции окна. Младшие 8 бит – это сам символ, а старшие биты – атрибуты.

window.insch(ch[, attr])¶

window.insch(y, x, ch[, attr])

Рисует символ ch в точке (y, x) с атрибутами attr, сдвигая строку от позиции x вправо на один символ.

window.insdelln(nlines)¶

Вставляет nlines строк в указанное окно над текущей строкой. nlines нижних строк теряются. При отрицательном nlines удаляет nlines строк, начиная с той, на которой находится курсор, и сдвигает оставшиеся строки вверх. Нижние nlines строк очищаются. Текущая позиция курсора остаётся неизменной.

window.insertln()¶

Вставляет пустую строку под курсором. Все последующие строки сдвигаются на одну строку вниз.

window.insnstr(str, n[, attr])¶

window.insnstr(y, x, str, n[, attr])

Вставляет строку символов (столько символов, сколько помещается на строке) перед символом под курсором, до n символов. Если n равно нулю или отрицательно, вставляется вся строка. Все символы справа от курсора сдвигаются вправо, при этом крайние правые символы строки теряются. Позиция курсора не меняется (после перемещения в y, x, если указано).

window.insstr(str[, attr])¶

window.insstr(y, x, str[, attr])

Вставляет строку символов (столько символов, сколько помещается на строке) перед символом под курсором. Все символы справа от курсора сдвигаются вправо, при этом крайние правые символы строки теряются. Позиция курсора не меняется (после перемещения в y, x, если указано).

window.instr([n])¶

window.instr(y, x[, n])

Возвращает строку символов, извлечённую из окна, начиная с текущей позиции курсора или с y, x, если указано. Атрибуты символов удаляются. Если указан n, instr() возвращает строку длиной не более n символов (без учёта завершающего нулевого символа).

window.is_linetouched(line)¶

Возвращает True, если указанная строка была изменена после последнего вызова refresh(); иначе возвращает False. Возбуждает исключение curses.error, если line недопустима для данного окна.

window.is_wintouched()¶

Возвращает True, если указанное окно было изменено после последнего вызова refresh(); иначе возвращает False.

window.keypad(yes)¶

Если yes равно 1, управляющие последовательности, генерируемые некоторыми клавишами (цифровая клавиатура, функциональные клавиши), будут интерпретироваться curses. Если yes равно 0, управляющие последовательности остаются как есть во входном потоке.

window.leaveok(yes)¶

Если yes равно 1, курсор остаётся на месте при обновлении, а не перемещается в «позицию курсора». Это уменьшает перемещение курсора, где это возможно. Если возможно, курсор будет сделан невидимым.

Если yes равно 0, курсор всегда будет находиться в «позиции курсора» после обновления.

window.move(new_y, new_x)¶

Перемещает курсор в (new_y, new_x).

window.mvderwin(y, x)¶

Перемещает окно внутри его родительского окна. Экранно-относительные параметры окна не изменяются. Эта процедура используется для отображения разных частей родительского окна в одной и той же физической позиции на экране.

window.mvwin(new_y, new_x)¶

Перемещает окно так, чтобы его левый верхний угол находился в (new_y, new_x).

window.nodelay(yes)¶

Если yes равно 1, getch() будет неблокирующим.

window.notimeout(yes)¶

Если yes равно 1, управляющие последовательности не будут подвергаться таймауту.

Если yes равно 0, через несколько миллисекунд управляющая последовательность не будет интерпретироваться и останется во входном потоке как есть.

window.noutrefresh()¶

Помечает для обновления, но ждёт. Эта функция обновляет структуру данных, представляющую желаемое состояние окна, но не принуждает к обновлению физического экрана. Для этого вызовите doupdate().

window.overlay(destwin[, sminrow, smincol, dminrow, dmincol, dmaxrow, dmaxcol])¶

Наложить окно поверх destwin. Окна необязательно должны быть одного размера – копируется только область пересечения. Это копирование неразрушающее, то есть текущий символ фона не перезаписывает старое содержимое destwin.

Для точного контроля над копируемой областью можно использовать вторую форму overlay(). sminrow и smincol – это координаты левого верхнего угла исходного окна, а остальные переменные задают прямоугольник в целевом окне.

window.overwrite(destwin[, sminrow, smincol, dminrow, dmincol, dmaxrow, dmaxcol])¶

Перезаписать окно поверх destwin. Окна необязательно должны быть одного размера – в этом случае копируется только область пересечения. Это копирование разрушающее, то есть текущий символ фона перезаписывает старое содержимое destwin.

Для точного контроля над копируемой областью можно использовать вторую форму overwrite(). sminrow и smincol – это координаты левого верхнего угла исходного окна, а остальные переменные задают прямоугольник в целевом окне.

window.putwin(file)¶

Записывает все данные, связанные с окном, в переданный файловый объект. Эту информацию можно позднее получить с помощью функции getwin().

window.redrawln(beg, num)¶

Указывает, что num строк экрана, начиная со строки beg, повреждены и должны быть полностью перерисованы при следующем вызове refresh().

window.redrawwin()¶

Помечает всё окно как изменённое, что приводит к его полной перерисовке при следующем вызове refresh().

window.refresh([pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol])¶

Обновить отображение немедленно (синхронизировать фактический экран с предыдущими методами рисования/удаления).

6 необязательных аргументов можно указывать только когда окно является pad'ом, созданным с помощью newpad(). Дополнительные параметры нужны, чтобы указать, какая часть pad'а и экрана задействована. pminrow и pmincol задают верхний левый угол прямоугольника, отображаемого в pad'е. sminrow, smincol, smaxrow и smaxcol задают границы прямоугольника, отображаемого на экране. Нижний правый угол прямоугольника, отображаемого в pad'е, вычисляется из координат экрана, поскольку прямоугольники должны быть одного размера. Оба прямоугольника должны полностью помещаться в своих структурах. Отрицательные значения pminrow, pmincol, sminrow или smincol считаются равными нулю.

window.resize(nlines, ncols)¶

Перераспределяет память для окна curses, изменяя его размеры в соответствии с указанными значениями. Если хотя бы один из размеров больше текущего, данные окна заполняются пробелами, в которые внесено текущее оформление фона (заданное с помощью bkgdset()).

window.scroll([lines=1])¶

Прокручивает экран или область прокрутки вверх на lines строк.

window.scrollok(flag)¶

Управляет тем, что происходит, когда курсор окна выходит за край окна или области прокрутки, либо в результате перевода строки на последней строке, либо при вводе последнего символа последней строки. Если flag равен false, курсор остаётся на последней строке. Если flag равен true, окно прокручивается на одну строку вверх. Обратите внимание, что для получения физического эффекта прокрутки на терминале также необходимо вызвать idlok().

window.setscrreg(top, bottom)¶

Установить область прокрутки от строки top до строки bottom. Все действия прокрутки будут происходить в этой области.

window.standend()¶

Выключить атрибут выделения (standout). На некоторых терминалах это имеет побочный эффект выключения всех атрибутов.

window.standout()¶

Включить атрибут A_STANDOUT.

window.subpad(begin_y, begin_x)¶

window.subpad(nlines, ncols, begin_y, begin_x)

Возвращает подокно, левый верхний угол которого находится в (begin_y, begin_x), а ширина/высота равны ncols/nlines.

window.subwin(begin_y, begin_x)¶

window.subwin(nlines, ncols, begin_y, begin_x)

Возвращает подокно, левый верхний угол которого находится в (begin_y, begin_x), а ширина/высота равны ncols/nlines.

По умолчанию подокно будет простираться от указанной позиции до нижнего правого угла окна.

window.syncdown()¶

Помечает каждую позицию в окне, которая была помечена в любом из его родительских окон. Эта процедура вызывается функцией refresh(), так что почти никогда не требуется вызывать её вручную.

window.syncok(flag)¶

Если вызвана с flag, установленным в True, то syncup() вызывается автоматически при каждом изменении в окне.

window.syncup()¶

Помечает все позиции в родительских окнах данного окна, которые были изменены в окне.

window.timeout(delay)¶

Устанавливает блокирующее или неблокирующее поведение чтения для окна. Если delay отрицателен, используется блокирующее чтение (которое будет ожидать ввода неопределённо долго). Если delay равен нулю, используется неблокирующее чтение, и getch() вернёт -1, если нет ожидающего ввода. Если delay положителен, то getch() будет блокироваться на delay миллисекунд и вернёт -1, если за это время ввод так и не поступил.

window.touchline(start, count[, changed])¶

Сообщает, что count строк были изменены, начиная со строки start. Если передан параметр changed, он указывает, помечены ли затронутые строки как изменённые (changed=1) или неизменённые (changed=0).

window.touchwin()¶

Считает, что всё окно было изменено, в целях оптимизации отрисовки.

window.untouchwin()¶

Помечает все строки в окне как неизменённые с момента последнего вызова refresh().

window.vline(ch, n)¶

window.vline(y, x, ch, n)

Отображает вертикальную линию, начинающуюся в (y, x), длиной n, состоящую из символа ch.

15.11.3. Константы¶Constants

Модуль curses определяет следующие элементы данных:

curses.ERR¶

Некоторые процедуры curses, возвращающие целое число, например getch(), в случае неудачи возвращают ERR.

curses.OK¶

Некоторые процедуры curses, возвращающие целое число, например napms(), в случае успеха возвращают OK.

curses.version¶

Строка, представляющая текущую версию модуля. Также доступно как __version__.

Доступно несколько констант для задания атрибутов символьных ячеек:

Атрибут	Значение
A_ALTCHARSET	Режим альтернативной кодировки знаков.
A_BLINK	Режим мерцания.
A_BOLD	Режим полужирного начертания.
A_DIM	Режим тусклого свечения.
A_NORMAL	Обычный атрибут.
A_REVERSE	Обратный (инверсный) режим для цветов фона и текста.
A_STANDOUT	Режим выделения.
A_UNDERLINE	Режим подчёркивания.

На клавиши ссылаются целочисленные константы с именами, начинающимися с KEY_. Точный набор доступных клавиш зависит от системы.

Константа клавиши	Клавиша
KEY_MIN	Минимальное значение клавиши
KEY_BREAK	Клавиша Break (ненадёжно)
KEY_DOWN	Стрелка вниз
KEY_UP	Стрелка вверх
KEY_LEFT	Стрелка влево
KEY_RIGHT	Стрелка вправо
KEY_HOME	Клавиша Home (стрелка вверх-влево)
KEY_BACKSPACE	Backspace (ненадёжно)
KEY_F0	Функциональные клавиши. Поддерживается до 64 функциональных клавиш.
KEY_Fn	Значение функциональной клавиши n
KEY_DL	Удалить строку
KEY_IL	Вставить строку
KEY_DC	Удалить символ
KEY_IC	Вставить символ или войти в режим вставки
KEY_EIC	Выйти из режима вставки символа
KEY_CLEAR	Очистить экран
KEY_EOS	Очистить до конца экрана
KEY_EOL	Очистить до конца строки
KEY_SF	Прокрутить на 1 строку вперёд
KEY_SR	Прокрутка на 1 строку назад (обратное направление)
KEY_NPAGE	Следующая страница
KEY_PPAGE	Предыдущая страница
KEY_STAB	Установить табуляцию
KEY_CTAB	Очистить табуляцию
KEY_CATAB	Очистить все табуляции
KEY_ENTER	Ввод или отправка (ненадёжно)
KEY_SRESET	Мягкий (частичный) сброс (ненадёжно)
KEY_RESET	Сброс или жёсткий сброс (ненадёжно)
KEY_PRINT	Печать
KEY_LL	Домой вниз или нижняя строка (левый нижний)
KEY_A1	Верхний левый угол клавиатуры
KEY_A3	Верхний правый угол клавиатуры
KEY_B2	Центр клавиатуры
KEY_C1	Нижний левый угол клавиатуры
KEY_C3	Нижний правый угол клавиатуры
KEY_BTAB	Обратная табуляция
KEY_BEG	Начало
KEY_CANCEL	Отмена
KEY_CLOSE	Закрыть
KEY_COMMAND	Команда
KEY_COPY	Копировать
KEY_CREATE	Создать
KEY_END	Конец
KEY_EXIT	Выход
KEY_FIND	Найти
KEY_HELP	Помощь
KEY_MARK	Отметка
KEY_MESSAGE	Сообщение
KEY_MOVE	Переместить
KEY_NEXT	Далее
KEY_OPEN	Открыть
KEY_OPTIONS	Параметры
KEY_PREVIOUS	Назад (предыдущий)
KEY_REDO	Повторить
KEY_REFERENCE	Справка (ссылка)
KEY_REFRESH	Обновить
KEY_REPLACE	Заменить
KEY_RESTART	Перезапустить
KEY_RESUME	Возобновить
KEY_SAVE	Сохранить
KEY_SBEG	Shift+Начало (начало)
KEY_SCANCEL	Shift+Отмена
KEY_SCOMMAND	Shift+Команда
KEY_SCOPY	Shift+Копировать
KEY_SCREATE	Shift+Создать
KEY_SDC	Shift+Удалить символ
KEY_SDL	Shift+Удалить строку
KEY_SELECT	Выбор
KEY_SEND	Shift+Конец
KEY_SEOL	Shift+Очистка строки
KEY_SEXIT	Сдвинутый Dxit
KEY_SFIND	Shift+Найти
KEY_SHELP	Shift+Справка
KEY_SHOME	Shift+Начало
KEY_SIC	Shift+Ввод
KEY_SLEFT	Shift+Стрелка влево
KEY_SMESSAGE	Shift+Сообщение
KEY_SMOVE	Shift+Перемещение
KEY_SNEXT	Shift+Далее
KEY_SOPTIONS	Shift+Параметры
KEY_SPREVIOUS	Shift+Назад
KEY_SPRINT	Shift+Печать
KEY_SREDO	Shift+Повтор
KEY_SREPLACE	Замена с Shift
KEY_SRIGHT	Стрелка вправо с Shift
KEY_SRSUME	Возобновление с Shift
KEY_SSAVE	Сохранение с Shift
KEY_SSUSPEND	Приостановка с Shift
KEY_SUNDO	Отмена с Shift
KEY_SUSPEND	Приостановить
KEY_UNDO	Отменить
KEY_MOUSE	Событие мыши
KEY_RESIZE	Событие изменения размера терминала
KEY_MAX	Максимальное значение клавиши

На VT100 и их программных эмуляциях, таких как эмуляторы терминала X, обычно доступны по меньшей мере четыре функциональные клавиши (KEY_F1, KEY_F2, KEY_F3, KEY_F4), а клавиши со стрелками отображаются на KEY_UP, KEY_DOWN, KEY_LEFT и KEY_RIGHT очевидным образом. Если используется клавиатура PC, можно рассчитывать на клавиши со стрелками и двенадцать функциональных клавиш (на старых клавиатурах PC может быть только десять функциональных клавиш); кроме того, стандартными являются следующие сопоставления цифровой клавиатуры:

Клавиша	Константа
Вставка	KEY_IC
Удаление	KEY_DC
Home	KEY_HOME
End	KEY_END
Page Up	KEY_NPAGE
Page Down	KEY_PPAGE

В следующей таблице перечислены символы из альтернативного набора символов. Они унаследованы от терминала VT100 и обычно доступны в программных эмуляциях, таких как X терминалы. Если графический символ недоступен, curses использует грубое приближение в виде печатных символов ASCII.

Код ACS	Значение
ACS_BBSS	альтернативное имя для правого верхнего угла
ACS_BLOCK	сплошной квадратный блок
ACS_BOARD	доска из квадратов
ACS_BSBS	альтернативное имя для горизонтальной линии
ACS_BSSB	альтернативное имя для левого верхнего угла
ACS_BSSS	альтернативное имя для верхнего тройника
ACS_BTEE	нижний тройник
ACS_BULLET	маркер
ACS_CKBOARD	шахматная доска (точечный узор)
ACS_DARROW	стрелка вниз
ACS_DEGREE	символ градуса
ACS_DIAMOND	ромб
ACS_GEQUAL	больше или равно
ACS_HLINE	горизонтальная линия
ACS_LANTERN	символ фонаря
ACS_LARROW	стрелка влево
ACS_LEQUAL	меньше или равно
ACS_LLCORNER	левый нижний угол
ACS_LRCORNER	правый нижний угол
ACS_LTEE	левый тройник
ACS_NEQUAL	знак не равно
ACS_PI	буква пи
ACS_PLMINUS	плюс-минус
ACS_PLUS	большой плюс
ACS_RARROW	стрелка вправо
ACS_RTEE	правый тройник
ACS_S1	линия развертки 1
ACS_S3	линия развертки 3
ACS_S7	линия развертки 7
ACS_S9	линия развертки 9
ACS_SBBS	альтернативное название правого нижнего угла
ACS_SBSB	другое название вертикальной линии
ACS_SBSS	альтернативное название правого тройника
ACS_SSBB	альтернативное название левого нижнего угла
ACS_SSBS	альтернативное название нижнего тройника
ACS_SSSB	альтернативное название левого тройника
ACS_SSSS	альтернативное название перекрестия или большого плюса
ACS_STERLING	фунт стерлингов
ACS_TTEE	верхний тройник
ACS_UARROW	стрелка вверх
ACS_ULCORNER	левый верхний угол
ACS_URCORNER	правый верхний угол
ACS_VLINE	вертикальная линия

В следующей таблице перечислены предопределённые цвета:

Константа	Цвет
COLOR_BLACK	Чёрный
COLOR_BLUE	Синий
COLOR_CYAN	Голубой (светлый сине-зелёный)
COLOR_GREEN	Зелёный
COLOR_MAGENTA	Пурпурный (красновато-фиолетовый)
COLOR_RED	Красный
COLOR_WHITE	Белый
COLOR_YELLOW	Жёлтый

15.12.1. Объекты Textbox¶Textbox objects

Можно создать экземпляр объекта Textbox следующим образом:

class curses.textpad.Textbox(win)¶

Возвращает объект виджета текстового поля. Аргумент win должен быть объектом WindowObject curses, в котором будет размещено текстовое поле. Курсор редактирования текстового поля изначально находится в верхнем левом углу содержащего окна, с координатами (0, 0). Флаг экземпляра stripspaces изначально включён.

Объекты Textbox имеют следующие методы:

edit([validator])¶

Это основная точка входа, обычно используемая. Она принимает нажатия клавиш редактирования до тех пор, пока не будет введена одна из завершающих комбинаций. Если указан validator, он должен быть функцией. Эта функция будет вызываться для каждого введённого нажатия клавиши, причём эта клавиша передаётся в качестве параметра; диспетчеризация команд выполняется на основе результата. Данный метод возвращает содержимое окна в виде строки; наличие в ней пробелов зависит от атрибута stripspaces.

do_command(ch)¶

Обрабатывает одно нажатие командной клавиши. Ниже перечислены поддерживаемые специальные нажатия клавиш:

Клавиша	Действие
Control-A	Переход к левому краю окна.
Control-B	Курсор влево, с переносом на предыдущую строку (если применимо).
Control-D	Удалить символ под курсором.
Control-E	Перейти к правому краю (stripspaces off) или в конец строки (stripspaces on).
Control-F	Курсор вправо, с переносом на следующую строку (если применимо).
Control-G	Завершить, вернув содержимое окна.
Control-H	Удалить предыдущий символ.
Control-J	Завершает, если окно имеет 1 строку, в противном случае вставляет новую строку.
Control-K	Если строка пуста, удалить её, в противном случае очистить до конца строки.
Control-L	Обновить экран.
Control-N	Курсор вниз; переместиться на одну строку вниз.
Control-O	Вставить пустую строку в позиции курсора.
Control-P	Курсор вверх; переместиться на одну строку вверх.

Операции перемещения не выполняются, если курсор находится у края, где движение невозможно. Там, где это возможно, поддерживаются следующие синонимы:

Константа	Клавиша
KEY_LEFT	Control-B
KEY_RIGHT	Control-F
KEY_UP	Control-P
KEY_DOWN	Control-N
KEY_BACKSPACE	Control-h

Все остальные нажатия клавиш обрабатываются как команда вставить указанный символ и переместиться вправо (с переносом строки).

gather()¶

Возвращает содержимое окна в виде строки; наличие в ней пробелов зависит от атрибута stripspaces.

stripspaces¶

Этот атрибут является флагом, управляющим интерпретацией пробелов в окне. Когда он включён, конечные пробелы в каждой строке игнорируются; любое перемещение курсора, которое привело бы к его установке на конечный пробел, вместо этого перемещает курсор в конец строки, а конечные пробелы удаляются при сборе содержимого окна.