CHAR_INFO, structure

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.

Spécifie un caractère Unicode ou ANSI et ses attributs. Cette structure est utilisée par les fonctions de console pour lire et écrire dans une mémoire tampon de l’écran de la console.

Syntaxe

typedef struct _CHAR_INFO {
  union {
    WCHAR UnicodeChar;
    CHAR  AsciiChar;
  } Char;
  WORD  Attributes;
} CHAR_INFO, *PCHAR_INFO;

Membres

Char
Une union des membres suivants.

UnicodeChar
Caractère Unicode d’une cellule de caractère de mémoire tampon d’écran.

AsciiChar
Caractère ANSI d’une cellule de caractère de mémoire tampon d’écran.

Attributs
Les attributs de caractères. Ce membre peut être égal à zéro ou à n’importe quelle combinaison des valeurs suivantes.

Valeur Signification
FOREGROUND_BLUE 0x0001 La couleur du texte contient du bleu.
FOREGROUND_GREEN 0x0002 La couleur du texte contient du vert.
FOREGROUND_RED 0x0004 La couleur du texte contient du rouge.
FOREGROUND_INTENSITY 0x0008 La couleur du texte est intensifiée.
BACKGROUND_BLUE 0x0010 La couleur d’arrière-plan contient du bleu.
BACKGROUND_GREEN 0x0020 La couleur d’arrière-plan contient du vert.
BACKGROUND_RED 0x0040 La couleur d’arrière-plan contient du rouge.
BACKGROUND_INTENSITY 0x0080 La couleur d’arrière-plan est intensifiée.
COMMON_LVB_LEADING_BYTE 0x0100 Octet de début.
COMMON_LVB_TRAILING_BYTE 0x0200 Octet de fin.
COMMON_LVB_GRID_HORIZONTAL 0x0400 Supérieur horizontal.
COMMON_LVB_GRID_LVERTICAL 0x0800 Gauche vertical.
COMMON_LVB_GRID_RVERTICAL 0x1000 Droite vertical.
COMMON_LVB_REVERSE_VIDEO 0x4000 Inverse l’attribut du premier plan et de l’arrière-plan.
COMMON_LVB_UNDERSCORE 0x8000 Caractère de soulignement.

Exemples

Pour obtenir un exemple, consultez la section Défilement du contenu d’une mémoire tampon d’écran.

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 WinCon.h (include Windows.h)

Voir aussi

ReadConsoleOutput

ScrollConsoleScreenBuffer

WriteConsoleOutput