4D v16.3
LIRE RESSOURCE
- 4D - Langage
-
- Ressources
-
- Ressources
- FERMER FICHIER RESSOURCES
- Lire chaine dans liste
- Lire nom ressource
- Lire proprietes ressource
- LIRE RESSOURCE
- Lire ressource chaine
- LIRE RESSOURCE ICONE
- LIRE RESSOURCE IMAGE
- Lire ressource texte
- LISTE DE CHAINES VERS TABLEAU
- LISTE RESSOURCES
- LISTE TYPES RESSOURCE
- Ouvrir fichier ressources
- _o_Créer fichier ressources
- _o_ÉCRIRE NOM RESSOURCE
- _o_ÉCRIRE PROPRIÉTÉS RESSOURCE
- _o_ÉCRIRE RESSOURCE
- _o_ÉCRIRE RESSOURCE CHAINE
- _o_ÉCRIRE RESSOURCE IMAGE
- _o_ÉCRIRE RESSOURCE TEXTE
- _o_Lire ID ressource composant
- _o_SUPPRIMER RESSOURCE
- _o_TABLEAU VERS LISTE DE CHAÎNES
LIRE RESSOURCE
| LIRE RESSOURCE ( resType ; resNum ; resDonnées {; resFichier} ) | ||||||||
| Paramètre | Type | Description | ||||||
| resType | Chaîne |
|
Type de ressource (4 caractères) | |||||
| resNum | Entier long |
|
Numéro de ressource | |||||
| resDonnées | BLOB |
|
Champ ou variable BLOB devant recevoir les données | |||||
|
Contenu de la ressource | |||||||
| resFichier | RefDoc |
|
Numéro de référence de fichier de ressources ou Tous les fichiers de ressources ouverts si omis | |||||
La commande LIRE RESSOURCE retourne dans le champ ou la variable BLOB resDonnées le contenu de la ressource dont le type et le numéro sont passés dans resType et resNum.
Important : Vous devez passer une chaîne de 4 caractères dans resType.
Si la ressource n'est pas trouvée, le paramètre resDonnées est laissé inchangé et la variable OK prend la valeur 0 (zéro).
Si vous passez un numéro de référence de fichier de ressources valide dans resFichier, la ressource sera recherchée dans ce fichier seulement. Si ne passez pas le paramètre resFichier, la première occurrence de la ressource trouvée en remontant la chaîne des fichiers de ressources sera retournée.
Note : La taille d'une ressource peut atteindre plusieurs méga-octets.
Rappelez-vous que vous travaillez avec des ressources issues de Mac OS. Quelle que soit la plate-forme utilisée, les valeurs internes des ressources comme des entiers longs sont stockées avec l'ordre d'octets ("byte ordering") Mac OS. Sous Windows, pour les données des ressources standard (telles que les ressources listes de chaînes et les ressources images) l'ordre des octets est automatiquement inversé ("byte swapping") si nécessaire. D'un autre côté, si vous créez et utilisez vos propres structures internes de données, c'est à vous d'effectuer l'inversion d'octets des données lorsque vous les extrayez d'un BLOB (par exemple en passant Ordre octets Macintosh à une commande telle que BLOB vers entier long).
Reportez-vous à l'exemple de la commande _o_ÉCRIRE RESSOURCE.
Si la ressource est trouvée, la variable système OK prend la valeur 1. Sinon, elle prend la valeur 0 (zéro).
S'il n'y a pas assez de mémoire disponible pour charger l'image, une erreur est générée. Vous pouvez intercepter cette erreur à l'aide d'une méthode de gestion d'erreurs installée par la commande APPELER SUR ERREUR.
Produit : 4D
Thème : Ressources
Numéro :
508
Nom intl. : GET RESOURCE
Créé : 4D v6
4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)
