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

15.8.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()¶

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

curses.def_shell_mode()¶

Сохраняет текущий режим терминала как «режим оболочки» – режим, когда работающая программа не использует curses. (Его аналог – «программный» режим, когда программа использует возможности 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 в данный момент равно true, возвращается -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)¶

Используется для режима половинной задержки (half-delay), который похож на режим 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.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([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()¶

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

curses.reset_shell_mode()¶

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

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()¶

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

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) может дать '\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 с красным цветом переднего плана на фоне по умолчанию.

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

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

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

Примечание

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

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

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

Рисует не более n символов строки str в позиции (y, x) с атрибутами 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([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([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.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([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([y, x], ch[, attr])¶

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

window.insdelln(nlines)¶

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

window.insertln()¶

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

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

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

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

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

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

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

window.is_linetouched(line)¶

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

window.is_wintouched()¶

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

window.keypad(yes)¶

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

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.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([nlines, ncols], begin_y, begin_x)¶

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

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([y, x], ch, n)¶

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

15.8.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.9.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¶

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