Ressourcefile/de
Dieser Artikel behandelt ausschließlich Windows.
Siehe auch: Multiplatform Programming Guide/de
│
Deutsch (de) │
Dieser Artikel bezieht sich auf Lazarus Version 1.0.6 und höher.
Dieser Artikel beschäftigt sich mit der Windowsprogrammierung.
Dieser Artikel beschäftigt sich mit den Grundlagen von Ressourcen-Dateien.
Einleitung
Dieser Artikel beschreibt die Erstellung und Verwendung von Ressourcendateien speziell für die Programmierung unter Windows.
Als Beispiel dient das Einfügen von mehreren Ressourcen in das eigene Windowsprogramm.
Eine Ressourcendatei kann auf zwei Wege eingebunden werden:
- als Textdatei (*.rc)
- vorcompiliert als Binärdatei (*.res)
Schritt 1: Erstellen der Ressourcendatei als Textdatei
Zuerst müssen Sie sich einige Icons erstellen oder beschaffen. Das gleiche gilt für die Bitmap- und die Jpg-Datei.
Dann erstellen Sie mit einem Texteditor (z. B. Notepad) eine Datei mit der Endung .rc.
Die Ressourcendatei muss die Dateiendung .rc haben.
Diese Ressourcendatei öffnen Sie im Texteditor.
In diese Ressourcendatei tragen Sie die Icons nach folgendem Schema ein:
[Der Name unter dem das Icon in Ihrem Programm verwendet werden soll] [Ressourcentyp] [Name der einzubindenden Datei]
Beispiel für den Aufbau der Ressourcendatei:
MAINICON ICON "stern.ico" ZWEITES ICON "haus.ico" DRITTES ICON "blume.ico" VIERTES ICON "baeume.ico" HINTERGRUNDBMP BITMAP "Hintergrund.bmp" HINTERGRUNDJPG RCDATA "Hintergrund.jpg"
Vergessen Sie das Speichern der Datei nicht.
In diesem Beispiel heisst die Datei test.rc.
Möglichkeit 1: Verwenden der Ressourcendatei als Textdatei
Einbinden der Ressourcendatei als Textdatei
Die Ressourcendatei (test.rc) wird mit der Compilerdirektive $R in das Programm eingebunden.
unit ...;
{$mode objfpc}{$H+}
{$R test.rc}
...
interface
Möglichkeit 2: Verwenden der Ressourcendatei als Binärdatei
Dies ist nur unter Windows 32 Bit möglich, da nur dort der Ressourcen-Compiler windres.exe zum Lieferumfang gehört.
Compilieren der Ressourcendatei zur Binärdatei
Das Programm windres.exe gehört zum Lieferumfang von FreePascal.
Das Programm windres.exe ist ein Konsolenprogramm. Das heisst, das Programm windres hat keine grafische Oberfläche und wird an der Konsole bedient.
Das Programm windres.exe findet sich im Binärverzeichnis von Freepascal.
Das Programm windres.exe findet sich evtl. unter folgendem Pfad %ProgramFiles%\lazarus\fpc\2.6.0\bin\i386-win32.
Syntax:
windres -i [Eingabedatei] -o [Ausgabedatei]
Beispiel:
windres -i test.rc -o test.res
Einbinden der Ressourcendatei als Binärdatei
Die compilierte Ressourcendatei (test.res) wird mit der Compilerdirektive $R in das Programm eingebunden.
unit ...;
{$mode objfpc}{$H+}
{$R test.res}
...
interface
Verwenden der Ressource im eigenen Programmcode
Verwenden eines Icons
Im Beispiel wird das Icon haus.ico über seinen Alias ZWEITES dem Formular als Icon zugewiesen.
Form1.Icon.LoadFromResourceName(hInstance,'ZWEITES');
Mit dieser Vorgehensweise kann das Programm während der Programmlaufzeit beliebig oft ein anderes Icon anzeigen.
Verwenden einer Bitmap
Im Beispiel wird die Bitmap Hintergrund.bmp über ihren Alias HINTERGRUNDBMP einem TImage als Bild zugewiesen.
...
var
// deklarieren der Hilfsvariable
Bmp: TBitmap;
begin
...
// erstellt die Hilfsvariable
Bmp := TBitmap.Create;
try
// weist der Hilfsvariablen die Ressource zu
Bmp.LoadFromResourceName(HInstance, 'HINTERGRUNDBMP');
// weist den Inhalt der Hilfsvariablen dem Image zu
Form1.Image1.Picture.Assign(Bmp);
finally
// Freigabe der Hilfsvariable
FreeAndNil(Bmp);
end;
...
end;
Mit dieser Vorgehensweise kann das Programm während der Programmlaufzeit beliebig oft ein anderes Bild anzeigen.
Verwenden einer JPG-Datei (selbstdefinierte Resource)
Für die Konstante RT_RCDATA wird die Unit Windows benötigt.
Im Beispiel wird die Datei Hintergrund.jpg über ihren Alias HINTERGRUNDJPG einem TJPEGImage als Bild zugewiesen.
...
uses
Windows, ...
...
var
// deklarieren der Hilfsvariablen
JPGImage: TJPEGImage; // Hilfsvariable 1
RS: TResourceStream; // Hilfsvariable 2
begin
...
// erstellt die Hilfsvariable 1
JPGImage := TJPEGImage.Create;
try
// erstellt die Hilfsvariable 2 und weist ihr die Ressource zu
RS := TResourceStream.Create(hInstance, 'HINTERGRUNDJPG', RT_RCDATA);
try
// weist der Hilfsvariablen 1 den Inhalt der Hilfsvariablen 2 zu
JPGImage.LoadFromStream(RS);
// weist den Inhalt der Hilfsvariablen 1 dem Image zu
Form1.Image1.Picture.Assign(JPGImage);
finally
// Freigabe der Hilfsvariablen 2
FreeAndNil(RS);
end;
finally
// Freigabe der Hilfsvariablen 1
FreeAndNil(JPGImage);
end;
...
end;
Mit dieser Vorgehensweise kann das Programm während der Programmlaufzeit beliebig oft ein anderes Bild anzeigen.
--Olaf 09:38, 16 February 2013 (UTC)