Verwenden des Ressourcencompilers (RC-Befehlszeile)

  • Artikel

Verwenden Sie den folgenden Befehl, um RC zu starten.

RC [options] script-file

Der Parameter script-file gibt den Namen der Ressourcendefinitionsdatei an, die die Namen, Typen, Dateinamen und Beschreibungen der zu kompilierenden Ressourcen enthält.

RC kann separate Ressourcendateien für Anwendungen generieren, die sowohl sprachneutrale als auch sprachspezifische Ressourcen haben. Entwickler können eine Ressourcenkonfigurationsdatei verwenden oder Befehlszeilenoptionen festlegen, um auszuwählen, welche Ressourcentypen und Elemente nicht lokalisierbare Ressourcen der sprachneutralen Datei (LN) sind und welche lokalisierbaren Ressourcen sprachspezifische MUI-Dateien sind. Weitere Informationen finden Sie unter Mehrsprachige Benutzeroberfläche.

Der Parameter options kann eine oder mehrere der folgenden Befehlszeilenoptionen sein.

Optionen

/?

Zeigt eine Liste der Befehlszeilenoptionen an.

/c

Definiert eine von der NLS-Konvertierung verwendete Codepage.

/d

Definiert ein Symbol für den Präprozessor, den Sie mit der Anweisung #ifdef testen können.

/fm mresname

RC erstellt eine sprachneutrale .RES-Datei und eine sprachabhängige (MUI) .RES-Datei mit script-file. Diese Option muss zusammen mit der Option /fo resname verwendet werden. RC benennt die sprachneutrale .RES-Datei resname.res und die sprachabhängige (MUI) .RES-Datei mresname.res.

Windows Server 2003 und Windows XP/2000: Diese Option ist nur verfügbar, wenn Sie auch die Funktionen LoadMUILibrary und FreeMUILibrary in einem aktualisierten System verwenden.

/fo resname

RC erstellt eine .RES-Datei mit dem Namen resname mithilfe von script-file.

Wenn auch die Option /fm mresname festgelegt ist, erstellt RC eine sprachneutrale .RES-Datei und eine sprachabhängige (MUI) .RES-Datei.

Windows Server 2003 und Windows XP/2000: Diese Option ist nur verfügbar, wenn Sie auch die Funktionen LoadMUILibrary und FreeMUILibrary in einem aktualisierten System verwenden.

/g1

Wenn /g1 festgelegt ist, generiert RC eine MUI-Datei, wenn die einzige lokalisierbare Ressource, die in der MUI-Datei enthalten ist, eine Versionsressource ist. Wenn /g1 nicht festgelegt ist, generiert RC keine MUI-Datei, wenn die einzige in der MUI-Datei enthaltene lokalisierbare Ressource eine Versionsressource ist.

/h

Zeigt die Liste der Befehlszeilenoptionen an.

/I

Durchsucht das angegebene Verzeichnis, bevor die durch die INCLUDE-Umgebungsvariable angegebenen Verzeichnisse durchsucht werden.

/j loctype

Lokalisierbare Ressourcentypen werden von RC in die sprachabhängige (MUI) .RES-Datei eingefügt. Wenn auch die Option /q festgelegt ist, wird diese Option ignoriert, und die Informationen in der RC-Konfigurationsdatei haben Vorrang.

Windows Server 2003 und Windows XP/2000: Diese Option ist nur verfügbar, wenn Sie auch die Funktionen LoadMUILibrary und FreeMUILibrary in einem aktualisierten System verwenden.

/k overtype

Überlappende Ressourcentypen, die RC sowohl in die sprachneutralen .RES-Dateien als auch in die sprachabhängigen (MUI).RES-Dateien einfügt. Die von der Option /k angegebenen Ressourcentypen müssen eine Teilmenge der Ressourcen sein, die durch die Option /j angegeben werden. Beispielsweise gibt ?J2 ?J3 ?K3 an, dass RC den Ressourcentyp 3 sowohl in den sprachneutralen als auch in den sprachabhängigen (MUI) Dateien platziert. Wenn auch die Option /q festgelegt ist, wird diese Option ignoriert, und die Informationen in der RC-Konfigurationsdatei haben Vorrang.

Windows Server 2003 und Windows XP/2000: Diese Option ist nur verfügbar, wenn Sie auch die Funktionen LoadMUILibrary und FreeMUILibrary in einem aktualisierten System verwenden.

/l langid

Gibt die Standardsprache für die Kompilierung an. Beispiel: -l409 entspricht dem Einbeziehen der folgenden Anweisung oben in der Ressourcenskriptdatei: LANGUAGE LANG_ENGLISH,SUBLANG_ENGLISH_US

Weitere Informationen finden Sie unter Sprachbezeichner.

/n

Alle Zeichenfolgen in der Zeichenfolgentabelle werden mit Null beendet.

/q Mui.RCConfig

Eine RC-Konfigurationsdatei, die dem RC-Konfigurationsdateiformat folgt. Das RC-Konfigurationsdateiformat ermöglicht Komponenten die Selbstbeschreibung von Ressourceninformationen wie Ressourcenversionierung, MUI-Dateipfad, Ressourcentypen und -elementen. Diese Datei gibt an, welche Ressourcen in die sprachneutrale .RES-Datei und welche in die sprachabhängige (MUI) .RES-Datei aufgenommen werden. Diese Option und die in der RC-Konfigurationsdatei bereitgestellten Informationen überschreiben die Befehlszeilenoptionen /j und /k.

Windows Server 2003 und Windows XP/2000: Diese Option ist nur verfügbar, wenn Sie auch die Funktionen LoadMUILibrary und FreeMUILibrary in einem aktualisierten System verwenden.

/r

Ignoriert. Aus Gründen der Kompatibilität mit vorhandenen Makefiles bereitgestellt.

/u

Hebt die Definition eines Symbols für den Präprozessor auf.

/v

Zeigt Meldungen an, die über den Fortschritt des Compilers informieren.

/x

Verhindert, dass RC bei der Suche nach Header- oder Ressourcendateien die Umgebungsvariable INCLUDE überprüft.

Hinweise

Bei den Optionen muss die Groß-/Kleinschreibung nicht beachtet werden. Anstelle eines Schrägstrichs (/) kann ein Bindestrich (-) verwendet werden. Sie können Optionen mit einem Buchstaben kombinieren, wenn keine zusätzlichen Parameter erforderlich sind.

RC generiert in den folgenden Fällen keine MUI-Datei.

  • In der .rc-Datei sind keine lokalisierbaren Ressourcen vorhanden.
  • Die einzige in der RC-Datei angegebene Ressourcensprachen-ID ist neutral (0x0).
  • Die .rc-Datei verfügt über Ressourcen, die in mehr als einer Sprache angegeben sind. Die Ausnahme ist, wenn die RC-Datei zwei Sprachen enthält und eine Sprache neutral (0x0) ist. In diesem Fall generiert RC eine MUI-Datei.

Weitere Informationen finden Sie in den folgenden Themen:

Multilingual User Interface