4D v16.3
GET RESOURCE
- 4D Programmiersprache
-
- Ressourcen
-
- Einführung in Ressourcen
- CLOSE RESOURCE FILE
- GET ICON RESOURCE
- Get indexed string
- GET PICTURE RESOURCE
- GET RESOURCE
- Get resource name
- Get resource properties
- Get string resource
- Get text resource
- Open resource file
- RESOURCE LIST
- RESOURCE TYPE LIST
- STRING LIST TO ARRAY
- _o_ARRAY TO STRING LIST
- _o_Create resource file
- _o_DELETE RESOURCE
- _o_Get component resource ID
- _o_SET PICTURE RESOURCE
- _o_SET RESOURCE
- _o_SET RESOURCE NAME
- _o_SET RESOURCE PROPERTIES
- _o_SET STRING RESOURCE
- _o_SET TEXT RESOURCE
GET RESOURCE
| GET RESOURCE ( ResTyp ; ResID ; ResDaten {; ResDatei} ) | ||||||||
| Parameter | Typ | Beschreibung | ||||||
| ResTyp | String |
|
Ressourcentyp mit 4 Zeichen | |||||
| ResID | Lange Ganzzahl |
|
Kennummer der Ressource | |||||
| ResDaten | BLOB |
|
BLOB Feld oder Variable zum Empfangen der Daten | |||||
|
Inhalt der Ressource | |||||||
| ResDatei | DokRef |
|
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 _o_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.
Produkt: 4D
Thema: Ressourcen
Nummer:
508
Erstellt: 4D v6
4D Programmiersprache ( 4D v16)
4D Programmiersprache ( 4D v16.1)
4D Programmiersprache ( 4D v16.2)
4D Programmiersprache ( 4D v16.3)
