Fichier ressource (Delphi)

Remonter à Liste des directives de compilation Delphi - Index

Type	Paramètre
Syntaxe	{$R <resfile> <predicates>} {$RESOURCE <resfile> <predicates>}
Portée	Locale

Remarques

La directive $R spécifie le nom d'un fichier de ressources à inclure dans une application ou une bibliothèque. Le nom doit être celui d'un fichier de ressources Windows et l'extension par défaut du fichier est .res. Pour spécifier un nom de fichier contenant un espace, entourez-le d'apostrophes : {$R 'My file'}.

Le symbole * a une signification spéciale dans les directives $R : il représente le nom de base (sans extension) du fichier code source où se trouve la directive. Généralement, le fichier ressource (.res) d'une application a le même nom que son fichier projet (.dpr) ; dans ce cas, l'inclusion de {$R *.res} provoque la liaison du fichier de ressources avec l'application. De même, un fichier fiche (.dfm ou .nfm) porte généralement le nom de son fichier unité (.pas) ; inclure {$R *.nfm} dans le fichier .pas permet de lier le fichier fiche à l'application.

<predicates> est un paramètre facultatif qui se compose d'une liste d'identificateurs séparés par des espaces ou des tabulations.

Si au moins un symbole est défini, la directive {$R <resfile>} est traitée. Si le symbole défini n'existe pas, cette directive est ignorée.

Lorsque la directive {$R <resfile>} est utilisée dans une unité, le nom de fichier spécifié est simplement mémorisé dans le fichier unité résultant. Aucune vérification n'est effectuée à ce point pour s'assurer que le nom est correct et que le fichier existe.

Lors de la liaison de l'application ou de la bibliothèque (après la compilation des fichiers source), les fichiers de ressources spécifiés dans toutes les unités utilisées ainsi que dans le programme ou la bibliothèque sont traités et chaque ressource de chaque fichier est copiée dans l'exécutable en cours de génération. Pendant la phase de traitement des ressources, le lieur recherche les fichiers .res dans le même répertoire que le module contenant la directive $R, puis dans les répertoires spécifiés dans la zone de saisie Chemin de recherche sur la page Répertoires/Conditions de la boîte de dialogue Projet|Options.