Funzione GetConsoleFontSize

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

Recupera le dimensioni del tipo di carattere utilizzato dal buffer dello schermo della console specificato.

Sintassi

COORD WINAPI GetConsoleFontSize(
  _In_ HANDLE hConsoleOutput,
  _In_ DWORD  nFont
);

Parametri

hConsoleOutput [in]
Handle per il buffer dello schermo della console. L'handle deve avere il diritto di accesso GENERIC_READ . Per altre informazioni, vedere Sicurezza dei buffer della console e diritti di accesso.

nFont [in]
Indice del tipo di carattere la cui dimensione deve essere recuperata. Questo indice viene ottenuto chiamando la funzione GetCurrentConsoleFont.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è una struttura COORD che contiene la larghezza e l'altezza di ogni carattere nel tipo di carattere, in unità logiche. Il membro X contiene la larghezza, mentre il membro Y contiene l'altezza.

Se la funzione ha esito negativo, la larghezza e l'altezza sono zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Osservazioni:

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0500 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

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

Vedi anche

Funzioni della console

Buffer dello schermo della console

COORD

GetCurrentConsoleFont