Fonction GetConsoleFontSize
Important
Ce document décrit les fonctionnalités de la plateforme de la console qui ne font plus partie de la feuille de route de notre écosystème. Nous vous déconseillons d’utiliser ce contenu dans de nouveaux produits, mais nous continuerons à prendre en charge des utilisations existantes pour l’avenir indéterminé. Notre solution moderne préférée se concentre sur les séquences de terminaux virtuels pour une compatibilité maximale dans les scénarios multiplateformes. Vous trouverez plus d’informations sur cette décision de conception dans notre document sur les consoles classiques et les terminaux virtuels.
Récupère la taille de la police utilisée par la mémoire tampon de l’écran de la console spécifiée.
Syntaxe
COORD WINAPI GetConsoleFontSize(
_In_ HANDLE hConsoleOutput,
_In_ DWORD nFont
);
Paramètres
hConsoleOutput [entrée]
Un descripteur vers la mémoire tampon de l’écran de la console. Le descripteur doit avoir le droit d’accès GENERIC_READ. Pour plus d’informations, consultez Sécurité de la mémoire tampon et droits d’accès d’une console.
nFont [entrée]
L'index de la police dont la taille doit être récupérée. Cet index est obtenu en appelant la fonction GetCurrentConsoleFont.
Valeur renvoyée
Si la fonction aboutit, la valeur renvoyée est une structure COORD qui contient la largeur et la hauteur de chaque caractère de la police, en unités logiques. Le membre X contient la largeur, tandis que le membre Y contient la hauteur.
Si la fonction échoue, la largeur et la hauteur sont égales à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Notes
Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT sur 0x0500 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.
Conseil
Cette API n’est pas recommandée et n’a pas d’équivalent de terminal virtuel. Cette décision aligne intentionnellement la plateforme Windows avec d’autres systèmes d’exploitation où l’utilisateur dispose d’un contrôle total sur cette option de présentation. La communication à distance des applications via des utilitaires multiplateformes et des transports comme SSH peut ne pas fonctionner comme prévu si vous utilisez cette API.
Spécifications
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| En-tête | ConsoleApi3.h (via WinCon.h, include Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |