|
|
|
|
|
|
|
|
|
|
version 6.7
Lire ID ressource composant (nomComp; resType; resNumOriginal) 
Numérique
| Paramètre | Type | Description | |
| nomComp | Alpha (32) | | Nom du composant référençant la ressource |
| resType | Alpha (4) | | Type de ressource (4 caractères), PICT ou STR# |
| resNumOriginal | Numérique | | Numéro original de la ressource, avant |
| installation du composant | |||
| Résultat | Numérique |  | Numéro courant de la ressource |
Description
La commande Lire ID ressource composant permet aux développeurs de composants de s'assurer que leurs appels de ressources personnalisées de type PICT ou STR# seront correctement effectués, même si les numéros de ces ressources ont été modifiés au moment de l'installation.
En effet, lorsqu'un composant utilisant des ressources est installé par 4D Insider, le programme peut renuméroter automatiquement les nouvelles ressources si des ressources de même numéro existent déjà dans la base.
Note : Pour plus d'infomations sur les composants dans 4e Dimension, reportez-vous à la documentation de 4D Insider.
La commande Lire ID ressource composant permet donc de connaître le numéro courant (réel) de chaque ressource utilisée par un composant, à partir de son type et de son numéro original. Bien entendu, la commande doit être appelée dans une méthode appartenant au composant.
• Passez dans le paramètre nomComp le nom du composant utilisant la ressource.
• Passez dans le paramètre resType le type de la ressource (impérativement composé de 4 caractères). La commande Lire ID ressource composant accepte uniquement les ressources de type PICT et STR#.
Note : Les images stockées dans la bibliothèque d'images de 4D ne sont PAS gérées par la commande Lire ID ressource composant. Pour pouvoir utiliser des images de la Bibliothèque d'images dans un composant 4D, vous devez appeler la commande LIRE IMAGE DANS BIBLIOTHEQUE et passer une chaîne (le nom de l'image) en tant que premier paramètre. Pour plus d'informations, reportez-vous à la description de la commande LIRE IMAGE DANS BIBLIOTHEQUE.
• Passez dans resNumOriginal le numéro original de la ressource, c'est-à-dire celui défini au moment de la création du composant.
La fonction retourne alors le numéro attribué à la ressource dans l'application courante.
Si aucune ressource ne correspond à resNumOriginal, Lire ID ressource composant retourne la valeur saisie dans resNumOriginal.
Exemple
Le code ci-dessous ne permet pas de garantir que les appels de ressources seront correctement effectués :
`Si les ressources sont renumérotées, cet appel sera incorrect vNumRes := 15000 LISTE DE CHAINES VERS TABLEAU(vNumRes; tabChaînes; fichierRes)
Il est fortement conseillé de préférer le code suivant :
`Cet appel sera correct dans tous les cas
vNumRes :=Lire ID ressource composant("MonComp";"STR#";15000)
LISTE DE CHAINES VERS TABLEAU (vNumRes; tabChaînes; fichierRes)
Référence
LIRE INFORMATIONS SERIALISATION.
|
|
|
|
|
|
|
|
|
|