estrutura CHAR_INFO

Importante

Este documento descreve a funcionalidade da plataforma de console que não faz mais parte do nosso roteiro de ecossistema. Não recomendamos o uso deste conteúdo em novos produtos, mas continuaremos a oferecer suporte aos usos existentes por tempo indeterminado. Nossa solução moderna preferida se concentra em sequências de terminais virtuais para máxima compatibilidade em cenários multiplataforma. Você pode encontrar mais informações sobre essa decisão de design em nosso documento clássico de console versus terminal virtual.

Especifica um caractere Unicode ou ANSI e seus atributos. Essa estrutura é usada pelas funções do console para ler e gravar em um buffer de tela do console.

Sintaxe

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

Membros

Char
Uma união dos seguintes membros:

UnicodeChar
Caractere Unicode de uma célula de caractere de buffer de tela.

AsciiChar
Caractere ANSI de uma célula de caractere de buffer de tela.

Atributos
Os atributos do personagem. Este membro pode ser zero ou qualquer combinação dos seguintes valores.

Valor	Significado
FOREGROUND_BLUE0x0001	A cor do texto contém azul.
FOREGROUND_GREEN0x0002	A cor do texto contém verde.
FOREGROUND_RED0x0004	A cor do texto contém vermelho.
FOREGROUND_INTENSITY0x0008	A cor do texto é intensificada.
BACKGROUND_BLUE0x0010	A cor de fundo contém azul.
BACKGROUND_GREEN0x0020	A cor de fundo contém verde.
BACKGROUND_RED0x0040	A cor de fundo contém vermelho.
BACKGROUND_INTENSITY0x0080	A cor de fundo é intensificada.
COMMON_LVB_LEADING_BYTE0x0100	Byte principal.
COMMON_LVB_TRAILING_BYTE0x0200	Byte à direita.
COMMON_LVB_GRID_HORIZONTAL0x0400	Parte superior horizontal.
COMMON_LVB_GRID_LVERTICAL0x0800	Vertical esquerda.
COMMON_LVB_GRID_RVERTICAL0x1000	Vertical direita.
COMMON_LVB_REVERSE_VIDEO0x4000	Inverter o atributo de primeiro plano e plano de fundo.
COMMON_LVB_UNDERSCORE0x8000	Sublinhar.

Exemplos

Para obter um exemplo, consulte Rolando o conteúdo de um buffer de tela.

Requerimentos

Cliente mínimo suportado	Windows 2000 Professional [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado	Windows 2000 Server [apenas aplicações de ambiente de trabalho]
Cabeçalho	WinCon.h (inclui Windows.h)

Ver também

ReadConsoleOutput

ScrollConsoleScreenBuffer

WriteConsoleOutput