Mi lehet egy RC állományban?

Ha valamilyen képet, ikont, kurzort, vagy bármilyen más adatot bele akarunk fordítani egy exe állományba, vagy egy DLL-be, akkor erőforrás állományt kell készítenünk.

Első lépésben létre kell hoznunk egy *.rc állományt, amelyben felsoroljuk, hogy mely állományokat, milyen típussal és milyen névvel akarjuk felhasználni programunkban. Az egyes erőforrásokat külön sorokban kell megadnunk. Az állományt bármilyen szövegszerkesztő program segítségével létrehozhatjuk, a lényeg, hogy TEXT formátumú legyen.

Az RC állomány egy sora a legtöbb esetben az alábbi módon épül fel.

eyes ANIMCURSOR "eyes.ani"

Az első helyen egy olyan nevet kell megadnunk, amellyel programunkban akarjuk majd azonosítani az erőforrást. Ha az erőforrást befordítjuk majd, akkor csak ezen a néven keresztül tudjuk elérni.

A második paraméter az erőforrás típusa, a harmadik pedig a befordítandó állomány jelenlegi, fizikai neve. Néhány típus használata esetén a harmadik helyen nem állománynév szerepel, de van olyan is, ahol több paraméter is megadható.

Erőforrás típusok:

ACCELERATORS

Gyorsbillentyűk.

táblanév ACCELERATORS [opcionális_paraméterek] {esemény, azonosító, [típus] [opciók] ...;} 

Opcionális paraméterek:

Esemény: (a megadható karakter formátumát határozza meg)

Azonosító: A forróbillentyűt azonosító név.

Típus: Lehet: ASCII, VIRTKEY.

Opciók: A segédbillentyűk használatát teszi lehetővé. Használható értékek: ALT, SHIFT, CONTROL.

acc ACCELERATORS 
{
"^q", 1;
VK_F1, 2, VIRTKEY, ALT;
}

BITMAP

BMP kép.

azonosító BITMAP állománynév

CURSOR

Kurzor.

azonosító CURSOR állománynév

DIALOG

Dialógusablak.

azonosító DIALOG x, y, szélesség, magasság  [opcionális_paraméterek] {az_ablak_elemei ...}

x,y: Az ablak megjelenésének koordinátái.

Opcionális paraméterek:

d DIALOG 20, 20, 200, 100 
STYLE WS_POPUP | WS_BORDER
CAPTION "Kérdés"
{
    CTEXT "Select One:", 1, 10, 10, 280, 12
    PUSHBUTTON "&OK", 2, 75, 30, 60, 12
    PUSHBUTTON "&CANCEL", 3, 75, 50, 60, 12
}

DIALOGEX

A DIALOG erőforrás kiterjesztett változata.

azonosító DIALOGEX x, y, szélesség, magasság [, súgó_azonosító]] [[opcionális_paraméterek]]  {az_ablak_elemei . . .}

Az ablak a paraméterek tekintetében ugyanúgy működik, mint a DIALOG erőforrás.

Súgó_azonosító: Itt egy számot adhatunk meg, amely egy súgó oldalt azonosít az alkalmazásban.

FONT

Betűtípus.

azonosító FONT állománynév

ICON

Ikon.

azonosító ICON állománynév

MENU

Menü.

azonosító MENU [[opcionális_paraméterek]] {menü_elemek ...}

Azonosító: Egy szám, amely a menüt azonosítja.

Opcionális paraméterek:

m MENU
{
 MENUITEM "&Névjegy", 100
 POPUP "&Fájl"
 {
   MENUITEM "&Megnyitás", 200
   MENUITEM "&Mentés", 201
 }
 MENUITEM "&Kilépés", 102
}

MENUEX

A MENU erőforrás kiterjesztett változata.

azonosító MENUEX{ [{[MENUITEM elem [,[elem_azonosító][, [típus][, állapot]]]] |   [POPUP elem [,[elem_azonosító][, [típus][, [állapot][, súgó_azonosító]]]] {almenü_törzs} }...]}

Elem: A menü felirata.

Elem_azonosító: A menüelemet azonosító szám.

Típus: Egy szám, amely a menüelem típusát határozza meg.

Állapot: Egy szám, amely a menü állapotát határozza meg.

POPUP: A kulcsszó segítségével olyan menüelemet hozhatunk létre, amely tartalmaz további almenüpontokat is.

Súgó_azonosító: Egy szám, amely a menüponthoz rendelt súgót azonosítja.

Almenü_törzs: Az egyes menüpontokon belül almenüket is elhelyezhetünk. Ezeket beágyazott módon adhatjuk meg.

MESSAGETABLE

Üzenettábla.

azonosító MESSAGETABLE állománynév

POPUP

Olyan menüelem, amely tartalmaz további almenüpontokat is.

POPUP elem, [[Opciók]]{ elemek ...}

Elem: a menüpont felirata.

Opciók:

RCDATA

Adat.

azonosító RCDATA  [[opcionális_paraméterek]]  {adathalmaz ...}

Opcionális paraméterek:

Adathalmaz: Az adatsorozatot tartalmazza, mely lehet 0 végű sztring, karakter vagy szám. A számokat megadhatjuk 8-as, 10-es vagy 16-os számrendszerben. Sztringek megadása esetén a záró \0 tag megadásáról nekünk kell gondoskodnunk.

adatok RCDATA
{
 "Szöveg\0",
 625,
 1542 
}

STRINGTABLE

Sztring táblázat.

STRINGTABLE [[opcionális_paraméterek]] { azonosító szöveg ...}

Opcionális paraméterek:

Azonosító: Egy szám, amely a szöveget azonosítja.

Szöveg: Tetszőleges szöveg, amely maximum 4097 karakter hosszú lehet. A sortörés létrehozásához a \012 speciális karaktersorozatot használhatjuk.

STRINGTABLE
{
  1,   "Első sor"
  2, "Második sor"
}

User-Defined

Felhasználó által definiált típus. Itt bármilyen típusnevet megadhatunk, ami még nem lefoglalt név.

azonosító típus állománynév

VERSIONINFO

Verzióval kapcsolatos információk.

azonosító VERSIONINFO információk  { kifejezés_blokk ...}

Azonosító: értékének mindig 1-nek kell lennie.

Információk:

Ha elkészítettük az RC állományt, akkor a Delphi Bin alkönyvtárában található brcc32.exe program segítségével lefordíthatjuk azt egy RES kiterjesztésű erőforrás állománnyá.

brcc32.exe resoureces.rc

Ha a fordítás sikeresen megtörtént, akkor létrejön egy RES kiterjesztésű állomány, amely tartalmazza a megadott erőforrásokat. Ezt úgy tudjuk egy Delphi alkalmazásba vagy DLL-be befordítani, hogy az R fordítási direktíva után megadjuk a RES állomány nevét.

{$R resources.RES}

A mellékelt példaprogramban egy animált kurzorból készítettünk erőforrást.

Egy befordított erőforrást azonosításához ismernünk kell nevét és típusát. A mellékelt példában készítettünk egy függvényt, amely egy megadott erőforrást megkeres és TMemoryStream formájában eredményül ad.

function GetResource(rsName, rsType: String): TMemoryStream;

Egy erőforrást a FindResource függvény segítségével kereshetünk meg.

h:=FindResource(HInstance,PChar(rsName),PCHar(rsType));

Ha az erőforrás létezik, akkor a LoadResource függvénnyel lekérdezhetjük annak azonosítóját, a SizeOfResource függvénnyel pedig annak méretét.

r:=LoadResource(HInstance,h);
Si:=SizeOfResource(HInstance,r);

Létre kell hoznunk egy mutatót, amely a kiválasztott erőforrásra fog mutatni.

p:=LockResource(r);

Ezután az erőforrás tartalmát egy TMemoryStream segítségével, a függvény visszatérési értékeként átadhatjuk.

Stream:=TMemoryStream.Create;
Stream.Write(p^,Si);
Stream.Seek(0,soFromBeginning);
Result:=Stream;