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) |