struttura CHAR_INFO

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

Specifica un carattere Unicode o ANSI e i relativi attributi. Questa struttura viene usata dalle funzioni della console per leggere e scrivere in un buffer dello schermo della console.

Sintassi

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

Membri

Char
Unione dei membri seguenti.

UnicodeChar
Carattere Unicode di una cella di caratteri del buffer dello schermo.

AsciiChar
Carattere ANSI di una cella di caratteri del buffer dello schermo.

Attributi
Attributi di carattere. Questo membro può essere zero o qualsiasi combinazione dei valori seguenti.

Valore Significato
FOREGROUND_BLUE 0x0001 Il colore del testo contiene il blu.
FOREGROUND_GREEN 0x0002 Il colore del testo contiene il verde.
FOREGROUND_RED 0x0004 Il colore del testo contiene il rosso.
FOREGROUND_INTENSITY 0x0008 Il colore del testo è accentuato.
BACKGROUND_BLUE 0x0010 Il colore di sfondo contiene il blu.
BACKGROUND_GREEN 0x0020 Il colore di sfondo contiene il verde.
BACKGROUND_RED 0x0040 Il colore di sfondo contiene il rosso.
BACKGROUND_INTENSITY 0x0080 Il colore di sfondo è accentuato.
COMMON_LVB_LEADING_BYTE 0x0100 Byte iniziale.
COMMON_LVB_TRAILING_BYTE 0x0200 Byte finale.
COMMON_LVB_GRID_HORIZONTAL 0x0400 Orizzontale superiore.
COMMON_LVB_GRID_LVERTICAL 0x0800 Verticale sinistro.
COMMON_LVB_GRID_RVERTICAL 0x1000 Verticale destro.
COMMON_LVB_REVERSE_VIDEO 0x4000 Inverti primo piano e attributo di sfondo.
COMMON_LVB_UNDERSCORE 0x8000 Sottolineatura.

Esempi

Per un esempio, vedere Scorrimento del contenuto di un buffer dello schermo.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione WinCon.h (include Windows.h)

Vedi anche

ReadConsoleOutput

ScrollConsoleScreenBuffer

WriteConsoleOutput