Delphi - TIBUninstall komponens

Interbase 22. rész

forráskód letöltése
Eltávolítást végző programokban a TIBUninstall komponenst használhatjuk. A komponens tulajdonságai, metódusai és eseményei nagyon hasonlítanak a sorozatban már megismert TIBInstall komponenséhez. Először meg kell határoznunk, hogy hol található a szerver, valamint az eltávolításhoz szükséges információkat tartalmazó ibunins.xxx fájl. (xxx helyére egy háromjegyű számot kell helyettesíteni az installációk számától függően.) Beállíthatjuk, hogy a folyamat során milyen üzeneteket lásson a felhasználó. Az UnInstallCheck metódus segítségével ellenőrizhetjük, hogy mindent helyesen állítottunk-e be. A törlési folyamat elindításához meg kell hívnunk az UnInstallExecute parancsot.

Tulajdonságok
  • MsgFilePath azt a könyvtárat állítja be vagy adja vissza értékként, amelyikben az ibinstall.msg fájl megtalálható.
  • Progress tulajdonság egy 0 és 100 közzé eső egész számot ad vissza, amelyik arról tájékoztat, hogy az eltávolítás hány százalékán van már túl a program. Értékét egy folyamatsávon keresztül jelezhetjük a felhasználó felé.
  • RebootToComplete tulajdonság igaz értéke jelzi, ha az eltávolítás végén a gépet újra kell indítani. Alapértelmezett értéke: hamis. Megjegyzendő, hogy a dokumentáció szerint ez a tulajdonság írható és olvasható, ha azonban a forráskódban meg szeretnénk változtatni értékét, fordítási hibával leállna a fordító.
  • UnInstallFile visszatér az uninstall fájl nevével és elérési útvonalával, amelyik a program eltávolításához szükséges és a telepítés beállításait tartalmazza.

Metódusok
  • UnInstallCheck: ellenőrizhetjük azt, hogy minden készen áll-e az eltávolítás megkezdéséhez.
  • UnInstallExecute: az eltávolítás folyamatát végrehajtó metódus.

Események
OnError: Ez az esemény akkor következik be, amikor hiba történik az eltávolítás folyamán. A visszatérési értékkel határozhatjuk meg, hogy mi történjen:
  • srContinue: folytatódjon,
  • srRetry: próbálja újra,
  • srAbort: a fejeződjön be az eltávolítás.

OnStatusChange: Az esemény bekövetkezik, amikor az eltávolítás állapotában változás történik. Ez az esemény időről-időre bekövetkezik miután meghívtuk az UnInstallExecute metódust. Itt tájékoztathatjuk a felhasználót az eltávolítás folyamatáról. A StatusComment paramétert használhatjuk szöveges tájékoztatásra. Ebben az eseményben frissíthetjük programunk állapotsávját a komponens Progress tulajdonságát felhasználva.

OnWarning: Az esemény akkor következik be, amikor az eltávolítás folyamán valamilyen figyelmeztetés keletkezik valamilyen ok miatt. A függvény visszatérési értéke vagy srContinue vagy srAbort lehet. A figyelmeztetést kiváltó okra a WarningCode és a WarningMessage paraméterekből következtethetünk.


Interbase cikksorozat