IConfig

Aus Sceneo Wiki

Diese Schnittstelle bietet Zugriff auf die PlugIn Konfigruration. Sie kann über eine Property der ITVcentralServer Schnittstelle geholt werden. Grundsätzlich werden Daten von TVC in der plugins.xml Datei im folgenden Ordner abgelegt:

C:\Dokumente und Einstellungen\<Benutzername>\Lokale Einstellungen\Anwendungsdaten\Sceneo\TVcentralV4\Config

Dieser Vorgang ist für das PlugIn transparent, d.h. es braucht selber kein Datei-Funktionen verwenden!

Sollen die Konfigurationsdaten in SceneoMatic vom Benutzer einzustellen sein müssen sie entsprechend in der PlugIn-TVC-Datei konfiguriert werden.

Neben dem Speichern und Laden von String-, Integer, und Bool-Variablen bietet die Schnittstelle einige weitere Funktionen.

IConfig = interface(IDispatch)
   ['{D55F967E-0BCC-4A0F-B708-5A95D7C28CC0}']
   function Get_TemplatePath: WideString; safecall;
   function Get_PluginPath: WideString; safecall;
   function Get_ApplicationPath: WideString; safecall;
   function LoadString(const Plugin: WideString; const Name: WideString; const Default: WideString): WideString; safecall;
   procedure SaveString(const Plugin: WideString; const Name: WideString; const Value: WideString); safecall;
   function LoadInt(const Plugin: WideString; const Name: WideString; Default: Integer): Integer; safecall;
   procedure SaveInt(const Plugin: WideString; const Name: WideString; Value: Integer); safecall;
   function LoadBoolean(const Plugin: WideString; const Name: WideString; Default: WordBool): WordBool; safecall;
   procedure SaveBoolean(const Plugin: WideString; const Name: WideString; Value: WordBool); safecall;
   function Get_ConfigPath: WideString; safecall;
   property TemplatePath: WideString read Get_TemplatePath;
   property PluginPath: WideString read Get_PluginPath;
   property ApplicationPath: WideString read Get_ApplicationPath;
   property ConfigPath: WideString read Get_ConfigPath;
 end;

Eine typische Nutzung kann wie folgt aussehen. Eine globale Konfigurationsvariable soll verwendet werden:

 var giCfgCategoryFilterRed : integer = 9;

In der |LoadPlugin Funktion wird der zuletzt verwendete Wert ausgelesen oder der Defaultwert verwendet:

 giCfgCategoryFilterRed := Core.Config.LoadInt('epgmodule','CategoryFilterRed', giCfgCategoryFilterRed);

Ist der Fall gegeben, dass sich die Variable während der Laufzeit ändert kann diese in der UnloadPlugin Methode wieder gesichert werden:

 Core.Config.SaveInt('epgmodule','CategoryFilterRed', giCfgCategoryFilterRed);