Funzione SetConsoleActiveScreenBuffer

  • Articolo

Importante

Questo documento descrive le funzionalità della piattaforma della console che non fanno più parte della roadmap dell'ecosistema. Non è consigliabile usare questo contenuto nei nuovi prodotti, ma continueremo a supportare gli utilizzi esistenti per il futuro indefinito. La soluzione moderna preferita è incentrata sulle sequenze di terminale virtuale per garantire la massima compatibilità negli scenari multipiattaforma. Per altre informazioni su questa decisione di progettazione, vedere il documento relativo alla console classica e al terminale virtuale.

Imposta il buffer dello schermo specificato come buffer dello schermo della console attualmente visualizzato.

Sintassi

BOOL WINAPI SetConsoleActiveScreenBuffer(
  _In_ HANDLE hConsoleOutput
);

Parametri

hConsoleOutput [in]
Handle per il buffer dello schermo della console.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Osservazioni:

Una console può avere più buffer dello schermo. SetConsoleActiveScreenBuffer determina quale visualizzato. È possibile scrivere in un buffer dello schermo inattivo e quindi usare SetConsoleActiveScreenBuffer per visualizzare il contenuto del buffer.

Suggerimento

Questa API non è consigliata, ma ha un equivalente di terminale virtuale approssimativo nella sequenza di buffer dello schermo alternativo. L'impostazione del buffer dello schermo alternativo può fornire a un'applicazione uno spazio separato e isolato per il disegno nel corso del runtime di sessione mantenendo il contenuto visualizzato dall'invoker dell'applicazione. In questo modo vengono conservate le informazioni di disegno per un semplice ripristino all'uscita del processo.

Esempi

Per un esempio, vedere Lettura e scrittura di blocchi di caratteri e attributi.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione ConsoleApi2.h (tramite WinCon.h, includere Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedi anche

Funzioni della console

Buffer dello schermo della console

CreateConsoleScreenBuffer