Typ Parameter
Gültigkeitsbereich {$R filename}
{$RESOURCE filename}{$R *.xxx}
{$R filename.RES filename.RC}
Gültigkeitsbereich Lokal
Anmerkungen
Die Direktive $R legt den Namen einer Ressourcendatei fest, die in eine Anwendung oder eine Bibliothek eingebunden werden soll. Dabei muß es sich um eine Windows-Ressourcendatei handeln. Die vorgegebene Namenserweiterung ist RES. Wenn der Dateiname ein Leerzeichen enthält, schließen Sie ihn in halbe Anführungszeichen ein: {$I 'Meine Datei'}.
Das Symbol * hat in $R-Direktiven eine spezielle Bedeutung. Es steht für den Namensstamm (ohne Erweiterung) der Quelltextdatei, in welcher die Direktive enthalten ist. In der Regel weist eine Ressourcendatei einer Anwendung (RES) denselben Namen auf wie die zugehörige Projektdatei (
DPR). In diesem Fall bewirkt die Verwendung von {$R *.RES} in der Projektdatei, daß die zugehörige Ressourcendatei mit der Anwendung verknüpft wird. Analog weist eine Formulardatei (.DFM) in der Regel denselben Namen auf wie ihre
Unit-Datei (
PAS); durch Verwendung von {$R *.DFM} in der
PAS-Datei wird die entsprechende Formulardatei mit der Anwendung verknüpft.
{$R Dateiname.RES Dateiname.RC} bewirkt, daß die RC-Datei in der Projektverwaltung von Delphi enthalten ist (hierzu müssen die beiden "Dateinamen" übereinstimmen). Wenn der Benutzer die RC-Datei von der Projektverwaltung aus aufruft, wird der Editor für String-Tabellen aufgerufen.
Wenn Sie die Direktive {$R Dateiname} in einer
Unit verwenden, wird der angegebene Dateiname einfach in der resultierenden
Unit-Datei gespeichert. Es wird zu diesem Zeitpunkt nicht geprüft, ob der Dateiname korrekt ist und eine vorhandene Datei bezeichnet.
Beim Linken einer Anwendung oder einer Bibliothek (nach dem Compilieren des Programms bzw. der Bibliotheksquelldatei) erfolgt die Verarbeitung aller Ressourcendateien, die in den benutzten Units und im Programm bzw. in der Bibliothek angegeben sind. Dabei werden die Ressourcen aller Ressourcendateien in die ausführbare Datei kopiert. Während der Ressourcenverarbeitung sucht der Linker von Delphi nach den RES-Dateien. Diese Suche erfolgt in dem Verzeichnis, in dem auch das Modul mit der Direktive $R liegt. Außerdem werden alle Verzeichnisse durchsucht, die im Eingabefeld Suchpfad der Registerkarte Verzeichnisse|Bedingungen im Dialogfeld Projektoptionen (bzw. mit der Option /R in der DCC32-Kommandozeile) festgelegt wurden.