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_BLUE 0x0001 A cor do texto contém azul.
FOREGROUND_GREEN 0x0002 A cor do texto contém verde.
FOREGROUND_RED 0x0004 A cor do texto contém vermelho.
FOREGROUND_INTENSITY 0x0008 A cor do texto é intensificada.
BACKGROUND_BLUE 0x0010 A cor da tela de fundo contém azul.
BACKGROUND_GREEN 0x0020 A cor da tela de fundo contém verde.
BACKGROUND_RED 0x0040 A cor da tela de fundo contém vermelho.
BACKGROUND_INTENSITY 0x0080 A cor da tela de fundo é intensificada.
COMMON_LVB_LEADING_BYTE 0x0100 Byte à esquerda.
COMMON_LVB_TRAILING_BYTE 0x0200 Byte à direita.
COMMON_LVB_GRID_HORIZONTAL 0x0400 Parte superior horizontal.
COMMON_LVB_GRID_LVERTICAL 0x0800 Lado esquerdo vertical.
COMMON_LVB_GRID_RVERTICAL 0x1000 Lado direito vertical.
COMMON_LVB_REVERSE_VIDEO 0x4000 Inverter atributo de primeiro plano e da tela de fundo.
COMMON_LVB_UNDERSCORE 0x8000 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 para desktop]
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