Bezeichnung
SetConsoleColor -- legt die Konsolenfarbe fest (V10.0)
Übersicht
SetConsoleColor(pen[, fgcolor, bgcolor])
Plattformen
Linux, macOS, Windows

Beschreibung
Mit diesem Befehl kann der angegebene Stift als Textstift eingestellt werden. Wenn auch die Argumente fgcolor und bgcolor angegeben werden, wird der Stift mit den in fgcolor und bgcolor übergebenen Farben initialisiert, bevor er zum Textstift wird. Dies ist nur möglich, wenn die Stiftnummer größer als 0 ist. Stift 0 ist für die Standardtextfarbe reserviert. Wenn Sie also 0 in pen übergeben, werden fgcolor und bgcolor ignoriert und die Textfarbe wird auf die Standardtextfarbe der Konsole zurückgesetzt.

Die Anzahl der verfügbaren Stifte hängt von der Konsole ab. Normalerweise sind 256 Stifte verfügbar, was bedeutet, dass die höchste Stiftnummer, die Sie verwenden können, 255 ist. Für die beste Kompatibilität sollten Sie jedoch niedrigere Stiftnummern verwenden, da möglicherweise nicht alle Konsolen 256 Stifte haben.

Die Argumente fgcolor und bgcolor können entweder RGB-Werte oder Farben sein, die mit AllocConsoleColor() zugewiesen werden. Beachten Sie, dass standardmäßig nur wenige Farben verfügbar sind und ohne Zuordnung in fgcolor oder bgcolor übergeben werden können. Diese sind: #BLACK, #WHITE, #RED, #GREEN, #BLUE, #YELLOW, #AQUA (Cyan) und #FUCHSIA (Magenta). Wenn Sie andere Farben verwenden möchten, müssen Sie diese zuerst mit AllocConsoleColor() zuweisen. Siehe AllocConsoleColor für Details.

Beachten Sie, dass Terminals möglicherweise eine abgedunkelte Version der hier angegebenen Farben verwenden. Seien Sie also nicht überrascht, wenn Ihre Farbe grau erscheint, obwohl Sie Weiß angegeben haben. Viele Terminals sind so konfiguriert, dass sie Grau als Weiß behandeln. Wenn Sie dies vermeiden möchten, weisen Sie benutzerdefinierte Farben mit AllocConsoleColor() zu.

Um die Vorder- und Hintergrundfarbe eines Stifts zu initialisieren, ohne ihn zum aktiven Textstift zu machen, können Sie den Befehl InitConsoleColor() verwenden. Siehe InitConsoleColor für Details.

Sie müssen den erweiterten Konsolenmodus mit EnableAdvancedConsole() aktivieren, bevor Sie diesen Befehl verwenden können. Siehe EnableAdvancedConsole für Details.

Eingaben
pen
zu verwendender Farbstift oder 0, um die Textfarbe auf die Standardwerte zurückzusetzen
fgcolor
optional: gewünschte Vordergrundfarbe für den Stift; dies muss entweder eine RGB-Farbe aus der obigen Liste oder eine durch AllocConsoleColor() zugewiesene Farbe sein (Standardwert ist #NOCOLOR)
bgcolor
optional: gewünschte Vordergrundfarbe für den Stift; dies muss entweder eine RGB-Farbe aus der obigen Liste oder eine durch AllocConsoleColor() zugewiesene Farbe sein (Standardwert ist #NOCOLOR)
Beispiel
EnableAdvancedConsole()
SetConsoleStyle(#CONSOLESTYLE_BOLD)
SetConsoleColor(1, #BLACK, #WHITE)
ConsolePrint("Hello World")
RefreshConsole()
Der obige Code gibt die Zeichenkette "Hello World" in Schwarz auf weißem Hintergrund aus.

Navigation zeigen