Função SetConsoleActiveScreenBuffer
Importante
Este documento descreve a funcionalidade da plataforma do console que não faz mais parte do nosso roteiro de ecossistema. Não recomendamos o uso desse conteúdo em novos produtos, mas continuaremos a oferecer suporte aos usos existentes por tempo indeterminado. Nossa solução moderna preferida se concentra em sequências de terminais virtuais para máxima compatibilidade em cenários de multiplataforma. Você pode encontrar mais informações sobre essa decisão de design em nosso documento Console clássico versus terminal virtual.
Define o buffer de tela especificado como o buffer de tela do console exibido no momento.
Sintaxe
BOOL WINAPI SetConsoleActiveScreenBuffer(
_In_ HANDLE hConsoleOutput
);
Parâmetros
hConsoleOutput [in]
Um identificador do buffer da tela do console.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Um console pode ter vários buffers de tela. SetConsoleActiveScreenBuffer determina qual desses buffers é exibido. Grave em um buffer de tela inativo e, em seguida, use SetConsoleActiveScreenBuffer para exibir o conteúdo do buffer.
Dica
Essa API não é recomendada, mas tem um terminal virtual equivalente aproximado na sequência de buffer de tela alternativa. A definição do buffer de tela alternativo pode fornecer um espaço separado e isolado a um aplicativo para desenho ao longo do tempo de execução de sessão, preservando o conteúdo exibido pelo invocador do aplicativo. Isso mantém as informações de desenho para restauração simples na saída do processo.
Exemplos
Para ver um exemplo, Ler e gravar blocos de caracteres e atributos.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | ConsoleApi2.h (via WinCon.h, inclui o Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |