4D v14.3

GET RESOURCE

Home

 
4D v14.3
GET RESOURCE

GET RESOURCE 


 

GET RESOURCE ( ResTyp ; ResID ; ResDaten {; ResDatei} )  
Parameter Typ   Beschreibung
ResTyp  String in Ressourcentyp mit 4 Zeichen
ResID  Lange Ganzzahl in Kennummer der Ressource
ResDaten  BLOB in BLOB Feld oder Variable zum Empfangen der Daten
in Inhalt der Ressource
ResDatei  DokRef in Referenznummer der Ressourcendatei
Ohne Angabe alle geöffneten Ressourcendateien

Der Befehl GET RESOURCE gibt im BLOB Datenfeld bzw. der Variablen ResDatei den Inhalt der Ressource vom Typ ResTyp und der Nummer ResID 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.

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.

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.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Ressourcen
Nummer: 508

Dieser Befehl ändert die Systemvariable OKDieser Befehl ändert die Systemvariable Error

 
GESCHICHTE 

Erstellt: 4D v6

 
SIEHE AUCH 

BLOB Befehle
Einführung in Ressourcen
SET RESOURCE

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v11 SQL Release 6)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)