Tamanho do buffer de janela e tela

O tamanho de um buffer de tela é expresso em termos de uma grade de coordenadas com base em células de caracteres. A largura é o número de células de caractere em cada linha e a altura é o número de linhas. Associado a cada buffer de tela é uma janela que determina o tamanho e o local da parte retangular do buffer de tela do console exibido na janela do console. A janela de um buffer de tela é definida especificando as coordenadas de célula de caractere das células superior esquerda e inferior direita do retângulo da janela.

Observação

No mundo das sequências de terminal virtual , o tamanho da janela e o tamanho do buffer de tela são corrigidos com o mesmo valor. O terminal manipula qualquer região de rolagem que seja equivalente a um console com um tamanho de buffer de tela maior que seu tamanho de janela. Esse conteúdo pertence ao terminal e geralmente não faz mais parte da área endereçável. Para obter mais informações, consulte nossa comparação das funções de console clássicas versus as sequências de terminal virtual.

Um buffer de tela pode ter qualquer tamanho, limitado apenas pela memória disponível. As dimensões da janela de um buffer de tela não podem exceder as dimensões correspondentes do buffer de tela do console ou da janela máxima que pode caber na tela com base no tamanho da fonte atual (controlado exclusivamente pelo usuário).

A função GetConsoleScreenBufferInfo retorna as seguintes informações sobre um buffer de tela e sua janela:

• O tamanho atual do buffer de tela do console
• O local atual da janela
• O tamanho máximo da janela, considerando o tamanho atual do buffer de tela, o tamanho da fonte atual e o tamanho da tela

A função GetLargestConsoleWindowSize retorna o tamanho máximo da janela de um console com base nos tamanhos de fonte e tela atuais. Esse tamanho difere do tamanho máximo da janela retornado por GetConsoleScreenBufferInfo , na qual o tamanho do buffer da tela do console é ignorado.

Para alterar o tamanho de um buffer de tela, use a função SetConsoleScreenBufferSize . Essa função falhará se qualquer dimensão do tamanho especificado for menor que a dimensão correspondente da janela do console.

Para alterar o tamanho ou o local da janela de um buffer de tela, use a função SetConsoleWindowInfo . Essa função falhará se as coordenadas de canto de janela especificadas excederem os limites do buffer de tela do console ou da tela. Alterar o tamanho da janela do buffer de tela ativo altera o tamanho da janela do console exibida na tela.

Um processo pode alterar o modo de entrada do console para habilitar a entrada da janela para que o processo possa receber entrada quando o usuário alterar o tamanho do buffer da tela do console. Se um aplicativo habilitar a entrada da janela, ele poderá usar GetConsoleScreenBufferInfo para recuperar o tamanho do buffer de janela e tela na inicialização. Essas informações podem ser usadas para determinar a maneira como os dados são exibidos na janela. Se o usuário alterar o tamanho do buffer da tela do console, o aplicativo poderá responder alterando a maneira como os dados são exibidos. Por exemplo, um aplicativo pode ajustar a maneira como o texto é encapsulado no final da linha se o número de caracteres por linha for alterado. Se um aplicativo não habilitar a entrada da janela, ele deverá usar os tamanhos herdados da janela e do buffer de tela ou defini-los para o tamanho desejado durante a inicialização e restaurar os tamanhos herdados na saída. Para obter informações adicionais sobre o modo de entrada da janela, consulte Low-Level Modos de Console.