Fonction SetConsoleScreenBufferInfoEx
Important
Ce document décrit les fonctionnalités de la plateforme de console qui ne font plus partie de notre feuille de route de l’é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 terminal virtuel pour une compatibilité maximale dans les scénarios multiplateformes. Vous trouverez plus d’informations sur cette décision de conception dans notre document console classique versus terminal virtuel.
Définit des informations étendues sur la mémoire tampon d’écran de la console spécifiée.
Syntaxe
BOOL WINAPI SetConsoleScreenBufferInfoEx(
_In_ HANDLE hConsoleOutput,
_In_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);
Paramètres
hConsoleOutput [entrée]
Handle vers la mémoire tampon d’écran de console. Le handle doit avoir le droit d’accès GENERIC_WRITE. Pour plus d’informations, consultez Sécurité de la mémoire tampon et droits d’accès d’une console.
lpConsoleScreenBufferInfoEx [entrée]
Un structure CONSOLE_SCREEN_BUFFER_INFOEX qui contient les informations de mémoire tampon de l’écran de la console.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Notes
Conseil
Cette API a un équivalent partiel au terminal virtuel. La mémoire tampon de positionnement du curseur et les attributs de texte ont des équivalents de séquence spécifiques. La table de couleurs n’est pas configurable, mais des couleurs étendues sont disponibles au-delà de ce qui est normalement disponible via les fonctions de la console. Les attributs de fenêtre contextuelle n’ont pas d’équivalent, car les menus contextuels sont la responsabilité de l’application cliente de ligne de commande dans le monde du terminal virtuel. Enfin, la taille de la fenêtre et l’état du plein écran sont considérés comme des privilèges appartenant à l’utilisateur dans le monde du terminal virtuel et n’ont aucune séquence équivalente.
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | ConsoleApi2.h (via WinCon.h, inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |