Window (gb.ncurses)

Uma janela é um objecto que pode ser utilizado para exibir o texto no ecrã. Na verdade, você não é capaz de escrever praticamente nada para a tela sem uma janela envolvida. Tal janela ocupa seu próprio espaço de memória - não está ligado a tela, embora não compartilhe memória com ele.

Com isso em mente, podemos distinguir entre a tela física e uma tela interna, virtual, que são sincronizadas à vontade (output buffer), mas, por padrão, o componente sincroniza automaticamente após cada operação sobre o conteúdo da janela.

Isso também significa que as janelas podem se sobrepor sem substituir o conteúdo das outras Windows. O mecanismo de desenho a direita (o visível, se falamos de sobreposição) parte da memória para a tela, é mantido pela biblioteca de extensão do painel ncurses. Isso é principalmente uma pilha de painéis que escolhe a parte correta da memória, dependendo da posição da sua janela na pilha de painéis.

Properties

Attributes	Retorna um objeto virtual usada para manipular atributos associados a Window.
Background	Retorna ou define a cor da Window, ou seja, uma das constantes em Color. As alterações têm efeito sobre todo o conteúdo, e não apenas para as operações subsequentes, como seria o uso de .Attributes.Color.
Border	Retorna ou define se a Window tem uma borda. A borda envolve o conteúdo da janela e não pode ser substituído pelas rotinas da janela (em oposição às bordas ncurses normais que são na parte interna da janela).
Buffered	Retorna ou define se a saída para Window é armazenado em buffer ou não. Por padrão, ele não é.
Caption	Define o título da janela se ela tiver uma borda. O título (ou legenda) é impresso na borda superior da janela.
CursorX	Retorna ou define a posição do cursor X na Window.
CursorY	Retorna ou define a posição do cursor Y na Window.
Foreground	Retorno ou define o primeiro plano da Window.
H	Um sinônimo para Height.
Height	Retorna ou define a altura do conteúdo das Window's, que são independentes da opçõo borda.
Pair	A propriedade Window.Pair codifica as cores das letras e do fundo de um caractere em um único inteiro.
Paper	Um sinônimo de Background
Pen	Um sinônimo para Foreground
W	Um sinônimo para Width.
Width	Retorna ou define a largura do conteúdo das Window's, independentemente das configurações da borda.
Wrap	Retorna ou define a quebrar automática de linha.
X	Retorna ou define a posição X da Window na tela.
Y	Retorna ou define a posição Y da Window na tela.

Methods

Ask	Esta função solicita que o usuário digite qualquer um dos caracteres presentes em Opts, opcionalmente para após Tries teclas digitadas erradas. Se Tries for omitido, a função irá perguntar até que uma das opções seja escolhida.
Center	Centraliza a janela no terminal.
Clear	O método Window.Clear() limpa a tela, ou seja, ele grava espaços em branco para todos os caracteres na janela. Portanto, Window.Clear() colore toda a sua janela com Window.Pair além de apagar todo o texto nela.
Cls	Limpe a janela.
Drain
DrawHLine	Desenhar uma linha traçada desde X,Y que vai Len caráteres sobre o eixo X. Ch é o caractere usado para desenhar a linha. Para uma linha horizontal, pode-se usar "-". O parâmetro Thickness é opcional especifica a expansão na direção do eixo Y.
DrawVLine	Desenha uma linha traçada desde X,Y que vai Len caráteres sobre o eixo Y. Ch é o caractere usado para desenhar a linha. Para uma linha vertical, pode-se usar "|". O parâmetro opcional Thickness especifica a expansão na direção do eixo X.
Get	Retorne os caracteres que inicia em X,Y. Se Len for omitido, esta função retorna a linha inteira. Se Len é dado, o Window é tratado como se fosse memória linear. Isto significa que Len vai além do comprimento da linha, a função opera em todas as linhas subsequentes.
Hide	Remova a Window da pilha stack. A torna invisível, mas ainda existe.
Locate	Mover o Cursor para o local referenciado por X, Y.
Lower
Move	Mover a Window para o novo local referenciado por X, Y.
Print	Imprime Text na posição atual do cursor, ou na posição X,Y se especificado. Todos os dados existentes na região serão substituídos:
PrintCenter	Esta rotina é usada para imprimir o Text dado o mais próximo possível do centro da Window. Na verdade, ela tenta imprimir a linha do meio mais próximo ao centro vertical da janela e o caráter médio em cada linha o mais próximo do centro horizontal da janela.
Raise	Traz a janela para o primeiro plano.
Read
ReadLine
Resize	Redimensiona a Window, conforme especificado por W e H.
SetFocus	Define o foco da Window especial de forma que gere o evento Read.
SetFullscreen
Show	Insere a Window no topo da pilha de painéis. Esta função pode ser usada para mostrar e ocultar Janelas.

Events

Read	O evento de leitura é gerado para a Window sempre que os dados chegam na fila de entrada (ou seja, stdin ou o teclado diretamente) que se observa atualmente. Quando, qual o tipo e quantidade de dados que chegam, depende do Modo de entrada definido no momento.