BRCC32.EXE: Der Ressourcen-Compiler

Nach oben zu Befehlszeilenhilfsprogramme - Index

BRCC32 ist die Befehlszeilenversion des Ressourcen-Compilers. Er verarbeitet eine Ressourcen-Skriptdatei (.RC) und erzeugt daraus eine Ressourcendatei mit Objektcode (.RES).

RAD Studio ermöglicht die Auswahl eines Ressourcen-Compilers. Sie können einen der beiden folgenden Compiler auswählen:

• BRCC32
• RC.EXE (der Ressourcen-Compiler von Windows SDK)

Sie wählen den Compiler im Dialogfeld Projekt > Optionen > Ressourcen-Compiler aus. Wenn Sie den Ressourcen-Compiler von Windows SDK auswählen, wird der Zwischen-Compiler CGRC.EXE aufgerufen, aber CGRC ruft seinerseits RC.EXE auf.

In der Befehlszeile können Sie aber einen der drei Ressourcen-Compiler verwenden:

• BRCC32.EXE
• CGRC.EXE
• RC.EXE

Befehlszeilensyntax

BRCC32 [<Optionen>] <Dateiname>.RC

Befehlszeilenelemente

Element	Beschreibung
<Optionen>	Befehlszeilenoptionen. Optional.
<Dateiname>.RC	Definiert eine Ressourcen-Skriptdatei (.RC), die compiliert werden soll. Diese Datei muss angegeben werden.

Um die Hilfe für die Befehlszeile anzuzeigen, geben Sie Folgendes ein:

brcc32

Oder fügen Sie das Hilfe-Flag hinzu:

brcc32 -h

Befehlszeilenoptionen

BRCC32.EXE unterstützt die in der folgenden Tabelle aufgeführten Befehlszeilenoptionen:

Befehlszeilenoptionen für BRCC32

Option	Beschreibung
-h oder ?	Zeigt die Hilfemeldung an.
@<Resp-Datei>	Übernimmt Anweisungen aus der angegebenen Befehlsdatei.
-c<Codeseite>	Verwendet die angegebene Codeseite Codeseite zur Ressourcenübersetzung. Wenn -c nicht angegeben ist, wird die ANSI-Codeseite benutzt.
-d<Name>[=<String>]	Definiert das Präprozessorsymbol Name, das Sie mit der C++-Präprozessordirektive #IFDEF Name testen können.
-fo<Dateiname>	Definiert den Namen für die Ausgaberessourcendatei (.RES). (Standardmäßig erstellt BRCC32 die Ausgabedatei (.RES) mit demselben Namen wie die Eingabedatei (.RC)).
-i<Pfad>	Fügt ein oder mehrere Verzeichnisse (Pfad getrennt durch Semikolon) zum Suchpfad für Include-Dateien hinzu. Zum Beispiel: -i"c:\RAD Studio\lib\debug";C:\MyUnits
-l<Sprache>	Legt die Standardsprache fest.
-m	Gibt an, dass die Codeseite, die mit der Option -c vorgegeben wurde, DBCS-Zeichen (Double-Byte Character Set) enthält.
-r	Diese Option wird ignoriert. Sie dient nur der Kompatibilität zu anderen Ressourcen-Compilern.
-v	Gibt während des Compilierens Statusmeldungen (Verbose) aus.
-x	Löscht den aktuellen Include-Pfad.
-16	Erzeugt mit 16-Bit-Windows kompatible Ressourcendateien (.RES).
-32	Erzeugt mit 32-Bit-Windows kompatible .RES- und .EXE-Dateien. Dies ist die Vorgabeoption.

BRCC32 führt die Vordefinition der gängigsten ressourcenspezifischen Windows-Konstanten, wie WS_VISIBLE und BS_PUSHBUTTON, aus. Außerdem werden zwei spezielle Compiler-Symbole definiert: RC_INVOKED und WORKSHOP_INVOKED. Diese Symbole können im Quelltext in Verbindung mit bedingten Präprozessor-Direktiven verwendet werden, um die Compilierung zu steuern.

Beispielsweise kann die Compilierung mit dem folgenden Konstrukt erheblich beschleunigt werden:

#ifndef WORKSHOP_INVOKED
#include "windows.h" 
#endif 

Abwärtskompatibilität

Die folgende Syntax und die folgenden Optionen werden aus Gründen der Abwärtskompatibilität unterstützt:

Option	Beschreibung
-31	Erzeugt mit Windows 3.1 kompatible Ressourcendateien (.RES).
-w32	Erzeugt mit Win32 kompatible Ressourcendateien (.RES).

Siehe auch

• BRC32.EXE: Die Ressourcen-Shell
• RC.EXE: Der Ressourcen-Compiler des Microsoft SDK
• CGRC.EXE: Der Ressourcen-Compiler-Binder