Condividi tramite


Funzione GetLargestConsoleWindowSize

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.

Recupera le dimensioni della finestra della console più grande possibile, in base al tipo di carattere corrente e alle dimensioni dello schermo.

Sintassi

COORD WINAPI GetLargestConsoleWindowSize(
  _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 è una struttura COORD che specifica il numero di colonne di celle di caratteri (membro X ) e righe (membro Y ) nella finestra della console più grande possibile. In caso contrario, i membri della struttura sono zero.

Per informazioni dettagliate sull'errore, chiamare GetLastError.

Osservazioni:

La funzione non prende in considerazione le dimensioni del buffer dello schermo della console, il che significa che le dimensioni della finestra restituite possono essere maggiori delle dimensioni del buffer dello schermo della console. La funzione GetConsoleScreenBufferInfo può essere usata per determinare le dimensioni massime della finestra della console, in base alle dimensioni correnti del buffer dello schermo, al tipo di carattere corrente e alle dimensioni di visualizzazione.

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 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

COORD

GetConsoleScreenBufferInfo

SetConsoleWindowInfo

Dimensioni buffer finestra e schermo