GET RESOURCE

Version 6.0

GET RESOURCE (ResTyp; ResNR; ResDaten{; ResDatei})

Der Befehl GET RESOURCE gibt im BLOB Datenfeld bzw. der Variablen ResDaten den Inhalt der Ressource vom Typ ResTyp und der Nummer ResNR zurück.

Wichtig: Sie müssen in ResTyp einen String mit vier Zeichen übergeben.

Wird die Ressource nicht gefunden, bleibt der Parameter ResDaten unverändert, die OK Variable wird auf 0 (Null) 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 das erste Vorkommen der Ressource in der Ressourcendatei-Kette zurückgegeben.

Hinweis: Eine Ressource kann mehrere Megabytes groß sein.

Plattformunabhängigkeit: Bedenken Sie, dass Sie mit Ressourcen arbeiten, die auf Mac OS basieren. Interne Ressourcendaten z.B vom Typ Lange Ganzzahl werden, unabhängig von der Plattform, mit der Macintosh Byte Anordnung gespeichert. Unter Windows werden low-Bytes und high-Bytes bei Daten für die Standardressourcen (Stringlisten-, Bild-Ressourcen, etc.) bei Bedarf automatisch vertauscht. Verwenden Sie eigene interne Datenstrukturen, bleibt es Ihnen überlassen, ob Sie die Byte-Anordnung der Daten aus dem BLOB vertauschen. Sie können Macintosh byte ordering z.B. der Funktion BLOB to longint übergeben.

Siehe Beispiel zum Befehl SET RESOURCE.

BLOB Befehle, Einführung in Ressourcen, SET RESOURCE.

Wird die Ressource gefunden, wird OK auf 1 gesetzt, sonst auf 0 (Null).

Reicht der Speicher nicht aus, um die Ressource zu laden, wird ein Fehler erzeugt. Sie können diesen Fehler mit ON ERR CALL in einer Fehlerverwaltungsmethode ausfindig machen.