Compartilhar via


Estrutura CHAR_INFO

Importante

Este documento descreve a funcionalidade da plataforma de console que não faz mais parte do nosso roteiro do ecossistema. Não recomendamos o uso desse 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 de multiplataforma. Você pode encontrar mais informações sobre essa decisão de design em nosso documento Console clássico 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 de caracteres. Esse membro pode ser zero ou uma 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 da tela de fundo contém azul.
BACKGROUND_GREEN0x0020 A cor da tela de fundo contém verde.
BACKGROUND_RED0x0040 A cor da tela de fundo contém vermelho.
BACKGROUND_INTENSITY0x0080 A cor da tela de fundo é intensificada.
COMMON_LVB_LEADING_BYTE0x0100 Byte à esquerda.
COMMON_LVB_TRAILING_BYTE0x0200 Byte à direita.
COMMON_LVB_GRID_HORIZONTAL0x0400 Parte superior horizontal.
COMMON_LVB_GRID_LVERTICAL0x0800 Lado esquerdo vertical.
COMMON_LVB_GRID_RVERTICAL0x1000 Lado direito vertical.
COMMON_LVB_REVERSE_VIDEO0x4000 Inverter atributo de primeiro plano e da tela de fundo.
COMMON_LVB_UNDERSCORE0x8000 Sublinhado.

Exemplos

Para obter um exemplo, consulte Rolar pelo conteúdo de um buffer de tela.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho WinCon.h (inclui Windows.h)

Confira também

ReadConsoleOutput

ScrollConsoleScreenBuffer

WriteConsoleOutput