Como efectuar limpa o ecrã (CLS) numa aplicação de consola

Sumário

Algumas versões de não-Microsoft do C++ fornecem uma função de clrscr para limpar o ecrã de uma aplicação DOS. No entanto, não existe nenhuma função Win32 Application Programming Interface (API) ou o tempo de execução C que vai executar esta função.

Para realizar esta tarefa para uma aplicação de consola do Win32, utilize um dos seguintes métodos:
  • Utilize uma função de sistema.
  • Escreva uma função que programaticamente irá limpar o ecrã.
Estes métodos são descritos na seguinte secção "Mais informação".

Mais informações

Utilizar uma função de sistema

#include <stdlib.h>
void main()
{
system("cls");
}

Escrever uma função que programaticamente irá limpar o ecrã

A seguinte função limpa o ecrã:

 /* Standard error macro for reporting API errors */  #define PERR(bSuccess, api){if(!(bSuccess)) printf("%s:Error %d from %s \ 
on line %d\n", __FILE__, GetLastError(), api, __LINE__);}

void cls( HANDLE hConsole )
{
COORD coordScreen = { 0, 0 }; /* here's where we'll home the
cursor */
BOOL bSuccess;
DWORD cCharsWritten;
CONSOLE_SCREEN_BUFFER_INFO csbi; /* to get buffer info */
DWORD dwConSize; /* number of character cells in
the current buffer */

/* get the number of character cells in the current buffer */

bSuccess = GetConsoleScreenBufferInfo( hConsole, &csbi );
PERR( bSuccess, "GetConsoleScreenBufferInfo" );
dwConSize = csbi.dwSize.X * csbi.dwSize.Y;

/* fill the entire screen with blanks */

bSuccess = FillConsoleOutputCharacter( hConsole, (TCHAR) ' ',
dwConSize, coordScreen, &cCharsWritten );
PERR( bSuccess, "FillConsoleOutputCharacter" );

/* get the current text attribute */

bSuccess = GetConsoleScreenBufferInfo( hConsole, &csbi );
PERR( bSuccess, "ConsoleScreenBufferInfo" );

/* now set the buffer's attributes accordingly */

bSuccess = FillConsoleOutputAttribute( hConsole, csbi.wAttributes,
dwConSize, coordScreen, &cCharsWritten );
PERR( bSuccess, "FillConsoleOutputAttribute" );

/* put the cursor at (0, 0) */

bSuccess = SetConsoleCursorPosition( hConsole, coordScreen );
PERR( bSuccess, "SetConsoleCursorPosition" );
return;
}

Propriedades

ID do Artigo: 99261 - Última Revisão: 12/01/2017 - Revisão: 1

Comentários