Funzione SetConsoleDisplayMode
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 la modalità di visualizzazione del buffer dello schermo della console specificato.
Sintassi
BOOL WINAPI SetConsoleDisplayMode(
_In_ HANDLE hConsoleOutput,
_In_ DWORD dwFlags,
_Out_opt_ PCOORD lpNewScreenBufferDimensions
);
Parametri
hConsoleOutput [in]
Handle per il buffer dello schermo della console.
dwFlags [in]
Modalità di visualizzazione della console. Questo parametro può essere uno o più dei valori seguenti.
| valore | Significato |
|---|---|
| CONSOLE_FULLSCRedizione EnterpriseN_MODE 1 | Il testo viene visualizzato in modalità schermo intero. |
| CONSOLE_WINDOWED_MODE 2 | Il testo viene visualizzato in una finestra della console. |
lpNewScreenBufferDimensions [out, facoltativo]
Puntatore a una struttura COORD che riceve le nuove dimensioni del buffer dello schermo, in caratteri.
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:
Suggerimento
Questa API non è consigliata e non ha un terminale virtuale equivalente. Questa decisione allinea intenzionalmente la piattaforma Windows ad altri sistemi operativi in cui all'utente viene concesso il controllo completo su questa opzione di presentazione. Le applicazioni remote tramite utilità multipiattaforma e trasporti come SSH potrebbero non funzionare come previsto se si usa questa API.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Intestazione | ConsoleApi3.h (tramite WinCon.h, includere Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |