Fonction GetLargestConsoleWindowSize
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 plus grande fenêtre de console possible, en fonction de la police actuelle et de la taille de l'écran.
Syntaxe
COORD WINAPI GetLargestConsoleWindowSize(
_In_ HANDLE hConsoleOutput
);
Paramètres
hConsoleOutput [entrée]
Un descripteur vers la mémoire tampon de l’écran de la console.
Valeur renvoyée
Si la fonction aboutit, la valeur renvoyée est une structure COORD qui spécifie le nombre de colonnes (membre X) et de lignes (membre Y) de cellules de caractères dans la plus grande fenêtre de console possible. Dans le cas contraire, les membres de la structure prennent la valeur zéro.
Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Notes
La fonction ne tient pas compte de la taille de la mémoire tampon de l'écran de la console, ce qui signifie que la taille de la fenêtre renvoyée peut être supérieure à la taille de la mémoire tampon de l'écran de la console. La fonction GetConsoleScreenBufferInfo peut être utilisée pour déterminer la taille maximale de la fenêtre de console, compte tenu de la taille actuelle de la mémoire tampon de l'écran, de la police actuelle et de la taille de l'affichage.
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 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | ConsoleApi2.h (via WinCon.h, include Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |