SET RESOURCE PROPERTIES

Version 6.0

SET RESOURCE PROPERTIES (ResTyp; ResNR; ResAttr{; ResDatei})

Der Befehl SET RESOURCE PROPERTIES ändert die Attribute der Ressource vom Typ ResTyp und mit der Kennummer ResNR.

Gibt es die Ressource nicht, führt der Befehl nichts aus. Die OK Variable wird auf Null (0) gesetzt.

Übergeben Sie in ResDatei eine gültige Referenznummer für die Ressourcendatei, wird die Ressource nur in dieser Datei gesucht. Übergeben Sie ResDatei nicht, wird die Ressource in der aktuellen geöffneten Ressourcendatei gesucht.

Der in ResAttr übergebene numerische Wert ist ein Bit Feldwert, dessen Bits eine spezielle Bedeutung haben. 4D bietet folgende vordefinierte Konstanten:

Mit diesen Konstanten könne Sie einen beliebigen Wert für Ressourcenattribute einrichten. Siehe dazu folgende Beispiele.

• System heap

Mit diesem Attribut wird die Ressource in den Systemspeicher anstatt in den 4D Speicher geladen. Verwenden Sie dieses Attribut nur, wenn Sie genau wissen, was Sie tun.

• Purgeable

Mit diesem Attribut können Sie die Ressource nach dem Laden aus dem Speicher entfernen, wenn für andere Daten Speicherplatz benötigt wird. Da Sie Ressourcen in 4D BLOBs laden, empfiehlt es sich, alle eigenen Ressourcen entfernbar zu machen, um so den Speicherbedarf gering zu halten. Greifen Sie dagegen während einer Arbeitssitzung häufig auf eine Ressource zu, sollte sie nicht entfernbar sein. So verringern Sie den Zugriff auf die Festplatte, von der eine entfernte Ressource bei jedem Aufruf erneut geladen werden müßte.

• Locked

Mit diesem Attribut können Sie die Ressource nach dem Laden in den Speicher nicht erneut setzen. Eine gesperrte Ressource können Sie nicht entfernen, selbst wenn sie entfernbar ist. Das Sperren einer Ressource hat den unerwünschten Nebeneffekt, dass der Speicherplatz fragmentiert wird. Verwenden Sie dieses Attribut nur, wenn Sie genau wissen, was Sie tun.

• Protected

Mit diesem Attribut können Sie weder den Namen, noch die Kennummer noch den Inhalt der Ressource ändern. Sie können diese Ressource auch nicht mehr löschen. Dieses Attribut können Sie über den Befehl SET RESOURCE PROPERTIES entfernen; dann läßt sich die Ressource wieder ändern oder löschen. Dieses Attribut benötigen Sie nur selten.

Hinweis: Unter Windows hat dieses Attribut keine Auswirkung.

• Preloaded

Mit diesem Attribut wird die Ressource automatisch in den Speicher geladen, wenn die dazugehörige Ressourcendatei geöffnet ist. Mit diesem Attribut optimieren Sie das Laden von Ressourcen bei geöffneter Ressourcendatei. Dieses Attribut benötigen Sie nur selten.

• Changed

Mit diesem Attribut wird die Ressource mit "auf Festplatte sichern" markiert, wenn die dazugehörige Ressourcendatei geschlossen ist. Da der 4D Befehl SET RESOURCE das Schreiben und Neuschreiben von Ressourcen intern verwaltet, sollten Sie dieses Attribut nur verwenden, wenn Sie genau wissen, was Sie tun.

Normalerweise verwenden Sie das Attribut purgeable, in wenigen Fällen auch die Attribute Preloaded und Protected.

Warnung: Ändern Sie NICHT die Attribute von Ressourcen, die zu 4D oder anderen Systemdateien gehören. Das kann zu unerwünschten Systemfehlern führen.

1. Siehe Beispiel zum Befehl Get resource name.

2. Folgendes Beispiel macht die Ressource 'STR#' ID=17000 löschbar, und lässt die anderen Attribute unverändert:

   $vlResAttr:=Get resource properties ('STR#';17000;$vhResFile)
   SET RESOURCE PROPERTIES('STR#';17000;$vlResAttr ?
                                    + Purgeable resource bit;$vhMyResFile)

3. Folgendes Beispiel macht die Ressource 'STR#' ID=17000 vorladbar und nicht löschbar:

   SET RESOURCE PROPERTIES('STR#';17000;Preloaded resource mask;$vhResFile)

4. Folgendes Beispiel macht die Ressource 'STR#' ID=17000 vorladbar und löschbar:

   SET RESOURCE PROPERTIES('STR#';17000;Preloaded resource mask
                                    +Purgeable resource mask;$vhResFile)

SET RESOURCE NAME.

Ist die Ressource vorhanden, wird OK auf 1 gesetzt, sonst auf 0 (Null).