Auf Englisch lesen

Freigeben über


CHAR_INFO-Struktur

Wichtig

In diesem Dokument werden Konsolenplattformfunktionen beschrieben, die nicht mehr Teil unserer Ökosystem-Roadmap sind. Wir empfehlen nicht, diesen Inhalt in neuen Produkten zu verwenden, aber wir werden weiterhin vorhandene Nutzungen für die unbegrenzte Zukunft unterstützen. Unsere bevorzugte moderne Lösung konzentriert sich auf virtuelle Terminalsequenzen für maximale Kompatibilität in plattformübergreifenden Szenarien. Weitere Informationen zu dieser Designentscheidung finden Sie in unserem klassischen Konsolendokument im Vergleich zum virtuellen Terminal .

Gibt ein Unicode- oder ANSI-Zeichen und dessen Attribute an. Diese Struktur wird von Konsolenfunktionen zum Lesen und Schreiben in einen Konsolenbildschirmpuffer verwendet.

Syntax

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

Member

Char
Eine Vereinigung der folgenden Mitglieder.

UnicodeChar
Unicode-Zeichen einer Bildschirmpuffer-Zeichenzelle.

AsciiChar
ANSI-Zeichen einer Bildschirmpuffer-Zeichenzelle.

Attribute
Die Zeichenattribute. Dieses Element kann null oder eine beliebige Kombination der folgenden Werte sein.

Wert Bedeutung
FOREGROUND_BLUE 0x0001 Die Textfarbe enthält Blau.
FOREGROUND_GREEN 0x0002 Die Textfarbe enthält Grün.
FOREGROUND_RED 0x0004 Die Textfarbe enthält Rot.
FOREGROUND_INTENSITY 0x0008 Die Textfarbe wird verstärkt.
BACKGROUND_BLUE 0x0010 Die Hintergrundfarbe enthält Blau.
BACKGROUND_GREEN 0x0020 Die Hintergrundfarbe enthält Grün.
BACKGROUND_RED 0x0040 Die Hintergrundfarbe enthält Rot.
BACKGROUND_INTENSITY 0x0080 Die Hintergrundfarbe wird verstärkt.
COMMON_LVB_LEADING_BYTE 0x0100 Führendes Byte.
COMMON_LVB_TRAILING_BYTE 0x0200 Schließendes Byte.
COMMON_LVB_GRID_HORIZONTAL 0x0400 Oben horizontal.
COMMON_LVB_GRID_LVERTICAL 0x0800 Links vertikal.
COMMON_LVB_GRID_RVERTICAL 0x1000 Rechts vertikal.
COMMON_LVB_REVERSE_VIDEO 0x4000 Umgekehrtes Vordergrund- und Hintergrundattribute.
COMMON_LVB_UNDERSCORE 0x8000 Unterstrich.

Beispiele

Ein Beispiel finden Sie unter "Scrollen des Inhalts eines Bildschirmpuffers".

Anforderungen

   
Unterstützte Mindestversion Client Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Header Winuser.h (einschließlich Windows.h)

Siehe auch

ReadConsoleOutput

ScrollConsoleScreenBuffer

WriteConsoleOutput