curses — Manejo de terminales para pantallas de celdas de caracteres


El módulo curses provee una interfaz para la librería curses, el estándar para el manejo avanzado de terminales portátiles.

Mientras que curses es más ampliamente usado en los ambientes Unix, las versiones están disponibles para Windows, DOS, y posiblemente para otros sistemas también. Esta extensión del módulo es diseñada para coincidir con el API de ncurses, una librería de código abierto almacenada en Linux y las variantes BSD de Unix.

Nota

Cuando la documentación menciona un carácter, esto puede ser especificado como un entero, una cadena Unicode de un carácter o una cadena de bytes de un byte.

Cuando la documentación menciona una cadena de caracteres, esto puede ser especificado como una cadena Unicode o una cadena de bytes.

Nota

Desde la versión 5.4, la librería ncurses decide cómo interpretar los datos no ASCII usando la función nl_langinfo. Eso significa que tú tienes que llamar a locate.setlocate() en la aplicación y codificar las cadenas Unicode usando una de las codificaciones disponibles del sistema. Este ejemplo usa la codificación del sistema por defecto:

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

Entonces usa code como la codificación para las llamadas str.encode().

Ver también

Módulo curses.ascii

Utilidades para trabajar con caracteres ASCII, independientemente de tu configuración local.

Módulo curses.panel

Una extensión de la pila de paneles que añade profundidad a las ventanas de curses.

Módulo curses.textpad

Widget de texto editable para apoyar curses Emacs- como enlaces.

Programación de Curses con Python

Material del tutorial usando curses con Python, por Andrew Kuchling y Eric Raymond.

El directorio Tools/demo/ en el recurso de distribución de Python contiene algunos programas de ejemplo usando los enlaces de curses previstos en este módulo.

Funciones

El módulo curses define la siguiente excepción:

exception curses.error

Una excepción se lanza cuando una función de la librería curses retorna un error.

Nota

Cuando los argumentos x o y para una función o un método son opcionales, se predetermina la ubicación actual del cursor. Cuando attr es opcional, por defecto es A_NORMAL.

El módulo curses define las siguientes funciones:

curses.baudrate()

Retorna la velocidad de salida de la terminal en bits por segundo. En emuladores de terminal de software esto tendrá un alto valor fijado. Incluido por razones históricas; en tiempos pasados, esto fue usado para escribir los ciclos de salida por retrasos de tiempo y ocasionalmente para cambiar interfaces dependiendo de la velocidad en la línea.

curses.beep()

Emite un corto sonido de atención.

curses.can_change_color()

Retorna «True» o «False», dependiendo ya sea que el programador puede cambiar los colores presentados por la terminal.

curses.cbreak()

Entra al modo cbreak. En el modo cbreak (a veces llamado modo «raro») del buffer de línea tty normal es apagado y los caracteres están disponibles para ser leídos uno por uno. Sin embargo, a diferencia del modo raw, los caracteres especiales (interrumpir, salir, suspender y control de flujo) retiene sus efectos en el manejador tty y el programa de llamada. Llamando primero raw() luego cbreak() dejando la terminal en modo cbreak.

curses.color_content(color_number)

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

curses.color_pair(pair_number)

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 A_STANDOUT, A_REVERSE, and the other A_* attributes. pair_number() is the counterpart to this function.

curses.curs_set(visibility)

Configura el estado del cursor. visibilidad puede estar configurado para «0», «1» o «2», para invisible, normal o muy visible. Si la terminal soporta la visibilidad requerida, retorna el estado del cursor previo; de otra manera ejecuta una excepción. En muchos terminales, el modo «visible» es un cursor subrayado y el modo «muy visible» es un cursor de bloque.

curses.def_prog_mode()

Guardar el modo del terminal actual como el modo «program», el modo cuando el programa corriendo está usando curses. (Su contraparte es el modo «shell», para cuando el programa no está en curses.) Seguido de la llamada a reset_prog_mode() restaurará este modo.

curses.def_shell_mode()

Guarde el modo de terminal actual como el modo «shell», el modo en el que el programa en ejecución no utiliza curses. (Su contraparte es el modo «program», cuando el programa está usando las capacidades de curses.) Las llamadas subsecuentes a reset_shell_mode() restaurarán este modo.

curses.delay_output(ms)

Inserte una pausa en milisegundo ms en la salida.

curses.doupdate()

Actualiza la pantalla física. La librería curses mantiene dos estructuras de datos, uno representa el contenido de la pantalla física actual y una pantalla virtual representa el próximo estado deseado. La base doupdate() actualiza la pantalla física para comparar la pantalla virtual.

La pantalla virtual puede ser actualizada por una llamada noutrefresh() después de escribir las operaciones tales como addstr() ha sido ejecutada en una ventana. La llamada normal refresh() es simplemente noutrefresh() seguido por doupdate(); si tienes para actualizar múltiples ventanas, puedes aumentar el rendimiento y quizás reducir los parpadeos de la pantalla usando la llamada noutrefresh() en todas las ventanas, seguido por un simple doupdate().

curses.echo()

Entrar en modo echo. En modo echo, cada caracter de entrada es repercutido a la pantalla como este es introducido.

curses.endwin()

Desinicializa la librería y retorne el terminal al estado normal.

curses.erasechar()

Retorne el carácter borrado del usuario actual como un objeto de bytes de un byte. Bajo el sistema de operaciones Unix esta es una propiedad de el controlador tty de el programa curses, y no es configurado por la librería curses en sí misma.

curses.filter()

La rutina filter(), si es usada, debe ser llamada antes que initscr() sea llamada. El efecto es que durante estas llamadas, LINES es configurada para «1»; las capacidades «clear», «cup», «cud», «cud1», «cuu1», «cuu», «vpa» son desactivadas; y la cadena «home» es configurada para el valor de «cr». El efecto es que el cursor es confinado para la línea actual, y también las pantallas son actualizadas. Este puede ser usado para habilitar la línea editando el carácter en un tiempo sin tocar el resto de las pantallas.

curses.flash()

La pantalla Flash. Eso es, cambiar lo a video inverso y luego cambie lo de nuevo en un corto intervalo. Algunas personas prefieren como “campana visible” para la señal de atención audible producida por beep().

curses.flushinp()

Vacíe todos los búferes de entrada. Esto desecha cualquier mecanografiado que ha sido escrito por el usuario y no ha sido aún procesado por el programa.

curses.getmouse()

After getch() returns 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 4: BUTTONn_PRESSED, BUTTONn_RELEASED, BUTTONn_CLICKED, BUTTONn_DOUBLE_CLICKED, BUTTONn_TRIPLE_CLICKED, BUTTON_SHIFT, BUTTON_CTRL, BUTTON_ALT.

curses.getsyx()

Retorna las coordenadas actuales del cursor en la pantalla virtual como una tupla (y, x). Si leaveok es actualmente True entonces retorna (-1,-1).

curses.getwin(file)

Lee la ventana relacionada con los datos almacenados en el archivo por una llamada temprana a putwin(). La rutina entonces crea e inicializa una nueva ventana usando esos datos, retornando el nuevo objeto de ventana.

curses.has_colors()

Retorna «True» si el terminal puede desplegar colores, en caso contrario, retorna «False».

curses.has_ic()

Retorna True si el terminal tiene la capacidad de insertar y eliminar caracteres. Esta función es incluida por razones históricas solamente, ya que todos los emuladores de la terminal de software modernos tienen tales capacidades.

curses.has_il()

Retorna True si la terminal tiene la capacidad de insertar y eliminar caracteres o pueden simularlos usando las regiones de desplazamiento. Esta función es incluida por razones históricas solamente, como todos los emuladores de terminales de software modernos tienen tales capacidades.

curses.has_key(ch)

Toma una clave valor ch, y retorna «True» si el tipo de terminal actual reconoce una clave con ese valor.

curses.halfdelay(tenths)

Usado por el modo de medio retardo, el cual es similar al modo cbreak en que los caracteres escritos por el usuario están disponibles inmediatamente para el programa. Sin embargo, después de bloquearlos por tenths décimas de segundos, se levanta una excepción si nada ha sido escrito. El valor de tenths debe ser un número entre 1 y 255. Use nocbreak() para salir del modo de medio retardo.

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

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 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 can_change_color() returns True.

curses.init_pair(pair_number, fg, bg)

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

curses.initscr()

Inicializa la librería. Retorna un objeto window el cual representa a toda la pantalla.

Nota

Si hay un error al abrir el terminal, la librería curses subyacente puede causar que el interprete salga.

curses.is_term_resized(nlines, ncols)

Retorna «True» si resize_term() modificaría la estructura de la ventana, «False» en caso contrario.

curses.isendwin()

Retorna «True» si endwin() ha sido llamado (eso es que la librería curses ha sido desinicializada).

curses.keyname(k)

Retorna el nombre de la tecla enumerada k como un objeto de bytes. El nombre de una tecla que genera un carácter ASCII imprimible es el carácter de la tecla. El nombre de una combinación de teclas de control es un consistente objeto de bytes de dos bytes de un signo de intercalación (b'^') seguido por el correspondiente carácter ASCII imprimible. El nombre de una combinación de tecla alt (128-255) es un objeto de bytes consistente del prefijo b'M-' seguido por el nombre del correspondiente carácter ASCII.

curses.killchar()

Retorna el carácter de eliminación de la línea actual del usuario como un objeto de bytes de un byte. Bajo el sistema operativo Unix esta es una propiedad del controlador tty del programa curses, y no está configurado por la librería curses por sí mismo.

curses.longname()

Retorna un objeto de bytes que contiene el campo de nombre largo terminfo que describe el terminal actual. La longitud máxima de una descripción verbosa es 128 caracteres. Esto es definido solamente después de la llamada a initscr().

curses.meta(flag)

Si flag es «True», permite caracteres de 8 bits para ser introducidos. Si flag es «False», permite solamente caracteres de 7 bits.

curses.mouseinterval(interval)

Configura el tiempo máximo en milisegundos que pueden transcurrir entre los eventos de presionar y soltar para que se reconozcan como un click, y retornen el valor del intervalo anterior. El valor por defecto es 200 msec, o una quinta parte de un segundo.

curses.mousemask(mousemask)

Configure los eventos del mouse para ser reportados, y retorna una tupla (availmask, oldmask). availmask indica cual de los eventos del ratón especificados pueden ser reportados; en caso de falla completa retorna 0. oldmask es el valor previo de la máscara de evento del mouse de la ventana dada. Si esta función nunca es llamada, los eventos del mouse nunca son reportados.

curses.napms(ms)

Duerme durante ms milisegundos.

curses.newpad(nlines, ncols)

Crea y retorna un apuntador para una nueva estructura de datos de pad con el número dado de líneas y columnas. Retorna un pad como un objeto de ventana.

Una almohadilla es como una ventana, excepto que no es restringida por el tamaño de la pantalla, y no está necesariamente asociada con una parte particular de la pantalla. Las almohadillas pueden ser usadas cuando un ventana grande es necesitada, y solamente una parte de la ventana estará en la pantalla de una sola vez. Actualizaciones automáticas de almohadillas (tales desde el desplazamiento o haciendo eco de la entrada) no ocurre. Los métodos refresh() y noutrefresh() de una almohadilla requiere 6 argumentos para especificar la parte de la almohadilla a ser mostrada y la locación en la ventana que se utilizará para la visualización. Los argumentos son pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol; el argumento p se refiere a la esquina superior izquierda de la región de la almohadilla a ser mostrada y el argumento s define una caja de recorte en la pantalla con la cual la región de la almohadilla será mostrada.

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

Retorna una nueva window, cuya esquina superior izquierda esta en (begin_y, begin_x), y cuyo alto/ancho es nlines/ncols.

Por defecto, la ventana extenderá desde la posición especificada para la esquina inferior derecha de la pantalla.

curses.nl()

Ingrese al modo de línea nueva. Este modo pone la tecla de retorno en una nueva línea en la entrada, y traduce la nueva línea en retorno y avance de línea en la salida. El modo de nueva línea está inicialmente encendida.

curses.nocbreak()

Salir del modo cbreak. Retorne al modo normal «cooked» con la línea del búfer.

curses.noecho()

Salir del modo echo. El eco de los caracteres de entrada está desactivado.

curses.nonl()

Dejar el modo de nueva línea. Desactiva la traducción de retorno en una nueva línea en la entrada, y desactiva la traducción a bajo nivel de una nueva línea en nueva línea/retorno en la salida (pero esto no cambia el comportamiento de addch('\n'), el cual siempre es el equivalente de retornar y avanzar la línea en la pantalla virtual). Con las traducciones apagadas, curses puede aumentar algunas veces la velocidad del movimiento vertical un poco; también, estará disponible para detectar la tecla de retorno en la entrada.

curses.noqiflush()

Cuando la rutina noqiflush() es usada, descarga normal de colas de entrada y salida asociadas con el INTR, los caracteres QUIT and SUSP no serán hechos. Puedes querer llamar noqiflush() en un manejador de señales si quieres que la salida continúe como si la interrupción no hubiera ocurrido después de que el manejador exista.

curses.noraw()

Salir del modo raw. Retorna al modo normal «cooked» con la línea del búfer.

curses.pair_content(pair_number)

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.

curses.pair_number(attr)

Retorna el numero del conjunto de pares de colores para el valor del atributo attr. color_pair() es la contraparte de esta función.

curses.putp(str)

Equivalente a tputs(str, 1, putchar); emite el valor de una capacidad especificada terminfo para el terminal actual. Nota que la salida de putp() siempre va a la salida estándar.

curses.qiflush([flag])

Si flag es False, el efecto es el mismo como llamar noqiflush(). Si flag es True, o el argumento no es proveído, la cola será nivelada cuando estos caracteres de control son leídos.

curses.raw()

Entrar al modo crudo. En el modo crudo, el almacenamiento en búfer de la línea normal y procesamiento de las teclas de interrupción, salida, suspensión y control de flujo son apagadas; los caracteres son presentados a la función de entrada de curses una por una.

curses.reset_prog_mode()

Restaura la terminal para el modo «program», anteriormente guardado por def_prog_mode().

curses.reset_shell_mode()

Restablece el terminal al modo «shell» como lo guardó previamente def_shell_mode().

curses.resetty()

Restablece el estado del modo del terminal para lo que esto fue en el último llamado a savetty().

curses.resize_term(nlines, ncols)

La función backend usada por resizeterm(), caracteriza más de el trabajo; cuando se redimensiona la ventana, resize_term() los rellenos blancos de las áreas que son extendidas. La aplicación de llamada llenaría en estas áreas con datos apropiados. La función resize_term() intenta redimensionar todas las ventanas. Sin embargo, debido a la convención de llamadas del las almohadillas, esto no es posible para redimensionar estos sin interacciones adicionales con la aplicación.

curses.resizeterm(nlines, ncols)

Ajusta el tamaño al estándar y la ventana actual para las dimensiones especificadas, y ajusta otros datos contables usados por la librería curses que registra las dimensiones de la ventana (en particular el manejador SIGWINCH ).

curses.savetty()

Guarda el estado actual del modo del terminal en un búfer, usable por resetty().

curses.setsyx(y, x)

Fija el cursor de la pantalla virtual para y, x. Si y y x son ambos «-1», entonces leaveok es configurado «True».

curses.setupterm(term=None, fd=-1)

Inicializa la terminal. term es una cadena de caracteres dando el nombre de la terminal, o None; si es omitido o None, el valor de la variable de entorno TERM será usada. fd es el archivo descriptor al cual alguna secuencia de inicialización será enviada; si no es suministrada o -1, el archivo descriptor para sys.stdout será usado.

curses.start_color()

Debe ser llamado si el programador quiere usar colores, y antes de que cualquier otra rutina de manipulación de colores sea llamada. Esta es una buena práctica para llamar esta rutina inmediatamente después de initscr().

start_color() inicializa ocho colores básicos (negro, rojo, verde, amarillo, azul, magenta, cian, y blanco), y dos variables globales en el módulo curses, COLORS y COLOR_PAIRS, contiene el número máximo de colores y los pares de colores que la terminal puede soportar. Esto también restaura los colores en la terminal para los valores que ellos tienen cuando la terminal fue solo activada.

curses.termattrs()

Retorna un OR lógico de todos los atributos del video soportados por el terminal. Esta información es útil cuando un programa curses necesita completar el control sobre la apariencia de la pantalla.

curses.termname()

Retorna el valor de la variable de entorno TERM, como un objeto de bytes, trucado para 14 caracteres.

curses.tigetflag(capname)

Retorna el valor de la capacidad booleana correspondiente al nombre de la capacidad terminfo capname como un número entero. Retorna el valor -1 si capname no es una capacidad booleana, o 0 si es cancelada o ausente desde la descripción de la terminal.

curses.tigetnum(capname)

Retorna el valor de la capacidad numérica correspondiente al nombre de la capacidad terminfo capname como un entero. Regresa el valor -2 si capname no es una capacidad numérica, o -1 si esta es cancelada o ausente desde la descripción del terminal.

curses.tigetstr(capname)

Retorna el valor de la capacidad de la cadena de caracteres correspondiente al nombre de la capacidad terminfo capname como un objeto de bytes. Retorna None si capname no es una «capacidad de cadena de caracteres» de terminfo, o es cancelada o ausente desde la descripción de la terminal.

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

Instancia del objeto de bytes str con los parámetros suministrados, dónde str sería un cadena de caracteres parametrizada obtenida desde la base de datos de terminfo. E.g. tparm(tigetstr("cup"), 5, 3) podría resultar en b'\033[6;4H', el resultado exacto depende del tipo de terminal.

curses.typeahead(fd)

Especifica que el descriptor de archivo fd es usado para la verificación anticipada. Si fd es «-1», entonces no se realiza ninguna verificación anticipada.

La librería curses hace «la optimización del rompimiento de línea» por la búsqueda para mecanografiar periódicamente mientras se actualiza la pantalla. Si la entrada es encontrada, y viene desde un tty, la actualización actual es pospuesta hasta que se vuelva a llamar la actualización, permitiendo la respuesta más rápida para comandos escritos en avance. Esta función permite especificar un archivo diferente al descriptor para la verificación anticipada.

curses.unctrl(ch)

Regresa un objeto de bytes el cual es una representación imprimible del carácter ch. Los caracteres de control son representados como un símbolo de intercalación seguido del carácter, por ejemplo como b'^C'. La impresión de caracteres son dejados como están.

curses.ungetch(ch)

Presiona ch para que el siguiente getch() lo retorne.

Nota

Solamente un ch puede ser colocado antes getch() es llamada.

curses.update_lines_cols()

Actualiza LINES y COLS. Útil para detectar el cambio manual del tamaño de pantalla.

Nuevo en la versión 3.5.

curses.unget_wch(ch)

Presiona ch para que el siguiente get_wch() lo retorne.

Nota

Solamente un ch puede ser presionado antes get_wch() es llamada.

Nuevo en la versión 3.3.

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

Coloca un evento KEY_MOUSE en la cola de entrada, asociando el estado de los datos dados con esto.

curses.use_env(flag)

Si es usado, esta función sería llamada antes de initscr() o newterm son llamados. Cuando flag es False, los valores de líneas y columnas especificadas en la base de datos terminfo será usado, incluso si las variables de entorno LINES y COLUMNS (usadas por defecto) son configuradas, o si curses está corriendo en una ventana (en cuyo caso el comportamiento por defecto sería usar el tamaño de ventana si LINES y COLUMNS no están configuradas).

curses.use_default_colors()

Permite usar valores por defecto para los colores en terminales apoyando esta característica. Use esto para apoyar la transparencia en tu aplicación. El color por defecto es asignada para el número de color -1. Después de llamar esta función, inicializa init_pair(x, curses.COLOR_RED, -1), por ejemplo, los pares de color x a un primer plano de color rojo en el fondo por defecto.

curses.wrapper(func, ...)

Inicializa curses y llama a otro objeto invocable, func, el cual debería ser el resto de tu aplicación que usa curses. Si la aplicación lanza una excepción, esta función restaurará la terminal para un estado sano antes de re-lanzar la excepción y generar un una pista. El objeto invocable func es entonces pasado a la ventana principal “stdscr” como su primer argumento, seguido por algún otro argumento pasado a wrapper(). Antes de llamar a func, wrapper() habilita el modo cbreak, desactiva echo, permite el teclado del terminal, e inicializa los colores si la terminal tiene soporte de color. En salida (ya sea normal o por excepción) esto restaura el modo cooked, habilita el echo, y desactiva el teclado del terminal.

Objetos de ventana

Los objetos ventana, retornados por initscr() y newwin() anteriores, tienen los siguientes métodos y atributos:

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

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.

Nota

Escribiendo afuera de la ventana, sub-ventana, o pad genera un curses.error. Intentando escribir en la esquina inferior derecha de una ventana, sub-ventana, o pad causará una excepción a ser generada después de que el carácter es pintado.

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

Pintar como máximo n caracteres de la cadena de texto str en «(y,x)» con atributos attr, sobrescribiendo algo previamente en la pantalla.

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

Dibuja la cadena de caracteres str en «(y,x)» con atributos attr, sobrescribiendo cualquier cosa previamente en la pantalla.

Nota

  • Escribiendo afuera de la ventana, sub-ventana, o pad genera un curses.error. Intentando escribir en la esquina inferior derecha de una ventana, sub-ventana, o pad causará una excepción a ser generada después de que la cadena de caracteres es pintada.

  • Un bug en *ncurses*, el backend para este módulo de Python, puede causar SegFaults cuando re-dimensionan las ventanas. Esto es reparado en ncurses-6.1-20190511. Si tu estás atascado con un ncurses anterior, puedes evitar desencadenar este si no llamas addstr() con un str que tiene embebido nuevas líneas. En su lugar, llama addstr() separadamente por cada línea.

window.attroff(attr)

Remueve el atributo attr desde el conjunto «background» aplicado a todos los escritos para la ventana actual.

window.attron(attr)

Añade el atributo attr del conjunto del background aplicado para todas las escrituras de la ventana actual.

window.attrset(attr)

Establezca el conjunto de atributos «background para attr. Este conjunto es inicialmente «0» (sin atributos).

window.bkgd(ch[, attr])

Configura la propiedad de fondo de la ventana para el carácter ch, con atributos atte. El cambio es entonces aplicado para la posición de cada carácter en esa ventana:

  • El atributo de cada carácter en la ventana es cambiado por el nuevo atributo de fondo.

  • Dónde quiera que el carácter del fondo anterior aparezca, es cambiado al nuevo carácter de fondo.

window.bkgdset(ch[, attr])

Configura el fondo de la ventana. Un fondo de ventana consiste de un carácter y cualquier combinación de atributos. La parte del atributo del fondo es combinado (OR” ed) con todos los caracteres que no son blancos escritos en la ventana. Tanto las partes del carácter y del atributo del fondo son combinados con los caracteres en blanco. El fondo se convierte en una propiedad del carácter y se mueve con el carácter a través de cualquier operación de desplazamiento e inserción/eliminación de línea/carácter.

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

Dibuja un borde alrededor de las orillas de la ventana. Cada parámetro especifica el carácter a usar para una parte específica del borde; ve la tabla abajo para más detalles.

Nota

Un valor 0 para cualquier parámetro causará el carácter por defecto a ser usado para ese parámetro. parámetros de palabras clave pueden no ser usados. Los valores predeterminados son listados en esta tabla:

Parámetro

Descripción

Valor por defecto

ls

Lado izquierdo

ACS_VLINE

rs

Lado derecho

ACS_VLINE

ts

Arriba

ACS_HLINE

bs

Abajo

ACS_HLINE

tl

Esquina superior izquierda

ACS_ULCORNER

tr

Esquina superior derecha

ACS_URCORNER

bl

Esquina inferior izquierda

ACS_LLCORNER

br

Esquina inferior derecha

ACS_LRCORNER

window.box([vertch, horch])

Similar a border(), pero ambos ls y *rs son vertch y ambos ts y bs son horch. Los caracteres de esquina predeterminados son siempre usados por esta función.

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

Configura los atributos de num de caracteres en la posición del cursor, o una posición (y, x) si es suministrado. Si num no es dado o es -1, el atributo será configurado en todos los caracteres para el final de la línea. Esta función mueve el cursor a la posición (y, x) si es suministrado. La línea cambiada será tocada usando el método touchline() tal que el contenido será vuelto a mostrar por la actualización de la siguiente ventana.

window.clear()

Semejante a erase(), pero también causa que toda la ventana sea repintada sobre la siguiente llamada para refresh().

window.clearok(flag)

Si flag es «True», la siguiente llamada para refresh() limpiará la ventana completamente.

window.clrtobot()

Borrar desde el cursor hasta el final de la ventana: todas las líneas bajo el cursor son eliminadas, y entonces el equivalente de clrtoeol() es realizado.

window.clrtoeol()

Borrar desde el cursor hasta el final de la línea.

window.cursyncup()

Actualice la posición actual del cursor de todos los ancestros de la ventana para reflejar la posición actual del cursor de la ventana.

window.delch([y, x])

Borrar cualquier carácter en «(y,x)».

window.deleteln()

Borra la línea bajo el cursor. Todas las líneas siguientes son movidas una línea hacía arriba.

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

Una abreviación para «ventana derivada», derwin() es el mismo cómo llamar subwin(), excepto que begin_y y begin_x son relativos al origen de la ventana, más bien relativo a la pantalla completa. Retorna un objeto ventana para la ventana derivada.

window.echochar(ch[, attr])

Añada el carácter ch con atributo attr, e inmediatamente llame a refresh() en la ventana.

window.enclose(y, x)

Pruebe si el par dado de las coordenadas de celda del carácter relativas de la ventana son encerrados por la ventana dada, retornando True o False. Esto es útil para determinar que subconjunto de las ventanas de pantalla encierran la locación de un evento del mouse.

window.encoding

La codificación utilizada para codificar argumentos de método (Unicode de caracteres y cadena de caracteres). El atributo codificado es heredado desde la ventana padre cuando una sub-ventana es creada, por ejemplo con window.subwin(). Por defecto, la codificación local es usada (ver locale.getpreferredencoding()).

Nuevo en la versión 3.3.

window.erase()

Limpiar la ventana.

window.getbegyx()

Retorna una tupla «(y,x)» de coordenadas de la esquina superior izquierda.

window.getbkgd()

Retorna el par carácter/atributo dada la ventana actual.

window.getch([y, x])

Obtener un carácter. Nota que el entero retornado no tiene que estar en el rango ASCII: teclas de función, claves de teclado y los demás son representados por números mayores que 255. En el modo sin demora, retorna -1 si no hay entrada, en caso contrario espere hasta que una tecla es presionada.

window.get_wch([y, x])

Obtener un carácter amplio. Retorna un carácter para la mayoría de las teclas, o un entero para las teclas de función, teclas del teclado, y otras teclas especiales. En modo de no retorna, genera una excepción si no hay entrada.

Nuevo en la versión 3.3.

window.getkey([y, x])

Obtener un carácter, retornando una cadena de caracteres en lugar de un entero, como getch() lo hace. Las teclas de función, teclas del teclado y otras teclas especiales retornan una cadena multibyte conteniendo el nombre de la tecla. En modo de no retardo, genera una excepción si no hay entrada.

window.getmaxyx()

Retorna una tupla «(y,x)» de el alto y ancho de la ventana.

window.getparyx()

Retorne las coordenadas iniciales de esta ventana relativa para su ventana padre como una tupla (y, x). Retorna (-1, -1) si esta ventana no tiene padre.

window.getstr()
window.getstr(n)
window.getstr(y, x)
window.getstr(y, x, n)

Lee un objeto de bytes desde el usuario, con capacidad de edición de línea primitiva.

window.getyx()

Retorna una tupla (y, x) de la posición actual del cursor relativa para la esquina superior izquierda de la ventana.

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

Muestra una línea horizontal iniciando en (y, x) con longitud n consistente de el carácter ch.

window.idcok(flag)

Si flag es False, curses ya no considera el uso de la función de insertar/eliminar caracteres de hardware del terminal; si flag True, el uso de inserción y borrado de caracteres está habilitado. Cuando curses es inicializado primero, el uso de caracteres de inserción / borrado está habilitado por defecto.

window.idlok(flag)

Si flag es True, curses tratará y usará las funciones de la línea de edición de hardware. En caso contrario, la línea inserción/borrado están deshabilitadas.

window.immedok(flag)

Si flag es True, cualquier cambio en la imagen de la ventana automáticamente causará que la ventana sea refrescada; ya no tienes que llamar a refresh() por ti mismo. Sin embargo, esto puede degradar el rendimiento considerablemente, debido a las repeticiones de llamada a wrefresh. Esta opción está deshabilitada por defecto.

window.inch([y, x])

Retorna el carácter en la posición dada en la ventana. Los 8bits inferiores son los caracteres propiamente dichos, y los bits superiores son los atributos.

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

Pinta el carácter ch en (y, x) con atributos attr, moviendo la línea desde la posición x a la derecha un carácter.

window.insdelln(nlines)

Inserta nlines líneas en la ventana especificada arriba de la línea actual. Las nlines líneas de fondo se pierden. Para nlines negativos, elimine nlines líneas comenzando con la que está debajo del cursor, y mueve las restantes hacia arriba. Se borran las nlines líneas inferiores. La posición del cursor actual se mantiene igual.

window.insertln()

Inserte una línea en blanco bajo el cursos. Las líneas siguientes se moverán una línea hacía abajo.

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

Inserte una cadena de caracteres (tantos caracteres quepan en la línea) antes los caracteres bajo el cursor, sobre los n caracteres. Si n es cero o negativo, la cadena entera es insertada. Todos los caracteres a la derecha de el cursor son desplazados a la derecha, perdiéndose los caracteres de la derecha en la línea. La posición del cursor no cambia (después de mover a y, x, si es especificado).

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

Inserte una cadena de caracteres ( tantos caracteres encajen en la línea) antes los caracteres bajo el cursor. Todos los caracteres a la derecha de el cursor son desplazados a la derecha, perdiéndose los caracteres de la derecha en línea.

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

Regresa un objeto de bytes de caracteres, extraídos desde la ventana comenzando en la posición actual del cursor, o en y, x si es especificado. Los atributos son despojados desde los caracteres. Si n es especificado, instr() retorna una cadena de caracteres como máximo de n caracteres (exclusivo de la NULL final).

window.is_linetouched(line)

Retorna True si la línea especificada fue modificada desde la última llamada a refresh(); de otra manera retorna False. Genera una excepción curses.error si line no es válida para la ventana dada.

window.is_wintouched()

Retorna True si la ventana especificada fue modificada desde la última llamada para refresh(); en caso contrario, retorna False.

window.keypad(flag)

Si flag es True, evita las secuencias generadas por algunas teclas (teclado, teclas de función) será interpretadas por curses. Si flag es False, evita las secuencias que serán dejadas como está en la corriente de entrada.

window.leaveok(flag)

Si flag es True, el cursor es dejado donde está en la actualización, por ejemplo estando en «cursor position.» Esto reduce el movimiento del cursor siempre que sea posible. Si es posible, el cursor se hará invisible.

Si flag es «False», el cursor siempre estará en «cursor position» después de una actualización.

window.move(new_y, new_x)

Mueve el cursor a «(new_y, new_x)».

window.mvderwin(y, x)

Mueve la ventana adentro de su ventana padre. Los parámetros relativos a la pantalla de la ventana no son cambiados. Esta rutina es usada para mostrar diferentes partes de la ventana padre en la misma posición física en la pantalla.

window.mvwin(new_y, new_x)

Mueve la ventana a su esquina superior izquierda que está en «(new_y,new_x)».

window.nodelay(flag)

Si flag es «True», getch() no será bloqueada.

window.notimeout(flag)

Si flag es «True», las secuencias de escape no serán agotadas.

Si flag es False, después de pocos milisegundos, una secuencia de escape no será interpretada, y será dejada en el flujo de entrada como está.

window.noutrefresh()

Marque para actualizar pero espere. Esta función actualiza la estructura de datos representando el estado deseado de la ventana, pero no fuerza una actualización en la pantalla física. Para realizar eso, llame doupdate().

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

Cubre la ventana en la parte superior de destwin. La ventana no necesita ser del mismo tamaño, solamente se solapa la región copiada. Esta copia no es destructiva, lo que significa que el carácter de fondo actual no sobre-escribe el contenido viejo de destwin.

Para obtener el control de grano fino sobre la región copiada, la segunda forma de overlay() puede ser usada. sminrow y smincol son las coordenadas superior izquierda de la ventana de origen, y las otras variables marcan un rectángulo en la ventana destino.

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

Sobre-escribe la ventana en la parte superior de destwin. La ventana no necesita ser del mismo tamaño, en cuyo caso solamente se sobrepone la región que es copiada. Esta copia es destructiva, lo cual significa que el carácter de fondo actual sobre-escribe el contenido viejo de destwin.

Para obtener el control de grano fino sobre la región copiada, la segunda forma de overwrite() puede ser usada. sminrow y smincol son las coordenadas superior izquierda de la ventana origen, las otras variables marcan un rectángulo en la ventana de destino.

window.putwin(file)

Escribe todos los datos asociados con la ventana en el objeto de archivo proveído. Esta información puede estar después recuperada usando la función getwin().

window.redrawln(beg, num)

Indica que el num de líneas de la pantalla, empiezan en la línea beg, son corruptos y deberían ser completamente redibujado en la siguiente llamada refresh().

window.redrawwin()

Toca la ventana completa, causando que se vuelva a dibujar completamente en la siguiente llamada refresh() .

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

Actualiza la pantalla inmediatamente (sincronice la pantalla actual con los métodos previos de dibujar/borrar).

Los 6 argumentos opcionales pueden ser solamente especificados cuando la ventana es una almohadilla creada con newpad(). Los parámetros adicionales son necesarios para indicar que parte de la almohadilla y pantalla son envueltos. pminrow y pmincol especifica la esquina superior de la mano izquierda del rectángulo a ser mostrado en el pad. sminrow, smincol, smaxrow, y smaxcol especifica los bordes del rectángulo a ser mostrados en la pantalla. La esquina inferior de la mano derecha del rectángulo a ser mostrado en el pad es calculado desde las coordenadas de la pantalla, desde que el rectángulo debe ser del mismo tamaño. Ambos rectángulos deben ser completamente contenidos con su estructura respectiva. Valores negativos de pminrow, pmincol, sminrow, o smincol son tratados como si fueran cero.

window.resize(nlines, ncols)

Redistribuir el almacenamiento para una ventana curses para ajustar su dimensión para los valores especificados. Si la dimensión también es mayor que los valores actuales, los datos de la ventana serán llenados con espacios en blanco que tiene la ejecución del fondo actual (como ajustado por bkgdset()) uniéndolos.

window.scroll([lines=1])

Desplace la pantalla o la región de desplazamiento hacia arriba por lines líneas.

window.scrollok(flag)

Control que sucede cuando el cursor de una ventana es movida fuera del borde de la ventana o región de desplazamiento, también como un resultado de una acción de nueva línea en la línea inferior, o escribiendo el último carácter de la última línea. Si flag es False, el cursor está a la izquierda sobre la línea inferior. Si flag es True, la ventana será desplazada hacía arriba por una línea. Note que en orden para obtener el efecto del desplazamiento físico en el terminal, también será necesario llamar idlok().

window.setscrreg(top, bottom)

Configura la región de desplazamiento desde la línea top hasta la línea bottom. Todas las acciones de desplazamiento tomarán lugar en esta región.

window.standend()

Desactive el atributo destacado. En algunos terminales esto tiene el efecto secundario de desactivar todos los atributos.

window.standout()

Active el atributo A_STANDOUT.

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

Retorna la sub-ventana, cuya esquina superior izquierda esta en (begin_y, begin_x), y cuyo ancho/alto es ncols/nlines.

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

Retorna la sub-ventana, cuya esquina superior izquierda esta en (begin_y, begin_x), y cuyo ancho/alto es ncols/nlines.

Por defecto, la sub-ventana extenderá desde la posición especificada para la esquina inferior derecha de la ventana.

window.syncdown()

Toca cada ubicación en la ventana que ha sido tocado por alguna de sus ventanas padres. Esta rutina es llamada por refresh(), esto casi nunca debería ser necesario para llamarlo manualmente.

window.syncok(flag)

Si flag es True, entonces syncup() es llamada automáticamente cuando hay un cambio en la ventana.

window.syncup()

Toque todas las locaciones de los ancestros de la ventana que han sido cambiados en la ventana.

window.timeout(delay)

Configura el bloqueo o no bloqueo del comportamiento para la ventana. Si el delay es negativo, bloqueando la lectura usada (el cual esperará indefinidamente para la entrada). Si delay es zero, entonces no se bloqueará la lectura usada, y getch() retornará -1 si la entrada no está esperando. Si delay es positivo, entonces getch() se bloqueará por delay milisegundos, y retorna -1 si aún no entra en el final de ese tiempo.

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

Supone count líneas han sido cambiadas, iniciando con la línea start. Si changed es suministrado, específica que las líneas afectadas son marcadas como hayan sido cambiadas (changed=True) o no cambiadas (changed=False).

window.touchwin()

Suponga que toda la ventana ha sido cambiada, con el fin de optimizar el dibujo.

window.untouchwin()

Marque todas las líneas en la ventana como no cambiadas desde la última llamada para refresh().

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

Muestre una línea vertical iniciando en (y, x) con longitud n consistente de el carácter ch.

Constantes

El módulo curses define los siguientes miembros de datos:

curses.ERR

Algunas rutinas de curses que retornan un entero, tales como getch(), retorna ERR sobre el fallo.

curses.OK

Algunas rutinas de curses que retornan un entero, tales como napms(), retorna OK tras el éxito.

curses.version

Un objeto de bytes representando la versión actual de el módulo. También disponible como __version__.

curses.ncurses_version

Una tupla nombrada contiene los 3 componentes de la versión de la librería ncurses major, minor, y patch. Todos los valores son enteros. Los componentes pueden también ser accedidos por nombre, así curses.ncurses_version[0] es equivalente a curses.ncurses_version.major y así.

Disponibilidad: si la librería ncurses es usada.

Nuevo en la versión 3.8.

Algunas constantes están disponibles para especificar los atributos del celdas de caracteres. Las constantes exactas disponible dependen del sistema.

Atributo

Significado

A_ALTCHARSET

Modo de conjunto de caracteres alternativo

A_BLINK

Modo parpadeo

A_BOLD

Modo negrita

A_DIM

Modo tenue

A_INVIS

Modo invisible o en blanco

A_ITALIC

Modo cursiva

A_NORMAL

Atributo normal

A_PROTECT

Modo protegido

A_REVERSE

Fondo inverso y colores de primer plano

A_STANDOUT

Modo destacado

A_UNDERLINE

Modo subrayado

A_HORIZONTAL

Resaltado horizontal

A_LEFT

Resaltado a la izquierda

A_LOW

Resaltado bajo

A_RIGHT

Resaltado a la derecha

A_TOP

Resaltado arriba

A_VERTICAL

Resaltado vertical

A_CHARTEXT

Mascara de bits para extraer un caracter

Nuevo en la versión 3.7: A_ITALIC fue añadido.

Varias constantes están disponibles para extraer los atributos correspondientes retornados por algunos métodos.

Mascara de bits

Significado

A_ATTRIBUTES

Mascara de bits para extraer atributos

A_CHARTEXT

Mascara de bits para extraer un caracter

A_COLOR

Mascara de bits para extraer información de campo de pares de colores

Las teclas se denominan constantes enteras con nombres que comienzan con KEY_. Las teclas exactas disponibles son dependientes del sistema.

Clave constante

Clave

KEY_MIN

Valor mínimo de la clave

KEY_BREAK

Clave rota (no confiable)

KEY_DOWN

Flecha hacia abajo

KEY_UP

Flecha hacia arriba

KEY_LEFT

Flecha hacia la izquierda

KEY_RIGHT

Flecha hacia la derecha

KEY_HOME

Tecla de inicio (flecha hacia arriba + flecha hacia la izquierda)

KEY_BACKSPACE

Retroceso (no confiable)

KEY_F0

Teclas de función. Más de 64 teclas de función son soportadas.

KEY_Fn

Valor de tecla de función n

KEY_DL

Borrar línea

KEY_IL

Inserte línea

KEY_DC

Borrar caracter

KEY_IC

Insertar carácter o ingresara al modo de inserción

KEY_EIC

Salir del modo de inserción de caracteres

KEY_CLEAR

Limpiar pantalla

KEY_EOS

Limpiar al final de pantalla

KEY_EOL

Limpiar al final de la línea

KEY_SF

Desplazar una línea hacia adelante

KEY_SR

Desplazar una línea hacia atrás (reversa)

KEY_NPAGE

Página siguiente

KEY_PPAGE

Página anterior

KEY_STAB

Establecer pestaña

KEY_CTAB

Limpiar pestaña

KEY_CATAB

Limpiar todas las pestañas

KEY_ENTER

Ingresar o enviar (no confiable)

KEY_SRESET

Reinicio suave (parcial) (no confiable)

KEY_RESET

Reinicio o reinicio fuerte (no confiable)

KEY_PRINT

Imprimir

KEY_LL

Inicio abajo o abajo (abajo a la izquierda)

KEY_A1

Superior izquierda del teclado

KEY_A3

Superior derecha de el teclado

KEY_B2

Centro del teclado

KEY_C1

Inferior izquierdo del teclado

KEY_C3

Inferior derecho del teclado

KEY_BTAB

Pestaña trasera

KEY_BEG

Mendigar (Comienzo)

KEY_CANCEL

Cancelar

KEY_CLOSE

Cerrar

KEY_COMMAND

Cmd (Comando)

KEY_COPY

Copiar

KEY_CREATE

Crear

KEY_END

Final

KEY_EXIT

Salir

KEY_FIND

Encontrar

KEY_HELP

Ayudar

KEY_MARK

Marca

KEY_MESSAGE

Mensaje

KEY_MOVE

Mover

KEY_NEXT

Siguiente

KEY_OPEN

Abrir

KEY_OPTIONS

Opciones

KEY_PREVIOUS

Anterior

KEY_REDO

Rehacer

KEY_REFERENCE

Referencia

KEY_REFRESH

Refrescar

KEY_REPLACE

Re-emplazar

KEY_RESTART

Re-iniciar

KEY_RESUME

Resumir

KEY_SAVE

Guardar

KEY_SBEG

Mendicidad desplazada (comienzo)

KEY_SCANCEL

Cancelar cambiado

KEY_SCOMMAND

Comando cambiado

KEY_SCOPY

Copiado cambiado

KEY_SCREATE

Crear con desplazamiento

KEY_SDC

Borrar carácter desplazado

KEY_SDL

Borrar línea desplazada

KEY_SELECT

Seleccionar

KEY_SEND

Final desplazado

KEY_SEOL

Limpiar línea desplazada

KEY_SEXIT

Salida desplazada

KEY_SFIND

Búsqueda desplazada

KEY_SHELP

Ayuda desplazada

KEY_SHOME

Inicio cambiado

KEY_SIC

Entrada cambiada

KEY_SLEFT

Flecha hacia la izquierda desplazada

KEY_SMESSAGE

Mensaje cambiado

KEY_SMOVE

Movimiento desplazado

KEY_SNEXT

Siguiente desplazado

KEY_SOPTIONS

Opciones cambiadas

KEY_SPREVIOUS

Anterior cambiado

KEY_SPRINT

Imprimir desplazado

KEY_SREDO

Rehacer cambiado

KEY_SREPLACE

Re-emplazo cambiado

KEY_SRIGHT

Flecha hacia la derecha cambiada

KEY_SRSUME

Resumen cambiado

KEY_SSAVE

Guardar desplazado

KEY_SSUSPEND

Suspender cambiado

KEY_SUNDO

Deshacer desplazado

KEY_SUSPEND

Suspender

KEY_UNDO

Deshacer

KEY_MOUSE

Evento del ratón ha ocurrido

KEY_RESIZE

Evento de cambio de tamaño del terminal

KEY_MAX

Valor máximo de clave

En VT100s y su emulador de software, tal como X emulador de terminal, normalmente hay al menos cuatro funciones de tecla (KEY_F1, KEY_F2, KEY_F3, KEY_F4) disponibles, y la tecla flecha mapeada para KEY_UP, KEY_DOWN, KEY_LEFT y KEY_RIGHT en la manera obvia. Si tu máquina tiene un teclado de PC, esto asegura la expectativa de las teclas flecha y doce teclas de función (el más viejo de los teclados de PC pueden tener solamente diez teclas de función); también, la siguientes funciones de teclado son estándar:

Tecla

Constante

Insert

KEY_IC

Delete

KEY_DC

Home

KEY_HOME

End

KEY_END

Page Up

KEY_PPAGE

Page Down

KEY_NPAGE

La siguiente tabla lista los caracteres desde el conjunto alterno de caracteres. Estos son heredados desde el terminal VT100, y generalmente estará disponible en emuladores de software tales como terminales X. Cuando no hay gráficos disponibles, curses cae en una aproximación cruda de ASCII imprimibles.

Nota

Estos están disponibles solamente después de que initscr() ha sido llamada.

Código ACS

Significado

ACS_BBSS

nombre alternativo para la esquina superior derecha

ACS_BLOCK

bloque cuadrado sólido

ACS_BOARD

tablero de cuadrados

ACS_BSBS

nombre alternativo para línea horizontal

ACS_BSSB

nombre alternativo para esquina superior izquierda

ACS_BSSS

nombre alternativo para el soporte superior

ACS_BTEE

soporte inferior

ACS_BULLET

bala

ACS_CKBOARD

tablero inspector (punteado)

ACS_DARROW

flecha punteada hacia abajo

ACS_DEGREE

símbolo de grado

ACS_DIAMOND

diamante

ACS_GEQUAL

mayor que o igual a

ACS_HLINE

línea horizontal

ACS_LANTERN

símbolo de la linterna

ACS_LARROW

flecha izquierda

ACS_LEQUAL

menor que o igual a

ACS_LLCORNER

esquina inferior izquierda

ACS_LRCORNER

esquina inferior derecha

ACS_LTEE

soporte izquierdo

ACS_NEQUAL

signo no igual

ACS_PI

letra pi

ACS_PLMINUS

signo más o menos

ACS_PLUS

gran signo más

ACS_RARROW

flecha hacia la derecha

ACS_RTEE

soporte derecho

ACS_S1

escanear línea 1

ACS_S3

escanear línea 3

ACS_S7

escanear línea 7

ACS_S9

escanear línea 9

ACS_SBBS

nombre alterno para la esquina inferior derecha

ACS_SBSB

nombre alterno para la línea vertical

ACS_SBSS

nombre alterno para el soporte derecho

ACS_SSBB

nombre alterno para la esquina inferior izquierda

ACS_SSBS

nombre alterno para el soporte inferior

ACS_SSSB

nombre alterno para el soporte izquierdo

ACS_SSSS

nombre alterno para crossover o un gran más

ACS_STERLING

libra esterlina

ACS_TTEE

soporte superior

ACS_UARROW

flecha hacia arriba

ACS_ULCORNER

esquina superior izquierda

ACS_URCORNER

esquina superior derecha

ACS_VLINE

línea vertical

La siguiente tabla lista los colores pre-definidos:

Constante

Color

COLOR_BLACK

Negro

COLOR_BLUE

Azul

COLOR_CYAN

Cian (azul verdoso claro)

COLOR_GREEN

Verde

COLOR_MAGENTA

Magenta (rojo violáceo)

COLOR_RED

Rojo

COLOR_WHITE

Blanco

COLOR_YELLOW

Amarillo

curses.textpad— Widget de entrada de texto para programas de curses

El módulo curses.textpad provee una clase Textbox que maneja edición de texto primario en una ventana curses, apoyando un conjunto de atajos de teclado re-ensamblando estos de Emacs (esto, también de Netscape Navigator, BBedit 6.x, FrameMaker, y muchos otros programas). Los módulos también proveen una función de dibujo de rectángulo útil para enmarcar las cajas de texto o para otros propósitos.

El módulo curses.textpad define la siguiente función:

curses.textpad.rectangle(win, uly, ulx, lry, lrx)

Dibuja un rectángulo. El primer argumento debe ser un objeto de ventana, los argumentos restantes son coordenadas relativas para esa ventana. El segundo y tercer argumento son las coordenadas “x” y “y” de la esquina superior de la mano izquierda del rectángulo a ser dibujado, el cuarto y quinto argumento son las coordenadas “x” y “y” de la esquina inferior de la mano derecha. El rectángulo será dibujado usando formularios de caracteres VT100/IBM PC en terminales que hace esto posible (incluyendo xterm y mas otro emulador de terminal de software). Por otra parte será dibujado con guiones, barras verticales, y signos de más de ASCII.

Objeto de caja de texto

Tú puedes instanciar un objeto Textbox como sigue:

class curses.textpad.Textbox(win)

Retorna un objeto widget de caja de texto. El argumento win debería ser un objeto curses window en el cual la caja de texto es para ser contenido. El cursor de la caja de texto está inicialmente localizado en la esquina superior de la mano izquierda de la ventana que lo contiene, con coordenadas (0, 0). La bandera instanciada stripspaces está inicialmente encendida.

Objeto Textbox tiene los siguientes métodos:

edit([validator])

Este es el punto de entrada que normalmente usarás. Esto acepta la edición de las pulsaciones de tecla hasta que uno de las pulsaciones de finalización es introducida. Si validator es suministrado, esto debe ser una función. Será llamado para cada pulsación de tecla introducida con la pulsación de tecla como un parámetro; el comando ejecutado está hecho en el resultado. Este método retorna el contenido de la ventana como una cadena de caracteres; si se incluyen espacios en blanco en la ventana se ve afectado por el atributo stripspaces.

do_command(ch)

Procesa un simple comando al pulsar una tecla. Aquí está las funciones de tecla especiales admitidas:

Pulsación de tecla

Acción

Control-A

Ve al borde izquierdo de la ventana.

Control-B

Cursor hacia la izquierda, pasando a la línea anterior si corresponde.

Control-D

Borra el carácter bajo el cursor.

Control-E

Ve al borde derecho (quita los espacios) o al final de línea (eliminar los espacios).

Control-F

Cursor hacia la derecha, pasando a la línea siguiente cuando corresponda.

Control-G

Terminar, retornando el contenido de la ventana.

Control-H

Eliminar carácter al revés.

Control-J

Terminar si la ventana es de 1 línea, en caso contrario, inserte una nueva línea.

Control-K

Si la línea es blanca bórrela, en caso contrario, limpie hasta el final de línea.

Control-L

Refrescar la pantalla.

Control-N

Cursor hacia abajo; mueve hacia abajo una línea.

Control-O

Inserte una línea en blanco en la posición del cursor.

Control-P

Cursor hacia arriba; mueve hacia arriba una línea.

Las operaciones de movimiento no hacen nada si el cursor está en un borde donde el movimiento no es posible. Los siguientes sinónimos están apoyados siempre que sea posible:

Constante

Pulsación de tecla

KEY_LEFT

Control-B

KEY_RIGHT

Control-F

KEY_UP

Control-P

KEY_DOWN

Control-N

KEY_BACKSPACE

Control-h

Todas las otras pulsaciones de teclas están tratadas como un comando para insertar el carácter dado y muévase a la derecha (con ajuste en la línea).

gather()

Retorne el contenido de la ventana como una cadena de texto; si se incluyen espacios en blanco en la ventana se ve afectado por el miembro stripspaces.

stripspaces

Este atributo es una bandera que controla la interpretación de los espacios en blanco en la ventana. Cuando está encendido, los espacios en blanco al final en cada línea son ignorados; cualquier movimiento del cursor que lo coloque en un espacio en blanco final va hasta el final de esa línea, y los espacios en blanco finales son despejados cuando se recopila el contenido de la ventana.