GET RESOURCE

4D - Documentation   Français   English   German   Spanish   Japanese   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next

Version 6.0


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

ParameterTypBeschreibung
ResTypStringRessourcentyp mit 4 Zeichen
ResNRNumerischKennummer der Ressource
ResDatenBLOBBLOB Feld oder Variable zum Empfangen
der Daten
Inhalt der Ressource
ResDateiDokRefReferenznummer der Ressourcendatei, ohne
Angabe alle geöffneten Ressourcendateien

Beschreibung

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.

Beispiel

Siehe Beispiel zum Befehl SET RESOURCE.

Referenz

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

Systemvariablen und Mengen

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

Fehler verwalten

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.


4D - Documentation   Français   English   German   Spanish   Japanese   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next