Créer et utiliser des bibliothèques d'objets personnalisées

4D permet de créer et d’utiliser des bibliothèques d’objets. Une bibliothèque d’objets est un fichier externe créé par 4D. Elle permet de stocker tous les types d’objets utilisables dans les formulaires : champs, boutons, textes, images, listes hiérarchiques, etc. Les objets sont stockés avec toutes leurs propriétés, y compris leurs méthodes objet. Les bibliothèques sont constituées et utilisées par simple glisser-déposer ou copier-coller. Ce sont en quelque sorte des presse-papiers permanents. 

A l’aide des bibliothèques d'objets, vous pouvez constituer des fonds d’objets de formulaires regroupés par familles graphiques, par fonctionnalités, etc. Ces bibliothèques étant stockées sous forme de fichiers externes, leur utilisation parmi différentes bases est d’une grande simplicité. 

Enfin, vous pouvez combiner les bibliothèques d’objets aux formulaires utilisateurs afin de fournir des objets utilisables pour la personnalisation des bases. Ces principes sont détaillés dans la section Formulaires utilisateurs.

Pour créer une bibliothèque d’objets, sélectionnez la commande Nouveau > Bibliothèque d’objets... dans le menu Fichier ou dans la barre d’outils de 4D.

Une boîte de dialogue standard d’enregistrement de fichiers apparaît, vous permettant de choisir le nom et l’emplacement de la bibliothèque d’objets.

Lorsque vous validez la boîte de dialogue, 4D crée sur disque la nouvelle bibliothèque d’objets et affiche sa fenêtre, vide par défaut.

Vous pouvez créer autant de bibliothèques que vous voulez par base. Une bibliothèque créée et construite sous Mac OS peut être utilisée sous Windows et inversement.

Les objets sont placés dans une bibliothèque d’objets par glisser-déposer ou couper/copier-coller. Ils peuvent provenir soit d’un formulaire soit d’une autre bibliothèque d’objets (y compris la bibliothèque préconfigurée, cf. Utiliser la bibliothèque préconfigurée). Aucun lien n’est conservé avec l’objet d’origine : si celui-ci est modifié, la modification ne sera pas reportée dans l’objet copié.

Note : Pour que vous puissiez effectuer des glisser-déposer d’objets depuis les formulaires vers des bibliothèques, vous devez sélectionner l’option de déplacement “Commencer un glisser-déposer” dans les Préférences de 4D (cf. Page Formulaires).

Les principales opérations d'ajout, de suppression ou de modification sont accessibles via le menu contextuel ou le menu d'options de la fenêtre :

Vous pouvez placer dans la bibliothèque des objets individuels ou des ensembles d’objets. Chaque objet ou ensemble d’objets est regroupé en un seul élément. Chaque élément est considéré comme un formulaire :

Une bibliothèque d’objets peut contenir jusqu’à 32 000 éléments.

Les objets sont copiés avec toutes leurs propriétés, graphiques et fonctionnelles. Elles sont intégralement conservées lorsque l’élément est recopié dans un formulaire ou une autre bibliothèque. 

Chaque nouvel élément est nommé “Objet” suivi d’un numéro aléatoire, par exemple Objet 2012. Vous pouvez renommer cet élément comme vous le souhaitez. Pour cela, vous pouvez soit :

• double-cliquer sur l’élément à renommer
• cliquer avec le bouton droit de la souris sur l’élément à renommer puis choisir la commande Renommer dans le menu contextuel. Une boîte de dialogue vous permet de renommer l’élément :
  
  Plusieurs éléments peuvent avoir le même nom.

Le copier-coller ou le glisser-déposer de certains objets dans la bibliothèque entraîne la copie des objets dépendants. Par exemple, la copie d’un bouton entraînera obligatoirement la copie de la méthode objet qui lui est éventuellement attachée. Ces objets dépendants ne peuvent, quant à eux, être directement copiés ou glissés-déposés.

Voici la liste des objets dépendants qui seront collés dans la bibliothèque en même temps que l’objet principal qui les utilise (le cas échéant) :

• Enumérations
• Feuilles de style
• Formats/Filtres
• Images
• Messages d’aide (lié à un champ)
• Ressources STR#
• Méthodes objet

Dans le cas d’une ressource STR#, c’est toute la STR# qui est copiée, pas seulement la chaîne associée à l’objet.

Pour ouvrir et utiliser une bibliothèque d’objets existante, sélectionnez la commande Ouvrir>Bibliothèque d’objets... dans le menu Fichier ou la barre d’outils de 4D.

Une boîte de dialogue standard d’ouverture de fichiers apparaît, vous permettant de désigner la bibliothèque d’objets à ouvrir. Une même bibliothèque d’objets ne peut être ouverte que par une seule base à la fois. En revanche, il est possible d’ouvrir plusieurs bibliothèques différentes dans la même base. L’extension des fichiers de bibliothèques est “.4il”.

Les bibliothèques d’objets sont accessibles à partir du mode Développement de 4D et, si le développeur le permet, dans l’éditeur de Formulaires utilisateurs en mode Application. Tous les éléments de la bibliothèque sont visibles en mode Développement. En revanche, seuls les éléments n’ayant pas de méthode objet associée sont visibles dans l’éditeur de formulaires utilisateurs.

Les éléments ayant au moins une méthode objet associée sont affichés avec un badge (le même que celui qui est affiché sur les objets ayant une méthode objet dans un formulaire, cf. section Utiliser les badges) et leur nom apparaît en bleu. Ce principe permet de différencier facilement les éléments visibles par le développeur en mode Développement de ceux visibles par l’utilisateur en mode Application.

Afin que tous les postes clients puissent accéder à une bibliothèque d’objets, le fichier de la bibliothèque doit être placé dans le dossier Resources de la base (cf. section Description des fichiers de 4D). Ce dossier permet notamment de partager des éléments personnalisés entre le serveur et les postes clients (images, fichiers XLIFF, etc.). Voir aussi Gestion du dossier Resources dans le manuel de 4D Server.
Vous pouvez visualiser et gérer le contenu du dossier Resources via l’Explorateur de ressources.