Vous êtes sur la page 1sur 162

4D Insider

Manuel de rfrence
Windows/MacOS

4D Insider
1993 - 2002 4D SA. Tous droits rservs.

4D Insider
Manuel de rfrence
Copyright 1993 - 2002 4D SA
Tous droits rservs.
Les informations contenues dans ce manuel peuvent faire lobjet de modifications sans pravis et ne sauraient
en aucune manire engager 4D SA. La fourniture du logiciel dcrit dans ce manuel est rgie par un octroi de
licence dont les termes sont prciss par ailleurs dans la licence lectronique figurant sur le support du Logiciel et de la Documentation y affrente. Le logiciel et sa Documentation ne peuvent tre utiliss, copis ou
reproduits sur quelque support que ce soit et de quelque manire que ce soit, que conformment aux termes
de cette licence.
Aucune partie de ce manuel ne peut tre reproduite ou recopie de quelque manire que ce soit, lectronique
ou mcanique, y compris par photocopie, enregistrement, archivage ou tout autre procd de stockage, de
traitement et de rcupration dinformations, pour dautres buts que lusage personnel de lacheteur, et ce
exclusivement aux conditions contractuelles, sans la permission explicite de 4D SA.
4D, 4D Draw, 4D Write, 4D Insider, 4me Dimension, 4D Server, 4D Compiler ainsi que les logos 4e Dimension et 4D sont des marques enregistres de 4D SA.
Windows, Windows NT et Microsoft sont des marques enregistres de Microsoft Corporation.
Apple, Macintosh, Power Macintosh, LaserWriter, QuickTime sont des marques enregistres ou des noms
commerciaux de Apple Computer, Inc.
Mac2Win Software Copyright 1990-2002 est un produit de Altura Software, Inc.
ACROBAT Copyright 1987-2002, Secret Commercial Adobe Systems Inc. Tous droits rservs. ACROBAT est
une marque enregistre dAdobe Systems Inc.
Tous les autres noms de produits ou appellations sont des marques dposes ou des noms commerciaux
appartenant leurs propritaires respectifs

Sommaire

Prface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
Prsentation de ce manuel
Contenu . . . . . . . .
Windows/MacOS .
Navigation hypertexte
Conventions dcriture

Chapitre 1

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

. 9
. 9
10
10
11

Introduction . . . . . . . . . . . . . . . . . . 13
Les objets de 4e Dimension . . . . . . . . . . . . . . . . . . . 13
La table des rfrences croises . . . . . . . . . . . . . . . . . 13

Chapitre 2

Dmarrer . . . . . . . . . . . . . . . . . . . . 15
Mise en route . . . . . . . . . . . . . . .
Modifier les Prfrences gnrales . . . .
Au dmarrage . . . . . . . . . . . . .
Fentres . . . . . . . . . . . . . . . .
Crer une base ou une librairie vierge . .
Quest-ce quune librairie ? . . . . . .
Sauvegarder une base ou une librairie . .
Ouvrir une base ou une librairie existante
Ouverture en local . . . . . . . . . .
Ouverture sur 4D Server . . . . . . .
Refaire lanalyse . . . . . . . . . . . . . .
Fermer une base ou une librairie . . . . .

Chapitre 3

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.

15
17
18
18
20
20
22
23
24
26
27
28

Navigation parmi les objets . . . . . . . . . . 29


Visualiser les objets et leurs relations . . .
Slectionner une zone de la fentre .
Types dobjets affichs . . . . . . . .
Visualiser les relations entre les objets
Visualiser le contenu dun objet . . . . .
Barres de menus . . . . . . . . . . . .
Bibliothque dimages . . . . . . . . .
Champs et sous-tables . . . . . . . .

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.

Manuel de rfrence de 4D Insider

.
.
.
.
.
.
.
.

29
30
30
33
35
36
36
37
3

Sommaire

Commandes 4D . . . . . . . . . . . . . . . . . . . .
Composants . . . . . . . . . . . . . . . . . . . . . .
Constantes . . . . . . . . . . . . . . . . . . . . . . .
Ensembles . . . . . . . . . . . . . . . . . . . . . . .
Enumrations . . . . . . . . . . . . . . . . . . . . .
Feuilles de style. . . . . . . . . . . . . . . . . . . . .
Formats/Filtres . . . . . . . . . . . . . . . . . . . . .
Formulaires . . . . . . . . . . . . . . . . . . . . . .
Groupes . . . . . . . . . . . . . . . . . . . . . . . .
Menus . . . . . . . . . . . . . . . . . . . . . . . . .
Messages daide . . . . . . . . . . . . . . . . . . . .
Mthodes base, projet, formulaire, objet et triggers .
Plug ins . . . . . . . . . . . . . . . . . . . . . . . .
Ressources STR# . . . . . . . . . . . . . . . . . . . .
Slections temporaires . . . . . . . . . . . . . . . . .
Smaphores . . . . . . . . . . . . . . . . . . . . . .
Tables . . . . . . . . . . . . . . . . . . . . . . . . .
Variables . . . . . . . . . . . . . . . . . . . . . . . .
Manipuler les listes de la fentre de navigation . . . . . .
Activation des menus . . . . . . . . . . . . . . . . .
Slectionner une liste ou une zone . . . . . . . . . .
Slectionner un objet . . . . . . . . . . . . . . . . .
Slectionner plusieurs objets . . . . . . . . . . . . .
Dslectionner un objet . . . . . . . . . . . . . . . .
Tout slectionner . . . . . . . . . . . . . . . . . . .
Rduire une liste aux objets slectionns . . . . . . .
Sous-slections automatiques . . . . . . . . . . . . .
Remplacer la liste principale par une liste secondaire
Ouvrir une nouvelle fentre centre sur un objet
slectionn . . . . . . . . . . . . . . . . . . . . . . .
Rorganiser les fentres de navigation . . . . . . . . . .
Modifier les dimensions . . . . . . . . . . . . . . . .
Disposition des zones . . . . . . . . . . . . . . . . .
Organiser les diffrentes fentres ouvertes . . . . . .

Chapitre 4

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

37
37
37
37
37
38
38
38
40
40
41
42
42
43
43
43
43
44
44
44
45
45
46
46
46
46
47
48

.
.
.
.
.

.
.
.
.
.

.
.
.
.
.

49
49
49
50
52

Groupes . . . . . . . . . . . . . . . . . . . . . 53
Prsentation . . . . . . . . . . . . . . .
Dfinition . . . . . . . . . . . . . .
Oprations sur les objets groups . .
Crer/Modifier un groupe . . . . . . . .
Crer un groupe partir dune slection
Regrouper avec les dpendances . . . .
Dgrouper/Supprimer un groupe . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

Manuel de rfrence de 4D Insider

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

.
.
.
.
.
.
.

53
53
54
54
57
58
58

Sommaire

Chapitre 5

Documentation . . . . . . . . . . . . . . . . . 61
Crer ou modifier la documentation dun objet . .
Options de la fentre de documentation dobjet
Crer ou modifier une documentation gnrale . .
Supprimer une documentation . . . . . . . . . . .
Imprimer la documentation . . . . . . . . . . . .
Documentation multi-utilisateurs . . . . . . . . .

Chapitre 6

.
.
.
.
.
.

Aide la traduction

.
.
.
.
.
.

.
.
.
.
.
.

.
.
.
.
.
.

62
63
64
65
66
66

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.

67
68
69
71
72
73
75
78
79
81
84
84
86

. . . . . . . . . . . . . . 89

Utiliser des ressources STR# dans 4D . . . . . . . .


Quest-ce quune ressource STR# ? . . . . . . .
Traduire les menus et les commandes de menus
Traduire les boutons . . . . . . . . . . . . . .
Traduire les zones de texte . . . . . . . . . . .
Utiliser des ressources STR# dans 4D Insider . . . .
Texte vers STR# . . . . . . . . . . . . . . . . .
STR# vers Texte . . . . . . . . . . . . . . . . .
Editer les STR# . . . . . . . . . . . . . . . . .

Chapitre 8

.
.
.
.
.
.

Filtres, recherches et remplacements . . . . . 67


Filtres et recherches . . . . . . . . . . . . . . . . . .
Appliquer un filtre . . . . . . . . . . . . . . . .
Modifier le contenu des pop up menus de filtres
Crer/Modifier un filtre personnalis . . . . . .
Excuter une recherche . . . . . . . . . . . . . .
Construire une recherche ou un filtre . . . . . .
Exemples de recherches . . . . . . . . . . . . . .
Remplacer . . . . . . . . . . . . . . . . . . . . . . .
Renommer un objet . . . . . . . . . . . . . . .
Remplacer dans une slection . . . . . . . . . .
Remplacer dans le contenu . . . . . . . . . . . .
Remplacer les commandes . . . . . . . . . . . .
Prfixer une slection dobjets . . . . . . . . . .

Chapitre 7

.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.

90
90
90
92
93
94
94
96
98

Impression et export . . . . . . . . . . . . . 101


Imprimer des objets . . . . . . . . . . . . . . . . . . . . . . . 101
Exporter des objets . . . . . . . . . . . . . . . . . . . . . . . 102

Manuel de rfrence de 4D Insider

Sommaire

Chapitre 9

Redimensionnement des formulaires

. . . . 105

Pourquoi redimensionner les formulaires ? . . . . . . . . . . 105


Le redimensionnement dans 4D Insider . . . . . . . . . . . 106
Options de redimensionnement . . . . . . . . . . . . . 108

Chapitre 10

Dplacement dobjets

. . . . . . . . . . . . 109

Objets dplaables . . . . . . . . . . . . . . .
Dplacement des objets . . . . . . . . . . . .
Plusieurs types de dplacements . . . . .
Excution dun dplacement . . . . . . .
Rpondre aux questions de 4D Insider . .
Description des rponses . . . . . . . . .
Paramtrer les Prfrences de dplacement
Objets dlimiteurs . . . . . . . . . . . . . . .
Quest-ce quun objet dlimiteur ? . . . .
Identifier les objets dlimiteurs . . . . . .
Dfinir des objets dlimiteurs . . . . . . .

Chapitre 11

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.

Gestion des composants 4D . . . . . . . . . 125


Prsentation et caractristiques des composants . . . . . . .
Quest-ce quun composant ? . . . . . . . . . . . . . . .
Principes de cration . . . . . . . . . . . . . . . . . . .
Principes dinstallation . . . . . . . . . . . . . . . . . .
Dfinition des attributs . . . . . . . . . . . . . . . . . .
Visualisation et utilisation des composants installs . . .
Dvelopper et gnrer un composant . . . . . . . . . . . . .
Types dobjets admis . . . . . . . . . . . . . . . . . . .
Crer un nouveau composant . . . . . . . . . . . . . . .
Proprits du composant . . . . . . . . . . . . . . . . .
Attributs des objets dplacs . . . . . . . . . . . . . . .
Oprations sur les composants en cours de cration dans
4D Insider . . . . . . . . . . . . . . . . . . . . . . . . .
Gnrer le fichier de composant . . . . . . . . . . . . .
Installer et mettre jour un composant . . . . . . . . . . . .
Gestion des conflits dinstallation . . . . . . . . . . . .
Dsinstaller un composant . . . . . . . . . . . . . . . .
Contraintes et conseils de dveloppement . . . . . . . . . .
Eviter les conflits de noms . . . . . . . . . . . . . . . .
Dclarer les variables . . . . . . . . . . . . . . . . . . .
Grer les numros de ressources STR# et PICT . . . . . .
Grer les numros dimages de la bibliothque . . . . . .
Protger les composants . . . . . . . . . . . . . . . . . .

109
111
111
111
113
115
118
120
120
121
121

Manuel de rfrence de 4D Insider

125
125
126
126
126
128
129
129
130
132
134
134
135
135
137
138
139
139
140
140
141
142

Sommaire

Chapitre 12

Exploiter un fichier SQL . . . . . . . . . . . 143


Verbes et options SQL interprts par 4D Insider . . . . . . . 144
Table de conversion des types de champs . . . . . . . . . . . 144
Gnrer une base partir dun fichier Texte SQL . . . . . . . 146

Annexe A

Personnaliser 4D Insider . . . . . . . . . . . . . . . . .149


4D Insider et 4D Customizer Plus . . . . . . . . . . . . . . . 149
Script Manager . . . . . . . . . . . . . . . . . . . . . . . 150
Polices . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

Annexe B

Raccourcis-clavier . . . . . . . . . . . . . . . . . . . . . . .153

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155

Manuel de rfrence de 4D Insider

Sommaire

Manuel de rfrence de 4D Insider

Prface

Bienvenue dans 4D Insider. 4D Insider est un outil daide au


dveloppement et la maintenance des bases 4D.

Prsentation de ce manuel
Contenu

Ce manuel est compos des chapitres suivants :

Le chapitre Introduction, page 13, dfinit les concepts et les principales fonctions de 4D Insider.

Le chapitre Dmarrer, page 15, vous prsente les manipulations de


base de 4D Insider.

Le chapitre Navigation parmi les objets, page 29, vous guide au


travers de la table des rfrences croises de 4D Insider et prcise, pour
chaque objet identifi par 4D Insider, le nombre et la porte des informations que le programme sera en mesure de fournir.

Le chapitre Groupes, page 53, traite du moyen fourni par


4D Insider pour regrouper les objets de vos bases et de vos librairies
afin de faciliter et dacclrer vos dveloppements.

Le chapitre Documentation, page 61, traite des moyens fournis par


4D Insider pour documenter les objets de vos bases et de vos librairies.

Le chapitre Filtres, recherches et remplacements, page 67, dtaille


les fonctions de cration de filtres, de recherches et de remplacements
de 4D Insider.

Le chapitre Aide la traduction, page 89, prcise de quelle


manire 4D Insider peut efficacement contribuer la traduction de vos
bases.

Manuel de rfrence de 4D Insider

Prface

Le chapitre Impression et export, page 101, prsente la capacit de


4D Insider restituer les informations sous la forme de documents
imprims ou de fichiers sauvegards sur disque.

Le chapitre Redimensionnement des formulaires, page 105, prsente la fonction et les options de redimensionnement global des formulaires de 4D Insider.

Le chapitre Dplacement dobjets, page 109, dtaille la fonction de


dplacement dobjets de 4D Insider : vous pouvez en effet copier des
objets dune base une autre en conservant tout ou partie de leurs rfrences.

Le chapitre Gestion des composants 4D, page 125, dcrit la cration et linstallation des composants 4D laide de 4D Insider.

Le chapitre Exploiter un fichier SQL, page 143, dtaille la cration


de bases 4D dans 4D Insider partir de fichiers de description au format SQL 92.
En outre, des annexes fournissent des informations complmentaires :

lannexe Personnaliser 4D Insider, page 149 vous explique


comment paramtrer certains aspects de votre logiciel laide de
Customizer Plus.

lannexe Raccourcis-clavier, page 153 rcapitule les fonctionnalits accessibles par combinaison de touches

Windows/MacOS Ce manuel sadresse indiffremment aux utilisateurs des versions


Windows et MacOS (Power Macintosh) de 4D Insider.
Les explications sappliquent gnralement aux deux plates-formes.
Toute diffrence de fonctionnement entre la version MacOS et
Windows de 4D Insider est signale au cours du texte.
Les copies dcrans proviennent principalement de lenvironnement
Windows 95/98. La version MacOS dun cran est toutefois prsente
lorsquelle prsente des diffrences majeures.

Navigation
hypertexte

10

Si vous consultez ce manuel sous sa forme lectronique (Acrobat), vous


pouvez tirer profit des liens hypertexte quil contient. Dans les
chapitres de ce manuel, chaque mot comportant un lien hypertexte
apparat en bleu (ce principe ne sapplique pas aux parties Sommaire
et Index, dans lesquelles toutes les entres comporte un lien).

Manuel de rfrence de 4D Insider

Prsentation de ce manuel

Lorsque vous cliquez sur un lien hypertexte, vous vous dplacez


instantanment sur une page comportant des informations
supplmentaires. Pour retourner la page de dpart, il vous suffit de
cliquer sur le bouton Page prcdente dAcrobat.
Vous pouvez galement vous dplacer en cliquant sur les repres dans
la table situe gauche de la fentre affichant les pages du manuel.

Conventions
dcriture

Ce manuel emploie un certain nombre de conventions dcriture.


Les notes suivantes sont utilises :
Note Les informations crites de cette manire sont des prcisions et des
raccourcis-clavier destin(e)s vous permettre dutiliser 4D Insider de
manire plus efficace.
4D Server Les informations contenues dans ce manuel dcrivent lutilisation de
4D Insider dans lenvironnement 4D monoposte (4e Dimension) et
client/serveur (4D Server). Lorsque des explications supplmentaires
simposent pour 4D Server, elles sont indiques de cette manire dans
le texte.
Les informations crites sous cette forme attirent votre attention sur
des points importants.
ATTENTION : Les informations crites sous cette forme attirent votre attention sur des points importants pouvant mener des pertes de donnes.
Les noms de tables sont crits entre crochets, pour permettre de les
distinguer des noms des autres objets de la base, tels que les champs,
les formulaires, etc. Par exemple, la table des employs sera crite table
[Employs].

Menu>Commande de
menu

Par convention et afin dallger le texte, la slection dune commande


de menu est parfois crite de la manire suivante : Menu>Commande
de menu. Par exemple, slectionnez Fichier>Ouvrir signifie
slectionnez la commande Ouvrir... dans le menu Fichier.

Manuel de rfrence de 4D Insider

11

Prface

12

Manuel de rfrence de 4D Insider

Introduction

4D Insider vous permet danalyser et de grer trs simplement les


diffrents objets constituant le fichier de structure dune base 4D.
4D Insider vous permet de comprendre leur imbrication et leur
fonctionnement, mais aussi de rechercher, renommer, imprimer,
localiser, documenter, exporter et dplacer dune base une autre ces
objets.

Les objets de 4e Dimension


Une base de donnes dveloppe sous 4e Dimension est constitue
dun fichier de donnes et dun fichier de structure.
Le fichier de structure contient les informations relatives
lorganisation gnrale de la base. Il peut tre constitu de multiples
objets tels que des tables, des formulaires, des champs, des variables,
des mthodes, des plug-ins, des images, des constantes, des feuilles de
style, des barres de menus...
Tous ces lments structurels constituent les objets de 4e Dimension,
objets dont lanalyse et la gestion sont la raison dtre de 4D Insider.

La table des rfrences croises


Tous les objets de 4e Dimension sont en interaction constante. Ainsi,
un formulaire est constitu de diffrents champs, un champ peut
appeler une mthode objet, qui elle-mme peut appeler une routine de
plug-in, une variable...

Manuel de rfrence de 4D Insider

13

Introduction

4D Insider permet non seulement didentifier et disoler tous ces


objets, mais galement de visualiser leur interaction, en tablissant une
table des rfrences croises (par rfrence un objet, il faut entendre
tous les endroits de la base o rfrence est faite cet objet : la rfrence
peut donc tre plus ou moins explicite).
A laide de cette table, 4D Insider dresse, pour un objet x, une liste
complte des objets que x rfrence et une liste des objets dans lesquels
x est rfrenc.
Imaginons, par exemple, un formulaire entre (intitul Formulaire A)
utilis par deux tables diffrentes et appel par une commande de
menu. Ce formulaire contient trois champs, appelle une mthode
formulaire et possde sa propre barre de menus.
4D Insider affichera donc les informations suivantes :
Objets sources

Objet identifi
(liste Base)

Objets cibles
Champ 1

Champ 2

Table 1

Table 2

Champ 3
Formulaire A

Mthode projet

Mthode formulaire

Barre de menu

14

les objets sources sont les objets appelants ;

les objets cibles sont les objets appels.

Manuel de rfrence de 4D Insider

Dmarrer

Cette partie prsente les concepts et les manipulations lmentaires de


4D Insider. Les points suivants sont abords :

Mise en route de 4D Insider,

Paramtrer les Prfrences gnrales,

Crer une base ou une librairie vierge,

Sauvegarder une base ou une librairie,

Ouvrir une base ou une libraire existante,

Refaire lanalyse dune base 4D Server.

Mise en route
Pour installer 4D Insider sur votre disque dur, reportez-vous aux
instructions fournies dans le guide dinstallation.
A lissue de linstallation, vous devez disposer des fichiers suivants :
Dossier dinstallation
Windows

MacOS

4D Insider
4DInsid.exe, 4DInsid.rsr,
Asifont.fon, ASINTPPC.DLL,
Asiport.rsr

Dossier 4D1
InsV67Prf

1. Lemplacement du dossier 4D a t modifi compter de la version 6.8.


Pour plus dinformations sur ce point, reportez-vous au manuel Mise jour de
4D 6.8.

Manuel de rfrence de 4D Insider

15

Chapitre 2 Dmarrer

Pour lancer 4D Insider, double-cliquez sur licne du programme.


La fentre de bienvenue apparat.

Paramtrage de la
mmoire sous MacOS

La fentre de bienvenue de 4D Insider indique (sous MacOS


uniquement) la mmoire disponible pour lapplication. Lorsque
4D Insider analyse une base de donnes ou une librairie, le programme
charge et conserve en mmoire les rfrences de chaque objet, ce qui
peut parfois reprsenter une grande masse dinformations.

Vous pouvez dfinir la mmoire allouer 4D Insider laide de la


formule suivante :
900 K pour 4D Insider + (Nombre dobjets * 0,5 K) + taille de lobjet le
plus gros
Cette formule est base sur une moyenne de 50 rfrences par objet.
Si vous ouvrez simultanment plusieurs fichiers de structure ou
librairies, vous devez calculer la formule pour chacun dentre eux.
Si la taille des bases que vous ouvrez est trop importante, le mot
Mmoire clignotera dans la partie droite de la fentre. Dans ce cas, il
est prfrable daugmenter la mmoire alloue au programme.

Pour modifier lallocation de mmoire de 4D Insider :

1 Quittez 4D Insider.
2 Slectionnez licne de lapplication au niveau du Finder.
3 Choisissez la commande Lire les informations dans le menu Fichier.
La fentre Infos sur 4D Insider saffiche.
4 Fixez vos paramtrages dans la zone Mmoire souhaite.
5 Refermez la fentre et relancez lapplication 4D Insider.
Paramtrage de la
mmoire sous Windows

16

Sous Windows, cest le systme dexploitation qui alloue la mmoire


aux applications. Il nest pas possible de modifier ce paramtre dans cet
environnement.

Manuel de rfrence de 4D Insider

Modifier les Prfrences gnrales

Modifier les Prfrences gnrales


Une fois que 4D Insider est lanc, vous pouvez ouvrir la bote de
dialogue des Prfrences gnrales. Cette bote de dialogue vous
permet de dfinir plusieurs options utilises au dmarrage de
lapplication : la disposition des fentres, leurs dimensions,
lapparition dune alerte lors de la fermeture de la base...
Note Ces paramtres sont stocks dans le fichier de prfrences de 4D Insider
(InsV67Prf). Ces paramtres sont ainsi appliqus tous les 4D Insider et
toutes les bases de donnes que vous exploitez sur cette machine.
Lorsque vous effectuez une mise jour mineure (version de mme
rang), ces paramtres sont donc conservs. Si vous changez de
machine, ces paramtres sont perdus.

Pour ouvrir la fentre des prfrences gnrales de 4D Insider,


choisissez Fichier>Prfrences puis la sous-commande Gnrales...

Manuel de rfrence de 4D Insider

17

Chapitre 2 Dmarrer

La bote de dialogue suivante apparat :

Au dmarrage
Afficher le dialogue
douverture de
documents

Si vous cochez cette case, 4D Insider affiche automatiquement au


moment de son lancement la fentre standard douverture de
documents.

Montrer la fentre de
bienvenue

Lorsque cette case est coche, 4D Insider affiche chaque dmarrage la


fentre de bienvenue. Vous pouvez afficher cette fentre tout
moment en choisissant la commande A propos de 4D Insider dans le
menu Pomme (version MacOS) ou Aide (version Windows).

Fentres
Largeur/Hauteur

Cette zone saisissable vous permet de dfinir la taille par dfaut de la


fentre principale de 4D Insider.

Listes

Vous dfinissez ici le mode daffichage par dfaut des listes de


4D Insider (pour plus dinformations sur les listes, reportez-vous au
paragraphe Rorganiser les fentres de navigation, page 49).

18

Manuel de rfrence de 4D Insider

Modifier les Prfrences gnrales

Confirmer la fermeture
dune base

Si vous cochez cette case, le programme affichera une bote de message


lorsque vous tenterez de fermer la dernire fentre dune base ouverte
par 4D Insider, ce qui revient quitter la base et donc la session de
travail.

Montrer les n dID dans Cette option permet dafficher dans la liste Base le numro
la liste Base
didentification interne (ID) de chaque objet. Ce numro apparat
entre parenthses, droite du nom de lobjet.
Le numro didentification interne dun objet est un numro unique
utilis par 4D pour rfrencer chaque objet dans le fichier de structure
dune base. 4D Insider utilise galement ces numros pour rfrencer
les objets des bases et des librairies.
Vous naurez gnralement pas besoin de ces numros. Cependant,
lorsque par exemple 4D ou 4D Tools signale une erreur lie un objet,
le programme dsigne lobjet en cause par lintermdiaire de son
numro didentification interne. En recopiant tous les objets dun
fichier de structure abm lexception des objets endommags
dans un fichier vide (lorsque vous ne disposez pas de sauvegarde), vous
pouvez rcuprer manuellement votre structure.
Dans ce cas, les numros didentification vous seront utiles pour
reprer les objets endommags.
Ce type doption est galement utile pour les dveloppeurs qui
utilisent des outils de socits tierces rfrenant les objets de 4D par
leur numro dID.

N dID

Manuel de rfrence de 4D Insider

19

Chapitre 2 Dmarrer

Crer une base ou une librairie vierge


4D Insider travaille avec deux types de fichiers :

les fichiers de structure des bases 4D (extension .4DB sous Windows)

les librairies (extension .LIB ou .4IL sous Windows).


4D Insider vous permet de crer des bases ou des librairies vierges. Vous
y ajoutez des objets en les copiant dautres bases ou dautres librairies.
Lorsque vous crez et dveloppez des bases avec 4D Insider, vous
pouvez ensuite les exploiter avec 4D ou 4D Server, comme si elles
avaient t gnres par lune de ces applications.
Les librairies sont des fichiers crs par 4D Insider. Notez que les
fonctionnalits de 4D Insider sappliquent de manire quasiment
identique aux librairies et aux fichiers de structure des bases 4D.
Dans ce manuel, sauf indication spcifique, les explications et les
exemples concernent donc indiffremment les bases 4D et les librairies.

Quest-ce quune
librairie ?

20

Une librairie est un fichier propre 4D Insider, qui ne peut tre ouvert
que par ce logiciel.
A laide de la fonction de dplacement dobjets de 4D Insider, vous
pouvez dplacer dans une librairie tout type dobjet susceptible de
figurer dans vos bases. Vous pouvez ainsi regrouper dans un fichier
indpendant tous les objets qui vous sont utiles pour une ou plusieurs
fonctionnalits prcises.
Les librairies vous permettent galement, lors du dveloppement de
bases, de manipuler et dchanger des fichiers de taille rduite ne
regroupant que les objets ncessaires et non lintgralit dune
structure.
Par ailleurs, vous pouvez, grce une librairie, disposer dun champ
dessai quand vous prparez la copie dun nombre important dobjets
dune base vers une autre. Cela vous donne donc un droit
supplmentaire lerreur.

Manuel de rfrence de 4D Insider

Crer une base ou une librairie vierge

Pour crer une base ou une librairie :

1 Choisissez la commande Nouvelle base ou Nouvelle librairie dans le


menu Fichier de 4D Insider.
Commandes de cration
dune base ou dune librairie

Une fentre, intitule soit Base_1 soit Lib_1, apparat lcran. Elle
est vide par dfaut.

Manuel de rfrence de 4D Insider

21

Chapitre 2 Dmarrer

2 Construisez votre base ou votre librairie en faisant glisser dans la liste


Base des objets en provenance dautres bases ou librairies ouvertes.

Une librairie ne peut contenir que des objets dplaables.


Note Pour plus dinformations sur les objets dplaables, reportez-vous au
chapitre Dplacement dobjets, page 109.

Sauvegarder une base ou une librairie


Il nest pas ncessaire de sauvegarder priodiquement vos
modifications lorsque vous travaillez avec une base ou une librairie, car
vos actions sont crites directement dans le fichier de la base ou de la
librairie.
Toutefois, vous devez sauvegarder une base ou une librairie lorsque
celle-ci vient dtre cre avec 4D Insider.

Pour sauvegarder une base ou une librairie que vous venez de crer
avec 4D Insider :

1 Choisissez la commande Enregistrer sous... dans le menu Fichier.

22

Manuel de rfrence de 4D Insider

Ouvrir une base ou une librairie existante

Une bote de dialogue standard denregistrement de documents saffiche, vous permettant de baptiser votre base ou votre librairie et de
choisir son emplacement sur votre disque.
Si vous navez pas sauvegard votre base ou votre librairie et tentez de
refermer sa fentre ou de quitter lapplication 4D Insider, le
programme vous demande de confirmer votre action lorsque vous
fermez la fentre. Si vous cliquez sur Oui, la bote de dialogue standard
denregistrement de documents apparat.
Lorsque vous sauvegardez une base ne contenant aucune table,
4D Insider vous propose de lenregistrer sous forme de librairie.

Ouvrir une base ou une librairie existante


4D Insider vous offre le choix entre :

ouvrir une base ou une librairie qui se trouve sur votre disque (en
local),

ouvrir une base publie sur le rseau par 4D Server (sur le serveur...).

Note 4D Insider peut ouvrir simultanment plusieurs fichiers en local et une


seule base publie par 4D Server. Vous pouvez tout moment dcider
douvrir une autre base ou librairie partir du menu Fichier, tout en
conservant les fentres dj ouvertes.
Il est conseill de raliser une copie de votre base ou de votre librairie
avant de la modifier avec 4D Insider. En effet, si vous souhaitez effectuer des oprations telles que le dplacement de tables ou de champs,
il ne vous sera pas possible de les annuler en cas derreur.

Sous Windows, vous choisissez directement le type douverture.

Manuel de rfrence de 4D Insider

23

Chapitre 2 Dmarrer

Sous MacOS, la commande de menu Ouvrir est hirarchique et vous


permet de choisir entre louverture en local et sur 4D Server.

Commandes de
choix du type
douverture

MacOS
Windows

Ouverture en local

Pour ouvrir une base ou une librairie en local :

1 Choisissez la commande Ouvrir dans le menu Fichier (puis, sous


MacOS, le sous-menu En local...).
Une bote de dialogue standard douverture de documents saffiche,
vous permettant de slectionner la base ou la librairie ouvrir.
Sous Windows, vous pouvez dfinir les types de documents (structures
ou librairies) afficher dans cette bote de dialogue, avec le menu Type :

Documents .4IL : librairies gnres par 4D Insider version 6 ;

Documents .LIB : librairies gnres par 4D Insider version 2.5 ;

Documents .4DB : fichiers de structure des bases 4D.

Menu de choix du type


de document afficher
(Windows)

2 Slectionnez la base ou la librairie que vous souhaitez ouvrir et cliquez


sur le bouton Ouvrir.

24

Manuel de rfrence de 4D Insider

Ouvrir une base ou une librairie existante

Si laccs la structure de votre base requiert un mot de passe, il vous


est demand. Seul le mot de passe Super_Utilisateur est accept.
Notes Vous pouvez galement ouvrir une base ou une librairie en faisant
glisser son icne sur celle de lapplication 4D Insider (drag and drop).
Vous ne pouvez ouvrir que des bases non compiles.
Compatibilit
(ouverture en local)

En local, 4D Insider 6.8.x ouvre toute base convertie ou cre avec


4e Dimension ou 4D Server partir de la version 6.8. Si vos bases ont
t cres avec des versions antrieures, vous devez les convertir.
Note Pour toute conversion de librairies 4D Insider v.2, vous devez allouer
4D Insider une taille mmoire gale la taille de la librairie convertir.
4D Insider ouvre le fichier et construit la table des rfrences croises.
Une fentre affiche la progression de lopration :

Fichiers rcents

4D Insider conserve automatiquement en mmoire les chemins daccs


des cinq fichiers (bases et/ou librairies locales) les plus rcemment
utiliss. Ces fichiers sont lists dans le menu Fichier (Fichier>Fichiers
prfrs sous MacOS), vous permettant dy accder directement :

MacOS
Fichiers rcents
Windows

Manuel de rfrence de 4D Insider

25

Chapitre 2 Dmarrer

Ouverture sur
4D Server

Vous pouvez ouvrir toute base publie sur le rseau par 4D Server,
quelles que soient les plates-formes sur lesquelles 4D Insider et
4D Server sont lancs.
Note Le protocole rseau TCP/IP doit tre install sur votre machine.

Pour ouvrir une base publie par 4D Server :

1 Sous Windows, choisissez la commande Ouvrir sur serveur... dans le


menu Fichier de 4D Insider.
Sous MacOS, choisissez la commande Ouvrir puis la sous-commande
Sur 4D Server...
La bote de dialogue de connexion 4D Server saffiche :
Fentre de choix du
serveur (MacOS)

Note Pour plus dinformations sur cette bote de dialogue, reportez-vous au


Manuel de rfrence de 4D Server.
2 Slectionnez votre base puis cliquez sur OK.
Si laccs la structure de votre base requiert un mot de passe, il vous
est demand. Seul le mot de passe Super_Utilisateur est accept.
4D Insider construit alors la table des rfrences croises de la base,
comme pour un fichier ouvert en local.
Fichiers .tex et .tes

26

Lorsque vous vous connectez une base 4D Server avec 4D Insider, le


programme recopie en local, dans le dossier 4D :

les ressources de la structure (formulaires, mthodes...) dans un fichier


intitul MaBase.tex,

les fichiers des plug-ins (4D Write, 4D Draw...) dans un dossier intitul
MaBase,

les ressources de type STR# et les routines externes dans un fichier


MaBase.tes.

Manuel de rfrence de 4D Insider

Refaire lanalyse

Note Lemplacement du dossier 4D a t modifi compter de la version 6.8.


Pour plus dinformations sur ce point, reportez-vous au manuel Mise
jour de 4D 6.8.
Ces fichiers contiennent les mmes informations que celles stockes
dans les fichiers des postes clients : dossier MaBase, MaBase.tes
(correspond au fichier 4D Client MaBase.res) et MaBase.tex (correspond
au fichier 4D Client MaBase.rex).
Ce fonctionnement vous permet de vous connecter simultanment
une mme base avec 4D Client et 4D Insider, depuis le mme poste.
Note 4D Insider se comporte comme un 4D Client en mode lecture
seulement. Aussi, il nest pas possible de modifier les objets dune base
(exception faite des commentaires) en cours dexploitation par
4D Server.
Compatibilit
(ouverture sur
4D Server)

4D Insider se comportant comme un 4D Client, les numros de version


de 4D Insider et de 4D Server doivent correspondre. Ainsi,
4D Insider 6.8 nouvre que des bases publies avec 4D Server partir de
la version 6.8. Si vos bases sont publies avec des versions antrieures,
vous devez effectuer une mise jour de 4D Server.

Refaire lanalyse
Lorsque vous ouvrez avec 4D Insider une base publie par 4D Server, il
peut arriver que la structure ou les objets de la base soient modifis par
dautres utilisateurs pendant la session de travail. La table des
rfrences croises construite par 4D Insider devient alors obsolte.
Note Sous MacOS, lorsque la
structure de la base a t
modifie, le mot Analyse
clignote dans la barre de titre de la fentre active de 4D Insider.
Pour mettre jour les informations, slectionnez la commande Refaire
lanalyse dans le menu Outils.
4D Insider recommence alors lanalyse de la structure de la base, la
fentre de progression saffiche.

Manuel de rfrence de 4D Insider

27

Chapitre 2 Dmarrer

Fermer une base ou une librairie


Vous refermez une base ou une librairie en fermant ses fentres.

Pour fermer une fentre :

1 Choisissez Fermer dans le menu Fichier, OU BIEN


Sous Windows, double-cliquez sur sa case du menu Systme,
Sous MacOS, cliquez sur sa case de fermeture.

Pour fermer toutes les fentres dune base ou librairie :

1 Choisissez Tout fermer dans le menu Fichier, OU BIEN


Sous Windows, utilisez la combinaison Alt+clic sur la case de fermeture
dune fentre ou sur la case du menu Systme,
Sous MacOS, utilisez la combinaison Option+clic sur la case de
fermeture dune fentre.
Si vous souhaitez que 4D Insider signale la fermeture de la dernire
fentre dune base, vous pouvez cocher loption Confirmer la
fermeture dune base dans la fentre des Prfrences gnrales (cf.
paragraphe Confirmer la fermeture dune base, page 19).

28

Manuel de rfrence de 4D Insider

Navigation parmi les


objets

Lorsque vous ouvrez une base ou une librairie avec 4D Insider, le


programme commence par lanalyser afin didentifier chaque objet de
la base et de dterminer ses ventuelles interactions avec les autres
objets. Le rsultat de cette analyse est affich dans la fentre principale
de 4D Insider.
Ce chapitre dcrit les oprations que vous pouvez effectuer partir de
cette fentre :

Visualiser les objets et leurs relations,

Visualiser le contenu et les caractristiques dun objet,

Manipuler les listes, cest--dire dplacer les listes et filtrer les objets
quelles affichent,

Rorganiser la fentre de navigation.

Visualiser les objets et leurs relations


Une fois que 4D Insider a analys les objets de la base, le programme
affiche une fentre de navigation pour cette base. La fentre de navigation comporte trois listes : Source, Base et Cible. La barre de titre situe
au-dessus de chaque liste indique le nom de la liste, le type de filtre ou
dopration qui lui est appliqu ainsi que le nombre dobjets quelle
contient actuellement.
Au-dessous des listes se trouvent la zone dinformation, affichant des
renseignements supplmentaires sur lobjet slectionn, et la zone
graphique, affichant le contenu de lobjet.

Manuel de rfrence de 4D Insider

29

Chapitre 3 Navigation parmi les objets

Lorsque vous ouvrez une base pour la premire fois, la liste Base
contient les noms de tous les objets de la base, classs par type et par
nom. Vous pourrez par la suite rduire cette liste de manire
nafficher quune sous-slection dobjets ou un certain type dobjets.
Liste Base

Liste des objets source

Liste des objets cible

Nombre dobjets
contenus dans la liste

Zone dinformation

Zone graphique

Slectionner une
zone de la fentre

Lorsque vous ouvrez une nouvelle fentre de navigation, la liste Base


est slectionne par dfaut.

Pour slectionner une autre zone :

1 Cliquez sur la zone slectionner.


OU
Appuyez sur la touche Tab ou Maj+Tab.
Lorsque vous appuyez sur la touche Tab, chaque zone est slectionne
alternativement :

Maj+Tab provoque la slection en sens inverse.

Types dobjets
affichs

Par dfaut, la liste Base contient les noms de tous les objets de la base.
Les listes Source et Cible contiennent les noms des objets lis lobjet
slectionn dans la liste Base.
Dans chaque liste de la fentre de navigation, les objets sont identifis
par leur nom et leur type. Le type dun objet est indiqu par licne
situe sa gauche.

30

Manuel de rfrence de 4D Insider

Visualiser les objets et leurs relations

Voici lensemble des types dobjets qui peuvent tre identifis par
4D Insider dans une base, ainsi que leurs icnes :

Tables et champs

Messages daide

Groupes

Barres de menus

Menus

Sous-tables

Mthodes projet

Enumrations

Plug-ins

Ensembles

Mthodes objet

Commandes 4D

Slections Temporaires

Tables

Smaphores

Champs

STR# (listes de chanes de


caractres)

Formulaires

Formats/Filtres

Triggers

Variables

Mthodes formulaire

Constantes

Mthodes base

Images

Feuilles de style

Composants

Les tables et les champs sont affichs de manire hirarchique. Pour


visualiser les champs dune table, cliquez sur licne de dploiement
situe gauche de lobjet :

Clic sur le triangle

Si une table contient des sous-tables, vous pouvez cliquez de la mme


manire sur licne de dploiement afin dafficher les sous-champs.
Manuel de rfrence de 4D Insider

31

Chapitre 3 Navigation parmi les objets

Objets estims non


utiliss dans le fichier
ouvert

Un objet non utilis est un objet qui nest pas appel explicitement par
un autre objet de la base. Par exemple, une mthode non utilise est
une mthode qui nest excute ni par une autre mthode (mthode
base, mthode projet, Trigger ou mthode objet) ni par une commande
de menu.
Dans les listes, un objet apparat en rouge (sur un cran couleur) ou en
gras (sur un cran noir et blanc), lorsque 4D Insider estime que cet
objet nest pas utilis dans la base.
Toutefois, il peut arriver quun objet utilis soit estim non utilis ; cela
dpend de la manire dont il est appel dans votre code. Dans
lexemple suivant, 4D Insider conclura sans problme que la mthode
utilise la commande FORMULAIRE ENTREE et le formulaire
formulaire1 :
FORMULAIRE ENTREE ("formulaire1")
Mais il existe deux cas dans lesquels 4D Insider ne pourra pas
reconnatre un objet :

Cas n1 : un objet nest pas reconnu si sa rfrence dpend de lexcution de la mthode. Examinons lexemple suivant :
FORMULAIRE ENTREE ("formulaire"+Chaine(TailleEcran))
Lobjet TailleEcran prend par exemple la valeur 1 lors de lexcution du
code. Dans ce cas, 4D Insider ne peut pas dterminer les formulaires
concerns. En effet, la rfrence du formulaire (son nom) nest pas
explicite. Les rfrences calcules des objets ne sont pas interprtes
par 4D Insider. Cette rgle sapplique tous les objets rfrencs entre
guillemets dans 4D : formulaires, smaphores, slections, ensembles, et
parfois mthodes (lors de lutilisation de la commande EXECUTER).

Cas n2 : un objet nest pas reconnu sil est lun des paramtres dune
mthode utilisateur et non dune commande ou fonction 4D. Par
exemple, linstruction suivante utilise une mthode utilisateur pour
centrer une fentre lcran :
CentrerFenetre (Largeur;Hauteur;Type;Titre; CASE FERMETURE)
Le cinquime paramtre, CASE FERMETURE, est une mthode
utilisateur qui gre les actions dclencher lorsque lutilisateur doubleclique sur la case du menu Systme. Cependant, comme CentrerFenetre
est une mthode utilisateur, 4D Insider ne reconnatra pas CASE
FERMETURE dans ce cas.

32

Manuel de rfrence de 4D Insider

Visualiser les objets et leurs relations

Si vous voulez vous assurer que 4D Insider reconnatra bien tous les
objets passs comme paramtres aux mthodes utilisateur, vous
pouvez ajouter quelques lignes votre code afin de rfrencer
explicitement les objets. Pour reprendre lexemple prcdent, vous
pourriez rfrencer la mthode en lappelant dans une condition
Si...Fin de si qui nest jamais vraie :
Si (Faux)
`Cela ne sera jamais vrai
CASE FERMETURE
`Appeler directement la mthode
Fin de si
CentrerFenetre (Largeur;Hauteur;Type;Titre; CASE FERMETURE)

Visualiser les
relations entre les
objets

4D Insider vous permet de visualiser de plusieurs manires les relations


existantes entre les objets de la base. Les listes de la fentre de
navigation vous permettent de :

Visualiser tous les objets lis un objet particulier,

Visualiser lobjet parent dun objet particulier.

Visualiser les objets lis Lorsque vous cliquez sur lun des objets de la liste principale, les deux
un objet
listes secondaires sont automatiquement mises jour.
Vous voyez apparatre, dans la liste Cible, le nom de tous les objets qui
sont rfrencs par celui qui a t prcdemment slectionn. La liste
Source, quant elle, contient le nom de tous les objets qui font
rfrence lobjet slectionn.

Lobjet slectionn est


utilis par ces objets
Objet slectionn

Lobjet slectionn
utilise ces objets

Manuel de rfrence de 4D Insider

33

Chapitre 3 Navigation parmi les objets

Dans lexemple prcdent, la liste des objets utiliss par la mthode


projet (objets cible) contient donc :

la table [Table1],

le formulaire [Table1];Formulaire1,

la fonction Creer fenetre,

la commande DIALOGUE.

La liste des objets utilisant cette mthode projet (objets source) nous
apprend quelle est lie la barre de menus n1 et au menu rfrenc
:79,1.
Visualiser le parent dun Certains types dobjets sont directement lis dautres types dobjets,
objet
sans lesquels ils ne pourraient exister. Par exemple, un formulaire ne
peut exister sans une table. Dans ce cas, la table est lobjet parent du
formulaire.
Le tableau ci-dessous liste les types dobjets ayant des parents et fournit
leur type :

Type dobjet

Type dobjet parent

Champ
Sous-table
Formulaire
Trigger
Mthode objet
Mthode formulaire

Table
Table
Table
Table
Formulaire
Formulaire

Pour visualiser le parent dun objet dans une nouvelle fentre :

1 Sous Windows, cliquez avec le bouton droit de la souris sur lobjet.


Sous MacOS, utilisez la combinaison Contrle+clic sur lobjet.
Note Vous pouvez cliquer sur un objet dans nimporte quelle liste. Il nest
pas ncessaire que lobjet se trouve dans la liste Base.
Une nouvelle fentre de navigation apparat.

34

Manuel de rfrence de 4D Insider

Visualiser le contenu dun objet

Lobjet parent est slectionn dans la liste Base.

Clic bouton droit


(Windows) ou
Contrle+clic
(MacOS)
sur la mthode
formulaire
Nouvelle fentre
centre sur lobjet
parent (formulaire)

Visualiser le contenu dun objet

Pour visualiser le contenu dun objet list dans la fentre de


navigation :

1 Double-cliquez sur le nom de lobjet.


OU
Slectionnez le nom de lobjet et appuyez sur la touche Entre.
Les caractristiques de lobjet saffichent dans la zone dinformations
de la fentre de navigation, en gnral : type de lobjet, nom de lobjet,
date de cration et de modification, identifiant interne, taille en octets.
En outre, la zone graphique affiche, lorsque cest possible, le contenu
de lobjet. La reprsentation graphique varie selon le type de lobjet
slectionn. Ce paragraphe dtaille les fonctionnalits de chacun
deux.

Manuel de rfrence de 4D Insider

35

Chapitre 3 Navigation parmi les objets

Barres de menus

Lorsque vous double-cliquez sur un objet de type Barre de menus, vous


voyez apparatre dans la zone graphique une reprsentation de la barre
slectionne, qui simule galement son fonctionnement. Vous pouvez
donc cliquer sur lun des menus pour le drouler.

Si le titre et/ou les commandes de vos menus rfrencent des STR#,


vous pourrez choisir dafficher soit leur numro (option Texte, par
dfaut), soit leur contenu (tel quil apparat en mode Utilisation ou
Menus crs dans 4D). Pour cela, utilisez le pop up menu situ en haut
droite de la zone daffichage.

Mode
daffichage des
barres de menus

Note Pour plus dinformations sur les STR#, reportez-vous au chapitre Aide
la traduction, page 89.

Bibliothque
dimages

36

Le filtre Bibliothque dimages fait apparatre toutes le images


prsentes dans la bibliothque. Le double-clic sur une image de la
bibliothque provoque laffichage de limage dans la zone graphique.

Manuel de rfrence de 4D Insider

Visualiser le contenu dun objet

Champs et soustables

Les champs et sous-tables sont lis une table. De la mme faon que
pour les tables, la zone graphique donne son type et ses proprits.

Commandes 4D

La nature mme de ce type dobjet ne permet pas de reprsentation


graphique ; si vous double-cliquez sur un objet de type Commande 4D,
la zone graphique restera vide.

Composants

La nature mme de ce type dobjet ne permet pas de reprsentation


graphique ; si vous double-cliquez sur un objet de type Composant, la
zone graphique restera vide.
Note Pour plus dinformations sur les composants, reportez-vous au chapitre
Gestion des composants 4D, page 125.

Constantes

Lorsque vous double-cliquez sur le nom dune constante, sa valeur


saffiche dans la zone d'informations.

Ensembles

La nature mme de ce type dobjet ne permet pas de reprsentation


graphique ; si vous double-cliquez sur un objet de type Ensemble, la
zone graphique restera vide.

Enumrations

Lorsque vous double-cliquez sur un objet de type Enumration, vous


visualisez son contenu ou ses valeurs dans la zone graphique.

Manuel de rfrence de 4D Insider

37

Chapitre 3 Navigation parmi les objets

Feuilles de style

Le double-clic sur une feuille de style provoque laffichage de ses


proprits, telles quelles ont t dfinies dans 4e Dimension.

Formats/Filtres

Le double-clic sur un objet de type format/filtre provoque laffichage


de son contenu, tel quil a t saisi dans 4e Dimension.

Formulaires

Lorsque vous double-cliquez sur un formulaire, il saffiche dans la zone


graphique tel quil a t conu dans le mode Structure de 4D.
Le menu situ en haut droite de la zone dinformation vous permet
de faire varier le contenu de la zone graphique. Vous pouvez afficher :

le texte :

Mode daffichage
des formulaires

38

Manuel de rfrence de 4D Insider

Visualiser le contenu dun objet

le formulaire tel quil apparat en mode Utilisation/Menus crs, cest-dire affichant le contenu des STR# (sil en existe) :

Note Pour plus dinformations sur les STR#, reportez-vous au chapitre Aide
la traduction, page 89.

le nom des variables :

Note Vous pouvez copier le contenu de la page laide du menu Edition.


En bas de la zone graphique se trouvent quatre boutons en forme de
flche. Ils vous permettent de vous dplacer dans les pages dun
formulaire multi-page.
Boutons de navigation dans
un formulaire multi-page

Manuel de rfrence de 4D Insider

39

Chapitre 3 Navigation parmi les objets

Lorsque vous affichez un formulaire, les objets auxquels sont associs


une mthode contiennent un triangle invers dans leur coin suprieur
gauche.

Pour afficher le contenu dune mthode objet ou les informations concernant un champ directement dans la fentre courante, double-cliquez sur lobjet dans la zone graphique ou dans la liste.

Pour revenir laffichage du formulaire dans la zone graphique, double-cliquez sur la liste.

Pour afficher le contenu ou les informations dun champ dans une


nouvelle fentre, cliquez sur lobjet en maintenant la touche Alt (sous
Windows) ou Option (sous MacOS) enfonce.

Note 4D Insider vous permet de redimensionner globalement tous les


formulaires de votre base ou de votre librairie. Pour plus
dinformations sur ce point, reportez-vous au chapitre
Redimensionnement des formulaires, page 105.

Groupes

La nature mme de ce type dobjet ne permet pas de reprsentation


graphique ; si vous double-cliquez sur un objet de type Groupe, la zone
graphique restera vide.
A la diffrence de tous les autres objets, les groupes ne sont pas des
objets gnrs par 4e Dimension mais par 4D Insider. Ils ne sont donc
visibles quavec ce dernier.
Note Pour plus dinformations sur les groupes, reportez-vous au chapitre
Groupes, page 53.

Menus

4e Dimension offre la possibilit dutiliser le mme menu dans


diffrentes barres de menus. Vous connectez un menu une barre.
Dans 4D Insider, les menus sont donc reprsents indpendamment
des barres pour reflter cette fonctionnalit de 4e Dimension.
Laffichage dun menu vous rvle non seulement le texte des menus,
mais aussi leur mthode associe.

40

Manuel de rfrence de 4D Insider

Visualiser le contenu dun objet

Et comme prcdemment, si le titre et/ou les commandes de vos


menus rfrencent des STR#, vous pourrez choisir soit dafficher leur
numro (option par dfaut), soit dafficher leur contenu, en utilisant le
pop up menu qui se situe en haut droite de la zone daffichage.

Mode daffichage
des commandes
de menus

Pour afficher dans la fentre courante la mthode associe une commande de menu, double-cliquez sur celle-ci dans la zone graphique.

Pour afficher la mthode associe une commande de menu dans une


nouvelle fentre, il suffit de cliquer sur le nom de la commande tout en
maintenant la touche Alt (Windows) ou Option (MacOS) enfonce.

Note Le caractre , plac dans la zone dinformations, signale que le


menu est un objet dlimiteur. Pour plus dinformations sur ce point,
reportez-vous au paragraphe Objets dlimiteurs, page 120.

Messages daide

Lobjet Message daide regroupe deux types dobjets :

les info-bulles,

les bulles daide (MacOS uniquement).

Le texte de ces deux types dobjets est stock au mme endroit, quelle
quen soit lutilisation.

Manuel de rfrence de 4D Insider

41

Chapitre 3 Navigation parmi les objets

Lorsque vous double-cliquez sur un objet de type Message daide, vous


visualisez le texte du message dans la zone graphique :

Mthodes base,
projet, formulaire,
objet et triggers

La zone graphique de ces cinq objets est identique. Lorsque vous


double-cliquez sur lun de ces types dobjet, la zone graphique affiche
le texte des mthodes tel quil apparat dans lditeur de 4e Dimension.
Vous pouvez slectionner et copier ce texte laide du menu Edition.

Icne des mthodes


base et des mthodes
projet

Plug ins

4D Insider vous permet de visualiser les routines des plug ins placs
dans les dossiers Mac4DX et/ou Win4DX, ainsi que leurs rfrences
croises, tout comme pour les routines de 4e Dimension. Si vous
double-cliquez sur un objet de ce type, la zone graphique reste vide.
Note 4D Insider nest pas compatible avec lancien systme des Routines
externes.

42

Manuel de rfrence de 4D Insider

Visualiser le contenu dun objet

Ressources STR#

Vous pouvez visualiser une ressource de type STR# (chane) dans la


zone graphique lorsque vous double-cliquez dessus.

Note Pour plus dinformations sur les ressources, reportez-vous au chapitre


Aide la traduction, page 89.

Slections
temporaires

La nature mme de ce type dobjet ne permet pas de reprsentation


graphique ; si vous double-cliquez sur un objet de type Slection
temporaire, la zone graphique restera vide.

Smaphores

La nature mme de ce type dobjet ne permet pas de reprsentation


graphique ; si vous double-cliquez sur un objet de type Smaphore, la
zone graphique restera vide.

Tables

Lorsque vous double-cliquez sur un objet de type Table, vous visualisez


son nom dans la zone dinformation et ses proprits dans la zone
graphique.
Notez la prsence dun petit triangle gauche du nom des tables dans
la liste. Un clic sur ce triangle provoque le dploiement des champs de
la table. Si la table comporte une ou plusieurs sous-tables, elles seront
de la mme faon prcdes dun triangle.

Manuel de rfrence de 4D Insider

43

Chapitre 3 Navigation parmi les objets

Variables

La nature mme dune variable ne permet pas de reprsentation


graphique ; si vous double-cliquez sur un objet de type Variable, la
zone graphique restera vide.
La zone dinformation peut cependant vous donner davantage de
renseignements sur une variable. En effet, si votre base a t compile
et une table des symboles gnre, 4D Insider la reconnatra
automatiquement et rcuprera linformation de typage fournie par le
compilateur. 4D Insider requiert seulement les conditions suivantes :

Sous Windows, la table des symboles doit tre place dans le rpertoire
de la base interprte et porter le mme nom, suivi de lextension
.sym.

Sous MacOS, la table des symboles doit tre place dans le dossier de la
base interprte et porter le mme nom, suivi de .symb.
Il vous suffit alors de double-cliquer sur une variable pour afficher deux
informations supplmentaires : le type de la variable et la mthode
ayant dtermin ce type.

Manipuler les listes de la fentre de navigation


Ce paragraphe dcrit les oprations que vous pouvez effectuer sur les
listes de la fentre de navigation de 4D Insider.

Activation des
menus

4D Insider vous permet deffectuer diffrents types dactions sur les


objets de la base laide des menus Outils et Edition. Les commandes de
ces menus, lexception des commandes Chercher, Documentation
gnrale et Refaire lanalyse sactivent et se dsactivent en fonction de
la zone slectionne ou encore de la slection dobjets au sein dune
zone. Pour quune liste soit slectionne, son titre doit lui-mme tre
slectionn.
Note Chercher est accessible tout moment et affiche le rsultat de sa
recherche dans la liste principale. Documentation et Refaire lanalyse
ont une action globale la base.

44

Les commandes du menu Outils sactivent lorsque la zone principale


est slectionne et provoquent des modifications dans cette dernire
uniquement (sur toute la liste ou sur la slection dobjets selon la commande choisie).

Manuel de rfrence de 4D Insider

Manipuler les listes de la fentre de navigation

Les commandes du menu Edition sappliquent la liste slectionne


(Tout slectionner, Sous-slection) ou la zone graphique (Tout slectionner, Copier... selon le contenu de la zone graphique).

Note Les fonctions de copier/coller peuvent sappliquer au contenu de la


zone graphique (en totalit ou partiellement, selon le type dobjet
affich) depuis 4D Insider vers une base 4D ouverte en mode Structure.

Slectionner une
liste ou une zone

Pour slectionner une liste :

1 Cliquez dans la barre de titre de la liste.


Vous pouvez slectionner alternativement chaque liste laide de la
touche Tab (Maj+Tab : slection en sens inverse).
Cliquer sur un objet dune liste provoque la slection de lobjet et de la
liste (le titre de la liste est slectionn).
Cliquer sur le titre dune liste provoque la slection de la liste. Si un
objet tait slectionn prcdemment, celui-ci est de nouveau
slectionn.

Pour slectionner la zone daffichage :

1 Cliquez dans la zone graphique ou la zone dinformation.


Un trait noir saffiche au-dessus de la zone d'information pour indiquer
quelle est slectionne.

Slectionner un
objet

Pour slectionner un objet dans une liste :


Cliquez sur lobjet.
OU BIEN :
Tapez au clavier les premires lettres de lobjet.
OU BIEN :
Utilisez les touches de dfilement.
Notez que seule la slection dun objet de la liste principale entrane la
mise jour des deux listes latrales (Source et Cible).

Manuel de rfrence de 4D Insider

45

Chapitre 3 Navigation parmi les objets

Slectionner
plusieurs objets

Pour effectuer une slection continue dobjets :

1 Cliquez sur le premier objet slectionner.


2 Appuyez sur la touche Majuscule et cliquez sur le dernier objet
slectionner.
Tous les objets compris entre le premier et le dernier sont slectionns.

Pour effectuer une slection discontinue dobjets :

1 Cliquez sur le premier objet slectionner.


2 Appuyez sur la touche Ctrl (sous Windows) ou Commande (sous
MacOS) et cliquez sur chaque objet slectionner.

Dslectionner un
objet

Vous pouvez utiliser la combinaison dcrite ci-dessus pour


dslectionner un objet auparavant slectionn. Si, par exemple, vous
souhaitez slectionner tous les objets dune liste sauf un (qui se trouve
au centre de la liste), vous pouvez slectionner tous les objets puis
utiliser la combinaison Ctrl+clic (ou Commande+clic) sur lobjet
dslectionner.

Tout slectionner

Pour slectionner tous les objets prsents dans une liste, choisissez la
commande Tout slectionner dans le menu Edition.

Rduire une liste aux Vous pouvez slectionner des objets dans une liste puis rduire le
objets slectionns contenu de la liste lensemble des objets slectionns. Vous crez
ainsi une sous-slection.
Les sous-slections sont utiles, par exemple, lorsque vous souhaitez
imprimer ou exporter une partie des objets de votre base ou librairie
(cf. chapitre Impression et export, page 101). De mme, vous pouvez
souhaiter crer une sous-slection avant deffectuer une recherche, afin
de limiter la recherche la sous-slection.

Pour que votre liste soit rduite aux objets que vous avez slectionns :

1 Slectionnez les objets conserver dans une des listes.


Pour cela, utilisez les combinaisons dcrites ci-dessus.
2 Choisissez la commande Sous-slection dans le menu Edition.
OU BIEN :
Sous Windows, cliquez dans le titre de la liste avec le bouton droit de
la souris.
46

Manuel de rfrence de 4D Insider

Manipuler les listes de la fentre de navigation

Sous MacOS, cliquez dans le titre de la liste en maintenant la touche


Contrle enfonce.
La liste est alors intitule Slection et ne contient plus que les objets
que vous avez choisis.

Sous-slections
automatiques

Une sous-slection peut galement tre le rsultat des oprations


suivantes :

application dun filtre : laide du pop-up menu situ droite de la


barre de titre de chaque liste, vous pouvez rduire le contenu de la liste
aux objets du type spcifi par le filtre.

Pour plus dinformations, reportez-vous au chapitre Filtres, recherches


et remplacements, page 67.

excution dune recherche : lorsque vous lancez une recherche avec


4D Insider, le rsultat de la recherche saffiche dans la liste principale.
Pour plus dinformations, reportez-vous au chapitre Filtres, recherches
et remplacements, page 67.

slection dun objet dans la liste Base : la slection dun objet dans la
liste Base provoque laffichage de nouvelles sous-slections dans les listes Source et Cible, correspondant aux objets utilisant et utiliss par
lobjet slectionn.

remplacement du contenu de la liste Base par celui de la liste Source


ou Cible. Pour plus dinformations, reportez-vous au paragraphe suivant.

Manuel de rfrence de 4D Insider

47

Chapitre 3 Navigation parmi les objets

Remplacer la liste
principale par une
liste secondaire

Pour aller plus loin dans lanalyse des objets cible ou celle des objets
source, vous pouvez considrer la liste des objets cible ou des objets
source comme une nouvelle liste principale. Il suffit pour cela de
remplacer le contenu de la liste principale par celui de la liste des objets
cible ou celui de la liste des objets source.

Pour remplacer la liste principale par une liste secondaire :

1 Cliquez dans le titre de la liste de remplacement.


2 Faites glisser le cadre de cette liste vers la liste principale, tout en
maintenant le bouton de la souris enfonc.

3 Relchez le bouton de la souris.


Vous pouvez galement utiliser des quivalents clavier :

48

Sous MacOS
Commande+ ou Commande+ : cibles vers liste principale
Commande+ ou Commande+ : sources vers liste principale

Sous Windows
Ctrl+ ou Ctrl+ : cibles vers liste principale
Ctrl+ ou Ctrl+ : sources vers liste principale

Manuel de rfrence de 4D Insider

Rorganiser les fentres de navigation

Ouvrir une nouvelle Si vous voulez travailler avec un objet particulier tout en conservant le
fentre centre sur contenu de la fentre courante intacte, vous pouvez ouvrir une
un objet slectionn nouvelle fentre avec lobjet slectionn dans la liste Base.

Pour ouvrir une nouvelle fentre centre sur lobjet slectionn :

1 Cliquez sur un objet en maintenant la touche Alt (Windows) ou Option


(MacOS) enfonce.
Note Vous pouvez cliquer sur un objet de nimporte laquelle des listes.
Une nouvelle fentre apparat, comportant lobjet slectionn dans la
liste Base. La fentre dorigine et son contenu restent inchangs.

Rorganiser les fentres de navigation


4D Insider vous permet de rorganiser votre convenance les zones
(dimensions, emplacement...) de chaque fentre ouverte.
Vous pouvez afficher simultanment autant de fentres que vous
voulez (identifiables par un numro plac derrire leur nom) pour
chaque base ou librairie ouverte. Vous ntes limit que par la mmoire
disponible.

Modifier les
dimensions

Les zones sont spares par des doubles lignes horizontales et


verticales. Il est possible de modifier la dimension de chaque zone
laide de ces lignes.

Pour modifier les dimensions dune zone :

1 Placez le curseur de la souris au-dessus dune double ligne de


sparation.
Le pointeur se transforme alors en une double flche.

Manuel de rfrence de 4D Insider

49

Chapitre 3 Navigation parmi les objets

2 Dplacez la double ligne jusqu la position souhaite en maintenant


le bouton de la souris enfonc.

Note Les dimensions des zones peuvent tre dfinies par dfaut. Pour plus
dinformations sur ce point, reportez-vous au paragraphe Modifier les
Prfrences gnrales, page 17.

Disposition des
zones

Vous pouvez choisir la disposition gnrale des zones des fentres


ouvertes.

Pour modifier la disposition des zones :

1 Choisissez une commande du menu Fentres,


Commandes de disposition des
zones des fentres

Vous avez le choix entre trois modes daffichage :

50

Listes en haut (mode par dfaut louverture de 4D Insider) ;

Manuel de rfrence de 4D Insider

Rorganiser les fentres de navigation

Listes gauche :

Listes en bas :

La disposition que vous choisissez sapplique uniquement la fentre


courante, cest--dire la fentre qui se trouve au premier plan.
Vous pouvez dfinir une disposition par dfaut, sappliquant toutes
les fentres ouvertes. Pour plus dinformations sur ce point, reportezvous au paragraphe Modifier les Prfrences gnrales, page 17.

Manuel de rfrence de 4D Insider

51

Chapitre 3 Navigation parmi les objets

Organiser les
diffrentes fentres
ouvertes

Le menu Fentres liste les noms des fentres ouvertes simultanment :


il vous permet de passer dune fentre lautre.

Aprs une session de travail consquente, il se peut que vous ayez un


enchevtrement de fentres lcran. Pour les ranger, vous pouvez
utiliser les commandes Aligner ou Empiler.

52

Aligner rorganise votre cran en juxtaposant toutes les fentres.

Empiler les regroupe au mme endroit en les dcalant lgrement.

Manuel de rfrence de 4D Insider

Groupes

Pour faciliter le dveloppement de code modulaire, cest--dire


rutilisable et maintenable facilement, 4D Insider vous permet de
regrouper et de structurer vos objets lintrieur de groupes.

Prsentation
Dfinition

Les groupes constituent un moyen de runir les objets dune structure


par fonctionnalit. Ce regroupement peut se faire lintrieur mme
dune structure ou dans une librairie.
Un groupe est considr par 4D Insider comme un objet.
Contrairement aux librairies, le principe de fonctionnement des
groupes nest pas la duplication des objets de votre base, mais leur
rassemblement au sein dun dossier intitul groupe.

Vous pouvez crer autant de groupes que vous le souhaitez pour


chaque base ou librairie.
Lutilit dun groupe est de clarifier lorganisation dune base et de
faciliter le dplacement de fonctionnalits entires, une fois les
modules de votre base clairement identifis. Vous pouvez donc ainsi
regrouper tous les objets formant un outil de facturation dans un
groupe et tous ceux grant la gestion de stock dans un autre.
Il est galement possible, lintrieur dun groupe, dorganiser des sousgroupes, et ainsi de suite.

Manuel de rfrence de 4D Insider

53

Chapitre 4 Groupes

Oprations sur les


objets groups

Toutes les fonctions de 4D Insider continuent de sappliquer aux objets


placs dans un groupe.

Note Les objets placs dans un groupe ne sont plus comptabiliss par
4D Insider dans la barre de titre des listes. Par exemple, si un groupe
comportant 5 objets est prsent dans une liste, seul lobjet Groupe sera
comptabilis.
En ce qui concerne les filtres, les groupes saffichent la suite des autres
objets, quel que soit le type de filtre qui est appliqu. Dans le cas dune
slection laquelle vous avez appliqu un filtre, le groupe ouvert
naffichera que les objets correspondant ce filtre.
Lorsque vous effectuez une recherche, il se peut que certains des objets
rpondant aux critres de recherche se trouvent lintrieur dun
groupe. Dans ce cas, le groupe apparatra dans la liste issue de la
recherche, mais naffichera plus que les objets trouvs.

Crer/Modifier un groupe

Pour crer un groupe :

1 Ouvrez la structure dune base ou dune librairie avec 4D Insider.


2 Choisissez la commande Nouveau groupe... dans le menu Outils :

54

Manuel de rfrence de 4D Insider

Crer/Modifier un groupe

Une bote de dialogue saffiche, vous permettant de saisir le nom du


groupe :

3 Saisissez un nom et validez la bote de dialogue.


Vous pourrez changer ce nom ultrieurement en utilisant la fonction
Renommer de 4D Insider.
Le nouveau groupe sajoute la fin de la liste principale de votre fentre.

Pour ajouter un ou plusieurs objets un groupe :

1 Slectionnez le ou les objet(s) inclure dans le groupe.


Les diffrentes modes de slection de 4D Insider sont dcrits dans le
paragraphe Manipuler les listes de la fentre de navigation, page 44.
2 Placez le curseur au-dessus de licne dun des objets slectionns.
Le curseur se transforme en un curseur de dplacement :
3 Faites glisser votre slection vers licne du groupe.
Bien entendu, seuls les objets dplaables peuvent tre placs dans
un groupe.
Note Pour plus dinformations sur les objets dplaables, reportez-vous au
chapitre Dplacement dobjets, page 109.

Manuel de rfrence de 4D Insider

55

Chapitre 4 Groupes

Pour faciliter ces dplacements, vous pouvez ouvrir une deuxime


fentre pour la mme base ou librairie et faire glisser les objets dune
fentre lautre.

Pour ouvrir un groupe et visualiser son contenu :

1 Cliquez sur licne de dploiement en forme de triangle qui se trouve


gauche du nom du groupe :

Pour le refermer, rptez la mme opration.

Pour enlever un ou plusieurs objet(s) dun groupe :

1 Slectionnez le ou les objet(s) enlever lintrieur du groupe.


2 Faites glisser votre slection et dposez-la hors du groupe ou sur le
titre de la liste :

56

Manuel de rfrence de 4D Insider

Crer un groupe partir dune slection

Crer un groupe partir dune slection


4D Insider vous permet de crer directement un groupe contenant des
objets, partir dune slection pralable.

Pour cela, procdez de la manire suivante :

1 Dans la liste principale, slectionnez les objets que vous souhaitez voir
figurer dans votre groupe.
Les diffrentes modes de slection de 4D Insider sont dcrits dans le
paragraphe Manipuler les listes de la fentre de navigation, page 44.
2 Choisissez la commande Regrouper les objets... dans le menu Outils :

La bote de dialogue de saisie dun nom du groupe apparat.

3 Saisissez un nom et validez la bote de dialogue.


Le groupe est ajout la fin de la liste Base.

Manuel de rfrence de 4D Insider

57

Chapitre 4 Groupes

Regrouper avec les dpendances


Il est possible de grouper une slection dobjets avec leurs
dpendances, cest--dire leurs objets cibles. Dans ce cas, le nouveau
groupe est form de tous les objets slectionns et de leurs rfrences.

Pour cela, procdez de la manire suivante :

1 Slectionnez dans la liste principale les objets que vous souhaitez


regrouper.
2 Choisissez la commande Regrouper avec leurs dpendances... dans le
menu Outils.
La bote de dialogue de saisie du nom du groupe apparat.

3 Saisissez un nom et validez la bote de dialogue.


Le groupe sajoute la liste principale. Lorsque vous louvrez, vous
constatez quil contient les objets slectionns ainsi que toutes leurs
dpendances.

Dgrouper/Supprimer un groupe
Vous pouvez tout moment supprimer un groupe. Cette opration fait
disparatre lobjet Groupe de votre liste et les objets quil contient
sont replacs dans la base ou la librairie.

Pour cela, procdez de la manire suivante :

1 Slectionnez le groupe que vous souhaitez supprimer.

58

Manuel de rfrence de 4D Insider

Dgrouper/Supprimer un groupe

2 Choisissez la commande Dgrouper dans le menu Outils :

Le groupe disparat et les objets quil contenait sont replacs dans la


base ou dans la librairie.
Note Si le groupe slectionn est vide, la commande de menu sintitule
Supprimer le groupe vide.

Manuel de rfrence de 4D Insider

59

Chapitre 4 Groupes

60

Manuel de rfrence de 4D Insider

Documentation

Afin de faciliter le dveloppement multi-programmeur, la plupart des


objets qui composent une structure ou une librairie peuvent tre
documents.
La documentation est sauvegarde dans la structure de la base. Cette
fonctionnalit est disponible aussi bien avec une base 4D monoposte
quavec une base publie par 4D Server.
Les diffrents types dobjets pouvant tre documents par 4D Insider
sont les suivants :

Tables,

Champs,

Formulaires,

Mthodes formulaire,

Triggers,

Groupes,

Barres de menus,

Menus,

Mthodes projet,

Mthodes objet,

Mthodes base,

Composants et dossiers de composants (hors composants installs),

Plug-ins.

Manuel de rfrence de 4D Insider

61

Chapitre 5 Documentation

Crer ou modifier la documentation dun objet

Pour crer ou modifier la documentation dun objet :

1 Slectionnez dans la liste Base lobjet pour lequel vous souhaitez crer
ou modifier la documentation.
Les objets documents apparaissent souligns dans les listes :
Objet document

2 Choisissez la commande Documenter lobjet dans le menu Outils :

La fentre de documentation apparat. Si aucune documentation na


t cre pour lobjet, la fentre est vide.

Zone de saisie

Note Loption Objet dlimiteur et les informations sont dtailles dans le


paragraphe Options de la fentre de documentation dobjet, page 63.

62

Manuel de rfrence de 4D Insider

Crer ou modifier la documentation dun objet

3 Saisissez le texte que vous souhaitez associer lobjet.


Vous pouvez saisir jusqu 32000 caractres par objet.
4 Si vous le souhaitez, vous pouvez enrichir la prsentation de votre
texte laide des commandes du menu Documentation.
Ce menu est plac droite de la barre de menus quand la fentre de
documentation est affiche. Il vous permet de modifier la police, la
taille, le style et la couleur de votre texte, tout comme dans un diteur
de texte standard.
5 Choisissez Fermer dans le menu Fichier.
OU BIEN
Sous Windows, double-cliquez sur la case du menu Systme ou cliquez
sur la case de fermeture (Windows 95) de la fentre.
Sous MacOS, cliquez sur la case de fermeture de la fentre.
La documentation ainsi cre ou modifie est automatiquement
sauvegarde lorsque vous refermez la fentre.

Options de la
fentre de
documentation
dobjet
Option Objet dlimiteur

La fentre de documentation dun objet comporte, dans sa partie


suprieure, loption Objet dlimiteur (grise par dfaut) et une ligne
dinformation.

Informations
Zone de saisie

Fentre de documentation
dobjet

Objet dlimiteur

Loption Objet dlimiteur permet de modifier le statut de lobjet


concern pour dterminer sil doit ou non stopper la propagation des
rfrences lors dun dplacement.
Cette option est traite dans le paragraphe Objets dlimiteurs,
page 120.

Date de la dernire
modification

La ligne dinformation indique la date laquelle lobjet a t modifi


pour la dernire fois dans le mode Structure de 4D. Par exemple, pour
une mthode, cette date sera celle de la dernire modification des
lignes de son code.

Manuel de rfrence de 4D Insider

63

Chapitre 5 Documentation

Cette date nest pas mise jour quand vous modifiez la documentation
dun objet, mais lorsque vous modifiez lobjet lui-mme.
Note Dans le cas o votre base a t convertie depuis une version prcdente
de 4D, la date de dernire modification des objets correspond la date
de conversion de votre structure (si les objets nont pas t modifis
entre-temps). Il en va de mme si la base a t transporte dune
version MacOS une version Windows, et inversement.

Crer ou modifier une documentation gnrale


Il est possible dcrire une documentation gnrale pour une base ou
une librairie.

Pour crer ou modifier une documentation gnrale :

1 Cliquez sur la fentre de la base ou de la librairie que vous souhaitez


documenter.
2 Slectionnez la commande Documentation gnrale dans le menu
Outils :

La fentre de documentation apparat.

64

Manuel de rfrence de 4D Insider

Supprimer une documentation

Si aucune documentation na t dfinie, la fentre est vide.

Zone de saisie

3 Saisissez le texte que vous souhaitez associer la base ou la librairie.


Vous pouvez saisir jusqu 32000 caractres.
4 Si vous le souhaitez, vous pouvez enrichir la prsentation de votre
texte laide des commandes du menu Documentation.
Ce menu, plac droite de la barre de menus quand la fentre de documentation est affiche, permet de modifier la police, la taille, le style et
la couleur du texte, comme dans un diteur de texte standard.
5 Choisissez Fermer dans le menu Fichier.
OU BIEN
Sous Windows, double-cliquez sur la case du menu Systme ou cliquez
sur la case de fermeture (Windows 95) de la fentre.
Sous MacOS, cliquez sur la case de fermeture de la fentre.
La documentation ainsi cre ou modifie est automatiquement sauvegarde lorsque vous refermez la fentre.

Supprimer une documentation

Pour supprimer la documentation dun ou plusieurs objet(s) :

1 Slectionnez le ou les objet(s) document(s).


Les objets documents apparaissent souligns dans vos listes.
Pour slectionner plusieurs objets simultanment, utilisez la
combinaison Maj+clic (slection continue) ou Ctrl+clic sous Windows
et Commande+clic sous MacOS (slection discontinue).
2 Choisissez Supprimer la documentation dans le menu Outils.
Une bote de dialogue vous demande de confirmer lopration.
3 Cliquez sur OK.
La documentation est supprime et loption Objet dlimiteur est
remise sa valeur par dfaut (fixe dans les Prfrences des Objets dlimiteurs, cf. paragraphe Objets dlimiteurs, page 120).

Manuel de rfrence de 4D Insider

65

Chapitre 5 Documentation

Pour supprimer une documentation gnrale :

1 Cliquez sur la fentre de la base ou de la librairie que vous souhaitez


documenter.
2 Slectionnez Documentation gnrale dans le menu Outils.
La fentre de documentation gnrale apparat.
3 Slectionnez la commande Tout slectionner dans le menu Edition.
4 Appuyez sur la touche Retour Arrire.
La documentation gnrale est supprime.

Imprimer la documentation
Vous pouvez imprimer et exporter sous forme de fichiers texte les
documentations que vous avez cres. Ce point est trait dans le
chapitre Impression et export, page 101.

Documentation multi-utilisateurs
Dans le cas o vous dveloppez une base sous 4D Server, les
documentations souvrent par dfaut en mode lecture seulement.
Cet tat vous est indiqu par licne de crayon barr en bas gauche de
la fentre.

Documentation en
lecture seulement

Vous ne pourrez modifier cette documentation quaprs avoir


demand laccs en criture, en cliquant sur licne du crayon.

Si la documentation de lobjet est dj en train dtre modifie par un


autre utilisateur, le mode criture sera indisponible. Elle sera accessible
ds que lutilisateur qui ldite aura referm la fentre de
documentation.
Note Bien entendu, la fentre documentation souvre par dfaut en mode
lecture criture lorsque vous crez la documentation dun objet.

66

Manuel de rfrence de 4D Insider

Filtres, recherches et
remplacements

Ce chapitre explique comment prdfinir des slections dobjets et


effectuer des recherches ponctuelles sur les objets de votre base ou de
votre librairie.
Vous verrez galement comment renommer vos variables, mthodes,
formulaires, messages daide, smaphores, ensembles, slections,
groupes, et les remplacer partout o ils sont utiliss.

Filtres et recherches
Ces deux fonctions effectuent le mme type daction : une recherche.
Leur diffrence rside dans leur mode dutilisation :

Un filtre est une recherche enregistre. Une fois quil a t cr, les critres de recherches sont conservs et peuvent tre appels tout
moment sans avoir tre redfinis.
Un filtre est utilis notamment quand vous effectuez frquemment la
mme recherche.
Un filtre sapplique la slection affiche dans une liste

Une recherche rpond quant elle des besoins ponctuels. Ses critres
sont dfinis chaque appel et ne sont pas enregistrs.
Une recherche sapplique la totalit de la base et la slection rsultante est affiche dans la liste Base.

Manuel de rfrence de 4D Insider

67

Chapitre 6 Filtres, recherches et remplacements

Appliquer un filtre

En haut droite de chaque liste se trouve un menu droulant


permettant de slectionner un filtre daffichage pour la liste.

Ce menu contient par dfaut une srie de filtres simples qui vous
permettent de restreindre la liste des objets affichs un type
particulier.

Pour appliquer un filtre aux objets de la base, il suffit de slectionner


son nom dans le menu.

Note Les filtres ne correspondent pas exactement aux types dobjets


reconnus par 4D Insider : par exemple, le filtre Menus retiendra la
fois les objets de type Commande de menu et Barre de menu. Le filtre
Tables retiendra les Tables, les Champs et les Sous-tables.
Appliquer un filtre une Vous pouvez appliquer un ou plusieurs filtres une sous-slection
sous-slection dobjets
uniquement, afin deffectuer votre recherche parmi cette sousslection.
Par exemple, imaginons que vous ayez dfini une sous-slection
dobjets dans la liste Base (en faisant glisser le contenu de la liste Cible
vers la liste Base). Vous souhaitez ensuite afficher uniquement les
variables comprises dans cette sous-slection.
Si vous slectionnez directement le filtre Variables, toutes les variables
de la base seront affiches. Vous perdez ainsi votre premire slection.
Vous devez donc appliquer un filtre la sous-slection.

68

Manuel de rfrence de 4D Insider

Filtres et recherches

Pour appliquer un filtre une sous-slection dobjets :

1 Maintenez la touche Alt (sous Windows) ou Option (sous MacOS)


enfonce pendant que vous slectionnez un filtre.
Appliquer un anti-filtre

4D Insider propose la notion danti-filtre. Un anti-filtre permet,


linverse dun filtre, dter un type dobjet de la liste des objets affichs.

Pour appliquer un anti-filtre une liste dobjets de 4D Insider :

1 Maintenez les touches Alt+Maj (sous Windows) ou Option+Maj (sous


MacOS) enfonces pendant que vous slectionnez un filtre.

Modifier le contenu Vous pouvez modifier le contenu des pop up menus de filtres, cest-des pop up menus
dire dterminer les filtres qui doivent apparatre dans les pop up menus
de filtres
et ceux qui doivent en tre exclus.
Note Vous pouvez galement ajouter vos propres filtres ou modifier le
fonctionnement dun filtre existant. Pour plus dinformations,
reportez-vous au paragraphe Crer/Modifier un filtre personnalis,
page 71 et au paragraphe Construire une recherche ou un filtre,
page 73.

Pour dfinir les filtres apparaissant dans les menus :

1 Slectionnez la commande Fichier>Prfrences, puis le sous-menu


Filtres...

Manuel de rfrence de 4D Insider

69

Chapitre 6 Filtres, recherches et remplacements

La fentre Edition de filtres saffiche.


Cases de
slection globale :
Liste source
Liste base
Liste cible

Boutons de gestion
des filtres

Zone de saisie/ddition
du nom dun filtre

Cette fentre est disponible mme si aucune base nest ouverte.


Tous les filtres standard de 4D Insider sont prsents. Chaque ligne
contient le nom du filtre et trois coches. Les coches correspondent aux
trois listes, et vous permettent de spcifier dans quel menu le filtre doit
apparatre.
Vous pouvez ainsi dfinir un menu diffrent pour chacune des trois
listes.
2 Cochez ou dslectionnez les filtres en fonction de vos besoins.

Pour slectionner ou dslectionner un filtre dans un menu, cliquez


alternativement sur la coche ou dans lespace vide correspondant au
nom du filtre pour le menu.

Pour slectionner toutes les coches dune colonne, cliquez dans son
titre.

Pour dslectionner toutes les coches dune colonne, cliquez dans


son titre en maintenant la touche Alt (Windows) ou Option
(MacOS) enfonce.

3 Une fois que vous avez effectu vos paramtrages, cliquez sur le
bouton OK.

70

Manuel de rfrence de 4D Insider

Filtres et recherches

Crer/Modifier un
filtre personnalis

Vous pouvez crer vos propres filtres et dfinir leur action ou modifier
un filtre existant.

Pour crer un filtre :

1 Slectionnez la commande Fichier>Prfrences, puis le sous-menu


Filtres...
2 Dans la bote de dialogue Edition de filtres, saisissez le nom du
nouveau filtre dans la zone ddition Nom du filtre.
3 Cliquez sur le bouton Crer...
La bote de dialogue de dfinition dun filtre apparat.
4 Dfinissez vos paramtrages et cliquez sur OK.
Pour plus dinformations sur la construction dun filtre, reportez-vous
au paragraphe Construire une recherche ou un filtre, page 73.
Le nouveau filtre apparat dans la bote de dialogue Edition des filtres.

Pour modifier un filtre existant :

1 Dans la bote de dialogue Edition de filtres, double-cliquez sur le nom


du filtre diter.
OU BIEN :
Slectionnez le filtre diter et cliquez sur le bouton Modifier...
La bote de dialogue de dfinition dun filtre apparat. Elle comporte les
paramtrages du filtre slectionn. Procdez ensuite de la mme
manire que pour la cration dun nouveau filtre.
2 Dfinissez vos paramtrages et cliquez sur OK.
Pour plus dinformations sur la construction dun filtre, reportez-vous
au paragraphe Construire une recherche ou un filtre, page 73.
Le nouveau filtre apparat dans la bote de dialogue Edition des filtres.
Note 4D Insider sauvegarde automatiquement vos dfinitions de filtres :
sous MacOS, dans le fichier de Prfrences du programme, plac dans
le dossier Prfrences:4D du dossier Systme.
sous Windows, dans le fichiers de Prfrences du programme, plac
dans le dossier C:\Windows\4D, o C:\Windows reprsente le rpertoire
systme actif.
Ainsi, vos paramtres seront conservs mme si vous mettez jour
votre version de 4D Insider.

Manuel de rfrence de 4D Insider

71

Chapitre 6 Filtres, recherches et remplacements

Renommer un filtre

Vous pouvez modifier le nom dun filtre en le slectionnant dans la


fentre ddition de filtres, puis en tapant son nouveau nom dans la
zone ddition Nom du filtre.
Une fois le nouveau nom choisi, cliquez sur Renommer pour valider le
changement.

Supprimer un filtre

Pour supprimer un filtre, slectionnez son nom dans la liste puis


cliquez sur le bouton Supprimer.

Excuter une
recherche

Pour accder la fonction de recherche de 4D Insider :

1 Choisissez Chercher... dans le menu Outils.

La bote de dialogue de recherche apparat.


2 Dfinissez votre recherche puis cliquez sur le bouton Chercher.
Pour plus dinformations sur la construction dune recherche, reportezvous au paragraphe Construire une recherche ou un filtre, page 73.
La liste Base de 4D Insider contient alors les objets correspondants aux
critres dfinis.

72

Manuel de rfrence de 4D Insider

Filtres et recherches

Construire une
recherche ou un
filtre

Vous dfinissez une formule de recherche ou un filtre dans la bote de


dialogue Recherche de 4D Insider.

Caractristique sur laquelle


porte la recherche

Chane de
caractres
rechercher

Mode de recherche
Types dobjets sur lesquels
la recherche doit porter

Porte de la
recherche
Options
supplmentaires
de recherche

Note Cette bote de dialogue est identique pour la dfinition de filtres et la


recherche. Toutefois, pour les recherches, le menu supplmentaire
Dans la base ou Dans la slection permet de dfinir la porte de la
recherche.

Pour construire une formule de recherche ou un filtre :

1 Slectionnez un ou plusieurs types dobjets, en fonction des objets sur


lesquels vous souhaitez que porte la recherche.
Pour cela, il suffit de cliquer sur le type souhait. Une coche apparat
alors en regard de lobjet choisi.
Par dfaut, tous les objets sont slectionns.

Pour slectionner ou dslectionner un type dobjet, cliquez alternativement sur la coche ou dans lespace vide correspondant au type
dobjet.

Pour dslectionner tous les objets de la liste, cliquez dans la barre


de titre Objet de type : en maintenant la touche Alt (sous Windows) ou Option (sous MacOS) enfonce.

Pour slectionner tous les objets de la liste, cliquez dans la barre de


titre.

2 Slectionnez la caractristique de lobjet sur laquelle doit porter la


recherche : nom, date, ou nombre doccurrences.
3 Choisissez votre mode de recherche.

Manuel de rfrence de 4D Insider

73

Chapitre 6 Filtres, recherches et remplacements

Une fois que vous avez slectionn une caractristique rechercher, les
modes de recherche correspondants vous sont proposs :

modes de recherche par nom :

modes de recherche par date :

modes de recherche par nombre doccurrences :

4 Saisissez la chane de caractres rechercher dans la zone ddition.


Tout comme dans 4D, le caractre @ joue le rle de joker et peut tre
plac dans la chane.
Si la zone ddition est vide, tous les objets correspondant aux critres
de recherche dfinis vous seront retourns.
5 Prcisez, dans le dernier menu droulant, si votre recherche doit
porter sur lintgralit de la base ou de la librairie, ou uniquement sur
les objets affichs dans la liste principale.
Note Cette option nest pas disponible dans la fentre de recherche utilise
dans le cadre de la dfinition dun filtre. Il est cependant possible
dappliquer un filtre sur une slection. Pour cela, reportez-vous au
paragraphe Appliquer un filtre une sous-slection dobjets, page 68.
Rechercher dans le
contenu

Loption Rechercher dans le contenu vous permet de spcifier que la


recherche portera sur le contenu de lobjet. Si vous la cochez,
4D Insider parcourra lintgralit des mthodes, formulaires (noms des
objets et textes statiques), STR#, listes, menus, etc., la recherche de la
chane de caractres.
Il est important de noter quune recherche de ce type peut tre longue
sur des bases importantes.
Note Cette option na dintrt que si vous effectuez une recherche par nom.

74

Manuel de rfrence de 4D Insider

Filtres et recherches

Si vous ne cochez pas cette option, la recherche se limitera au nom des


objets dans la base, suivant le mode choisi.
Documents, Inutiliss,
Dlimiteurs

Les cases cocher Documents, Inutiliss et Dlimiteurs peuvent


prendre trois tats.

Si la case est grise, il ne sera pas tenu compte de lattribut dans la


recherche.

Si la case est coche, la recherche ne prendra en compte que les objets


entrant dans cette catgorie.

Si la case est dslectionne, la recherche exclura les objets entrant


dans cette catgorie.
Loption Documents permet de slectionner ou dexclure les objets
auxquels une documentation a t associe. Les objets documents
apparaissent en soulign dans les trois listes de 4D Insider.

Note Pour plus dinformations sur la documentation des objets, reportezvous au chapitre Documentation, page 61.
Loption Inutiliss permet de slectionner ou dexclure les objets qui ne
sont rfrencs par aucun autre dans la base. Ces objets apparaissent
dans les listes en rouge sur cran couleur et en gras sur cran noir et
blanc.
Loption Dlimiteurs permet de slectionner ou dexclure les objets qui
ont t dfinis comme dlimiteurs.
Note Pour plus dinformation sur les dlimiteurs, reportez-vous au chapitre
Dplacement dobjets, page 109.

Exemples de
recherches

Les exemples suivants ont pour but dillustrer le fonctionnement


gnral des recherches et des filtres dans 4D Insider ainsi que de
prsenter la diversit des solutions que vous propose 4D Insider lorsque
vous souhaitez rechercher une information dans une base ou une
librairie.

Exemple 1

Recherche de tous les endroits dune base (dans notre exemple,


DEMOBLOB) o la variable vDoc reoit une affectation :
1 Dans le menu droulant des filtres de la liste Base, slectionnez
Variables.

Manuel de rfrence de 4D Insider

75

Chapitre 6 Filtres, recherches et remplacements

2 Double-cliquez sur la variable vDoc.


Sa dfinition et la liste des objets sources saffichent :

3 Faites glisser la liste des sources sur la liste Base.


La slection est maintenant rduite aux objets rfrenant la variable
vDoc, acclrant ainsi la recherche suivante.
4 Choisissez Chercher... dans le menu Outils.
5 Construisez votre recherche selon les critres suivants :

6 Cliquez sur Chercher ou appuyez sur la touche Entre.


Le rsultat de la recherche saffiche dans la liste principale, qui prend
alors le nom de [Recherche]. Vous pouvez double-cliquer sur une
mthode et constater quelle contient vDoc:=.

76

Manuel de rfrence de 4D Insider

Filtres et recherches

Exemple 2

Recherche de toutes les mthodes projet (dans notre exemple,


V6OBJECT) dont le nom dbute par Init et qui utilisent la chane de
caractres France
1 Slectionnez Chercher... dans le menu Outils et dfinissez la recherche
suivante :

2 Cliquez sur Chercher ou appuyez sur la touche Entre.


Vous tes de retour dans la fentre de 4D Insider :

3 Slectionnez nouveau Chercher... dans le menu Outils.

Manuel de rfrence de 4D Insider

77

Chapitre 6 Filtres, recherches et remplacements

4 Dfinissez la recherche suivante :

5 Cliquez sur le bouton Chercher ou appuyez sur la touche Entre.


La liste principale sappelle prsent [Recherche] et contient tous les
objets correspondant votre recherche.
Si vous devez rpter les mmes recherches frquemment, il est plus
pratique de dfinir des filtres. Pour plus dinformations sur les filtres,
reportez-vous au paragraphe Appliquer un filtre, page 68.

Remplacer
4D Insider vous permet deffectuer diffrents types de remplacements :

Renommer : permet de renommer un objet slectionn.

Remplacer dans slection : permet de remplacer une chane de caractres dans les noms des objets slectionns.

Remplacer dans le contenu : permet de remplacer une chane de caractres dans le contenu des objets slectionns.

Remplacer les commandes : permet de remplacer lutilisation dune


commande 4D par une mthode projet (cre automatiquement par
4D Insider ou dj existante) dans la slection des mthodes affiches.

Note Toutes ces actions sappliquent uniquement la liste Base.

78

Manuel de rfrence de 4D Insider

Remplacer

Renommer un objet Cette commande est active uniquement lorsque vous slectionnez un
seul objet dans la liste principale et que le type de cet objet appartient
ceux numrs ci-dessous.
Objets physiques et
objets dclars

Les types dobjets peuvent tre classs dans deux catgories :

Objets physiques : regroupe les objets qui ont une rfrence unique, leur rfrence est physique : Tables, Mthodes projets, Messages daide, Formulaires, Images, Feuilles de style, Styles,
Enumrations, Groupes et Composants (hors composants installs).

Objets dclars : regroupe les objets qui nont pas dexistence


physique, ils nexistent que lors de lexcution du code 4D : variables, smaphores, ensembles et Slections temporaires.

Note Pour plus dinformations sur cette distinction, reportez-vous au


chapitre Dplacement dobjets, page 109.
Renommer un objet
dclar

Pour renommer un objet dclar :

1 Slectionnez dans la liste principale lobjet que vous dsirez


renommer.
Par exemple, nous voulons renommer la variable vStyle dans la base
Recettes.
2 Slectionnez Renommer... dans le menu Outils.

Manuel de rfrence de 4D Insider

79

Chapitre 6 Filtres, recherches et remplacements

La bote de dialogue Renommer saffiche :

Zone de saisie du
nouveau nom
Zone de slection des
objets dans lesquels effectuer le remplacement
Option de remplacement
global

La zone ddition vous permet de spcifier le nouveau nom de la


variable.
La liste qui apparat sous cette zone reprend tous les lments qui
utilisent cette variable : cest en fait la liste des sources.

Vous pouvez demander ce que le nom de la variable soit modifi dans


toute la liste des sources : cochez la case Partout.

Si vous souhaitez ne faire apparatre le nouveau nom que dans certains


objets sources, il vous est possible de les slectionner en cliquant dessus.

Pour les slectionner en continu, maintenez la touche Majuscule


enfonce ;

Pour les slectionner dune faon discontinue, maintenez la touche


Ctrl (sous Windows) ou Commande (sous MacOS) enfonce.

3 Saisissez le nouveau nom de la variable et slectionnez les objets


source dans lesquels vous souhaitez quelle soit remplace.
Le bouton OK sactive.
4 Cliquez sur le bouton OK.
La bote de dialogue est valide et le remplacement a lieu automatiquement dans tous les objets sources que vous avez slectionns.
Le bouton Annuler referme la bote de dialogue sans effectuer de remplacement.

80

Manuel de rfrence de 4D Insider

Remplacer

Renommer un objet
physique

Pour renommer un objet physique :

1 Slectionnez dans la liste Base lobjet physique que vous dsirez


renommer.
2 Slectionnez Renommer... dans le menu Outils.
La bote de dialogue Remplacement apparat :

Vous constatez que la liste des objets sources napparat pas.


Le nom de lobjet sera modifi dans tous ses objets source.
3 Saisissez un nouveau nom pour la mthode.
Le bouton OK sactive.
4 Cliquez sur le bouton OK.
Le bouton Annuler referme la bote de dialogue sans effectuer de remplacement.

Remplacer dans une 4D Insider vous permet de remplacer une chane de caractres dans
slection
une slection dobjets. La slection peut contenir tout type dobjet, le
remplacement ne sera effectu que dans le nom des objets pour
lesquels il est autoris (reportez-vous au paragraphe Objets physiques
et objets dclars, page 79 et au chapitre Dplacement dobjets,
page 109).
Pour remplacer une chane par une autre, vous devez dabord
slectionner les objets que vous voulez remplacer.
Cette fonction vous permet galement de renommer automatiquement
une slection de variables partout dans la base, en une seule fois.

Manuel de rfrence de 4D Insider

81

Chapitre 6 Filtres, recherches et remplacements

Exemple de
remplacement

Nous souhaitons remplacer le mot Sauvegarde par Svgde dans le


nom de tous les objets dune base.
1 Dans un premier temps, effectuez une recherche partir des critres
suivants :

2 Cliquez sur le bouton Chercher.


La liste Base contient alors tous les objets correspondant aux critres
dfinis.
3 Choisissez la commande Tout slectionner dans le menu Edition.
Lensemble des objets de la liste principale est slectionn.
4 Choisissez la commande Remplacer dans la slection... du menu Outils.

La bote de dialogue de remplacement apparat.

82

Manuel de rfrence de 4D Insider

Remplacer

5 Saisissez vos valeurs.

Zone de saisie de la chane


de caractres remplacer
Zone de saisie de la nouvelle
chane de caractres

Lorsque vous validez la bote de dialogue, la modification est effectue


pour chacun des objets de la slection courante comportant cette
chane. Bien entendu, toutes les rfrences ces objets sont galement
remplaces.
Notez que dans le cas o vous effectuez des remplacements sur des
objets dont la rfrence, cest--dire le nom, est spcifie dans 4D entre
"" (cest le cas des formulaires, smaphores, slections, ensembles et
parfois des mthodes), seules les rfrences explicites ces objets sont
remplaces. Les rfrences calcules ne seront pas remplaces.
Par exemple, si le nom dun smaphore est dfini de la manire
suivante :
MonSmaphore:=Semaphore("Etat"+Chaine(Numero du process
courant))
il ne pourra pas tre remplac.

Manuel de rfrence de 4D Insider

83

Chapitre 6 Filtres, recherches et remplacements

Remplacer dans le
contenu

Cette commande vous permet de remplacer des chanes de caractres


contenues dans les formulaires et messages daide slectionns dans la
zone Base.

Ainsi, vous pouvez modifier tous les textes statiques dun formulaire
(cest--dire crs laide de loutil Texte de lditeur de formulaires
de 4D) ainsi que tous les libells de boutons.

Remplacer les
commandes

Cette commande sapplique aux mthodes slectionnes dans la zone


Base. Elle permet de remplacer toutes les instances dune commande
4D utilise dans les mthodes de la liste Base par une mthode
existante ou par une mthode vierge, que vous crez dans 4D Insider.
Par exemple, nous souhaitons remplacer la commande 4D CONFIRMER
par la mthode projet MonConfirmer.
CONFIRMER ("Voulez vous rellement supprimer ?")
doit devenir :
MonConfirmer("Voulez vous rellement supprimer ?")
Voici la mthode projet MonConfirmer :
`Mthode projet MonConfirmer
`$1 = Texte afficher
C_TEXTE($1)
Creer fenetre ...
DIALOGUE...
FERMER FENETRE

84

Manuel de rfrence de 4D Insider

Remplacer

Pour remplacer la commande 4D par cette mthode :

1 Dans la fentre principale de 4D Insider, slectionnez les mthodes


dans lesquelles la commande CONFIRMER doit tre remplace.
2 Slectionnez Remplacer la commande... dans le menu Outils de
4D Insider.
La bote de dialogue Remplacement des commandes 4D saffiche.

La zone de dfilement Remplacer la commande affiche la liste de


toutes les commandes 4D employes dans la base.

La zone de dfilement Par la mthode contient la liste de toutes


les mthodes projet cres dans la base.

3 Slectionnez dans la premire zone le nom de la commande 4D


remplacer.
Pour acclrer la recherche parmi les commandes 4D, tapez au clavier
les premire lettres du nom rechercher.
La commande slectionne saffiche dans la zone ddition.
4 Slectionnez dans la seconde zone le nom de la mthode projet de
remplacement.
Pour acclrer la recherche parmi les mthodes 4D, tapez au clavier les
premire lettres du nom rechercher.
La mthode projet slectionne saffiche dans la zone ddition.
5 Cliquez sur le bouton Remplacer.
Le remplacement est effectu dans toutes les mthodes de la liste Base.

Manuel de rfrence de 4D Insider

85

Chapitre 6 Filtres, recherches et remplacements

Remplacer par une


mthode vierge

Vous pouvez remplacer une commande 4D par une mthode que vous
crez directement dans 4D Insider.
Pour cela, il vous suffit de saisir, dans la zone ddition situe sous la
liste Par la mthode, le nom de la nouvelle mthode que vous
souhaitez crer. Le bouton Crer et remplacer sactive alors (si aucune
mthode projet de la base ne porte ce nom).
Lorsque vous cliquez sur ce bouton, 4D Insider cre une nouvelle
mthode vierge (comportant uniquement une ligne de commentaire)
et effectue le remplacement dans toutes les mthodes de la liste Base.

Prfixer une
slection dobjets

Si vous dsirez que les noms de plusieurs objets soient prfixs par une
chane de caractres particuliers, 4D Insider vous permet de le faire en
une seule opration. Cette possibilit savre trs utile lorsque vous
souhaitez amliorer la lisibilit de votre liste de mthodes ou avoir un
moyen rapide de reprer les familles dobjets de votre base.
Par exemple, vous pourrez ainsi prfixer vos objets en fonction de leur
rle au sein de la base, ou de leur auteur. Par la suite, vous pourrez crer
des filtres utilisant ces prfixes.
Cette fonction vous permet galement de prfixer automatiquement
une slection de variables partout dans la base, en une seule fois. Cette
fonction est utile, par exemple, pour transformer rapidement un groupe
de variables process en variables interprocess dans toute la base.
Imaginez que vous souhaitiez prfixer tous les objets de la base
RECETTES utiliss pour dfinir les recettes.
1 Slectionnez dans la liste principale le ou les objet(s) prfixer.

Note Les mthodes de slection de 4D Insider sont dcrites dans le


paragraphe Manipuler les listes de la fentre de navigation, page 44.

86

Manuel de rfrence de 4D Insider

Remplacer

Pour notre exemple, nous avons slectionn tous les objets contenant
la chane de caractres Recettes :

2 Choisissez la commande Ajouter un prfixe... dans le menu Outils.

La bote de dialogue dinsertion de prfixes apparat.


3 Saisissez le prfixe que vous souhaitez appliquer aux objets.
Pour notre exemple, tapez Fr_.

Tous les objets de la slection commenceront par ces trois caractres.


Bien entendu, les rfrences ces objets seront galement mises jour.
4 Cliquez sur OK pour valider.

Manuel de rfrence de 4D Insider

87

Chapitre 6 Filtres, recherches et remplacements

Il se peut que lajout dun prfixe rende le nom dun objet trop long.
Dans ce cas, un message dalerte vous en informe, vous laissant la possibilit dannuler :

Si vous confirmez votre action, le prfixage seffectue.


Dans le cadre de notre exemple, voici le rsultat obtenu :

Notez que dans le cas o vous effectuez des prfixages sur des objets
dont la rfrence, cest--dire le nom, est spcifie dans 4D entre ""
(cest le cas des formulaires, smaphores, slections, ensembles et
parfois des mthodes), seules les rfrences explicites ces objets sont
remplaces. Les rfrences calcules ne sont pas remplaces.
Par exemple, si le nom dun ensemble est dfini de la manire
suivante :
CREER ENSEMBLE VIDE(Inter+Chaine($i))
il ne pourra pas tre remplac.

88

Manuel de rfrence de 4D Insider

Aide la traduction

Si vous souhaitez traduire votre base de donnes 4D en une ou


plusieurs langues, votre travail peut tre grandement facilit grce
4e Dimension. En effet, traduire une application peut se rvler
fastidieux, car il faut traduire un par un tous les formulaires et modifier
tous les libells, boutons, intituls des menus, commandes de menus
Afin de vous viter ce travail, 4e Dimension vous permet de regrouper
tous les libells que vous utilisez dans une ou plusieurs ressources de
type STR#. Les libells tant alors dfinis par une rfrence, il devient
trs facile de les traduire. Car, une fois que vos libells sont en
ressources, vous les appelez en crivant les libells, dans vos
formulaires, sous la forme :n de ressource, n de ligne.
Voici les objets pouvant tre libells par lintermdiaire de ressources :
Menus et commandes de menus,
Boutons,
Objets texte dans les formulaires, tels que les libells des champs.
4D Insider facilite la localisation de vos bases, en mettant votre
disposition des outils permettant de crer et de manipuler les
ressources STR# :

Vous pouvez gnrer directement des ressources STR# partir des libells (textes statiques) placs dans vos menus et formulaires. Cette fonctionnalit est dcrite dans le paragraphe Texte vers STR#, page 94.

A linverse, vous pouvez gnrer des textes statiques partir de STR#


existantes. Cette fonctionnalit est dcrite dans le paragraphe STR#
vers Texte, page 96.

Enfin, 4D Insider vous permet de modifier le contenu des ressources


STR# existantes, tout en visualisant instantanment vos menus et vos
formulaires. Cette fonctionnalit est prsente dans le paragraphe
Editer les STR#, page 98.
Manuel de rfrence de 4D Insider

89

Chapitre 7 Aide la traduction

Utiliser des ressources STR# dans 4D


Quest-ce quune
ressource STR# ?

Les STR# (String, cest--dire chanes de caractres) sont des ressources.


Le concept de ressources est issu du monde Macintosh et dsigne des
lments structurels et constants dun programme ou dun fichier,
auxquels rfrence peut tre faite tout moment. Ce fonctionnement a
pour avantages dallger le programme (une seule ressource peut tre
rutilise de nombreux endroits) et de permettre de traduire
directement un logiciel ou un fichier, sans avoir le recompiler.
Les versions MacOS et Windows de 4e Dimension exploitent ce
principe, de manire totalement transparente. Il en va de mme pour
4D Insider, quelle que soit la plate-forme sur laquelle vous travaillez.
Sous MacOS, les ressources de vos bases sont stockes directement dans
le fichier de structure 4D.
Sous Windows, un fichier supplmentaire, MaBase.RSR, a pour rle
de recueillir et dexploiter les ressources de votre base. Cependant,
comme sous MacOS, vous accdez ces ressources directement depuis
le fichier de structure de votre base (MaBase.4DB).
Note Pour plus dinformations sur le format interne des fichiers MacOS et
lexploitation des ressources par la version Windows de 4e Dimension
reportez-vous la documentation de 4D Transporter (utilitaire fourni
avec 4e Dimension et 4D Server).

Traduire les menus


et les commandes
de menus

Les menus et les commandes de menus peuvent utiliser des ressources,


ce qui vous permet de traduire entirement les menus crs de votre
application.
Lorsque vous crez une nouvelle barre de menus dans lditeur de
barres de menus de 4D, un menu Fichier est automatiquement plac
dans la zone Barre de menu courante.

90

Manuel de rfrence de 4D Insider

Utiliser des ressources STR# dans 4D

Lintitul Fichier est inscrit en italique, ce qui indique que ce libell


est obtenu partir dune ressource STR#.

Si vous utilisez la combinaison Ctrl+clic (Windows) ou Commande+clic


(MacOS) sur un libell de menu ou de commande de menu en italique
dans lditeur de barres de menus, 4e Dimension affiche le numro
dID et lindice de la ressource utilise par le libell. Lcran ci-dessous
illustre ce qui se produit lorsque vous cliquez ainsi sur le menu Fichier.

La rfrence :79,1 indique que le nom du menu est obtenu depuis la


ressource 79, indice 1 (premier lment). Si vous utilisiez une version
allemande de 4D, le menu Fichier serait automatiquement libell
Ablage.

Manuel de rfrence de 4D Insider

91

Chapitre 7 Aide la traduction

Pour assigner une ressource STR# un menu ou une commande de


menu :

1 Cliquez sur un libell de menu ou de commande de menu existant


dans lditeur de menus, ou crez-en un(e).
Le libell est alors slectionn.
2 Remplacez tout texte existant par le numro et lindice de la ressource
STR# que vous souhaitez assigner.
Veillez respecter la syntaxe :Numro,Indice. Noubliez pas les deuxpoints ni la virgule sparant le numro de lindice.

Traduire les boutons Le texte des boutons peut utiliser des ressources, ce qui vous permet de
traduire les boutons de vos formulaires dans toute votre application.

Pour assigner une ressource STR# un titre de bouton :

1 Double-cliquez sur le bouton dans lditeur de formulaires de 4D.


La Liste des proprits ou la palette Proprits dobjets apparat.
2 Saisissez le numro et lindice de la ressource STR# que vous souhaitez
assigner dans la zone Titre du bouton :.
Veillez respecter la syntaxe :Numro,Indice. Noubliez pas les deux
points ni la virgule sparant le numro de lindice.

Numro et indice
de la ressource

3 Refermez la palette ou appuyez sur la touche Tabulation afin de


valider votre modification.
Notez que le numro dID de la ressource et lindice sont affichs
comme titre du bouton dans lditeur de formulaires. Le titre du bouton sera remplac par le contenu de la STR# dans les modes Utilisation
et Menus crs.

92

Manuel de rfrence de 4D Insider

Utiliser des ressources STR# dans 4D

Note Vous pouvez galement tester le rsultat dans lditeur de formulaires


laide des commandes Afficher le format et Afficher la ressource du
menu Objets. Pour plus dinformations, reportez-vous au manuel Mode
Structure de 4e Dimension.

Bouton affichant le
numro de ressource et
lindice

Traduire les zones


de texte

Tout objet texte statique peut utiliser une ressource STR#. Cela vous
permet de traduire les libells des champs, les titres des formulaires, et
toutes les informations que vous pouvez placer dans vos formulaires.

Pour assigner une ressource STR# un texte statique dans un


formulaire :

1 Slectionnez le texte dans lditeur de formulaires.


Dans la fentre suivante, le titre du formulaire est slectionn.

2 Saisissez le numro et lindice de la ressource STR# que vous souhaitez


assigner.

Manuel de rfrence de 4D Insider

93

Chapitre 7 Aide la traduction

Veillez respecter la syntaxe :Numro,Indice. Noubliez pas les deux


points ni la virgule sparant le numro de lindice.
Notez que le numro dID de la ressource et lindice sont affichs dans
la zone de texte. La zone de texte sera remplace par le contenu de la
STR# dans les modes Utilisation et Menus crs.
Note Vous pouvez galement tester le rsultat dans lditeur de formulaires
laide des commandes Afficher le format et Afficher la ressource du
menu Objets. Pour plus dinformations, reportez-vous au manuel Mode
Structure de 4e Dimension.

Titre affichant le numro


de ressource et lindice

Utiliser des ressources STR# dans 4D Insider


Texte vers STR#

Cette fonction vous permet de transfrer rapidement le texte de vos


formulaires et de vos menus vers des STR#. Elle ne sapplique quau
contenu de la liste Base.
Si vous combinez cette commande avec les filtres et la recherche, vous
pourrez alors raliser des groupements logiques de STR# par
fonctionnalits de vos objets. Avec de tels regroupements, vous pourrez
rutiliser facilement vos projets dans toute autre base.
Cette fonction reconnat automatiquement deux textes identiques.
Vous naurez donc pas dans la mme STR# deux fois le mme texte.
Note Chaque ressource STR# peut contenir jusqu 256 chanes de
caractres. Si les objets que vous avez slectionns en ncessitent
davantage, 4D Insider crera automatiquement des STR#
supplmentaires pour les accueillir (mme nom, numro dID
incrment).

94

Manuel de rfrence de 4D Insider

Utiliser des ressources STR# dans 4D Insider

Transfrer du texte dans


une nouvelle ressource
STR#

Pour transfrer du texte vers une nouvelle ressource STR# :

1 Rduisez la liste Base aux objets dont vous souhaitez que les intituls
soient convertis en ressources STR#.
Pour cela, vous pouvez crer manuellement une sous-slection, appliquer un filtre ou encore effectuer une recherche.
2 Choisissez la commande Texte vers STR# dans le menu Outils.

La bote de dialogue Texte vers ressource STR# saffiche :

Zone de visualisation des


STR# existantes (vide si
aucune ressource nest
prsente dans la base)

Zone de saisie du
nom de la STR#
Zone de saisie
du numro de
la STR#

Manuel de rfrence de 4D Insider

95

Chapitre 7 Aide la traduction

3 Saisissez un nom et un numro pour la ressource que vous devez crer.


Le numro doit tre compris entre 15000 et 32000.
Note Lorsque vous crez vos propres ressources STR#, vous devez leur
assigner un numro dID suprieur ou gal 15000, afin dviter tout
conflit avec les ressources de 4e Dimension.
4 Cliquez sur le bouton Crer.
La ressource est cre. Elle apparat dans la zone de visualisation.
5 Cliquez sur le bouton OK.
Les libells de votre slection sont transfrs.
Transfrer du texte dans Lorsquune ou plusieurs ressources STR# ont dj t dfinies, vous
une ressource STR#
pouvez transfrer du texte dans une ressource existante. 4D Insider
existante
placera les libells de votre slection la suite des prcdents.

Pour transfrer du texte vers une ressource STR# existante :

1 Rduisez la liste Base aux objets dont vous souhaitez que les intituls
soient convertis en ressources STR#.
Pour cela, vous pouvez crer manuellement une sous-slection, appliquer un filtre ou encore effectuer une recherche.
2 Choisissez la commande Texte vers STR# dans le menu Outils.
La bote de dialogue Texte vers ressource STR# saffiche.
3 Dans la zone de visualisation des STR#, cliquez sur la ressource
utiliser.
4 Cliquez sur le bouton OK.
Les libells de votre slection sont transfrs dans la ressource, la suite
des STR# existantes.

STR# vers Texte

Afin de faciliter la localisation de votre base de donnes dans dautres


langues, 4D Insider vous permet de rimporter des chanes de caractres dans vos formulaires et vos menus comportant des STR#.

Pour transfrer le contenu dune ressource STR# dans vos formulaires et


menus :

1 Rduisez la liste Base aux objets dont vous souhaitez que les libells
sous forme de STR# soient convertis en texte.
Pour cela, vous pouvez crer manuellement une sous-slection, appliquer un filtre ou encore effectuer une recherche.

96

Manuel de rfrence de 4D Insider

Utiliser des ressources STR# dans 4D Insider

Par exemple, voici un formulaire dont les libells sont sous forme de
STR#.

2 Choisissez la commande STR# vers Texte dans le menu Outils.

Manuel de rfrence de 4D Insider

97

Chapitre 7 Aide la traduction

Le contenu des STR# de votre slection est transfr dans les zones de
texte de vos formulaires et dans vos menus. Vous pouvez visualiser
immdiatement les modifications.

Editer les STR#

Comme dcrit dans le chapitre Navigation parmi les objets, page 29,
4D Insider vous permet dditer le contenu des ressources STR# de
votre base de donnes. Vous pouvez non seulement visualiser ces
ressources, mais galement les modifier.

Pour utiliser lditeur de STR# :

1 Slectionnez une ressource de type STR# dans la liste Base.


2 Choisissez la commande Modifier la STR#... dans le menu Outils.
Vous obtenez alors la fentre de lditeur de ressources de type STR# de
4D Insider.

98

Manuel de rfrence de 4D Insider

Utiliser des ressources STR# dans 4D Insider

Le numro didentification (ID) de la liste des chanes de caractres est


inscrit dans le titre de la fentre.
Numro dID de la
ressource STR#

Numros dindice de
la ressource

3 Traduisez ou modifiez votre convenance les chanes de caractres.


Vos modifications seront enregistres lorsque vous refermerez la fentre.
Menu STR#

Le menu STR# est ajout droite de la barre de menus courante au


moment de lapparition de la bote de dialogue.

La commande Ajouter une chane vous permet dajouter une nouvelle


chane la suite des autres.

La commande Insrer une chane vous permet dintroduire une nouvelle chane de caractres juste avant celle o se trouve le point dinsertion.

La commande Supprimer la chane vous permet de dtruire la chane


de caractres dans laquelle se trouve le point dinsertion.
Linsertion et la suppression de chanes de caractres doivent tre ralises avec prcaution. En effet, les rfrences utilises dans vos formulaires et dans vos menus pourraient se trouver dcales.
Lorsque vous fermez la bote de dialogue, 4D Insider vous demande de
confirmer les modifications avant de les enregistrer.

Manuel de rfrence de 4D Insider

99

Chapitre 7 Aide la traduction

100 Manuel de rfrence de 4D Insider

Impression et export

4D Insider vous permet dimprimer et dexporter des informations lies


aux objets affichs dans la liste Base (liste principale).
Pour chaque objet, vous pouvez imprimer ou exporter :

son contenu

sa documentation

sa liste Source

sa liste Cible.

Imprimer des objets

Pour imprimer des objets :

1 Rduisez la liste Base aux objets que vous souhaitez imprimer.


Pour cela, vous pouvez crer manuellement une sous-slection, appliquer un filtre ou encore effectuer une recherche.
2 Choisissez la commande Imprimer dans le menu Fichier.
Vous pouvez, bien entendu, spcifier au pralable le format dimpression. 4D Insider affiche la bote de dialogue suivante :

Manuel de rfrence de 4D Insider

101

Chapitre 8 Impression et export

Les quatre cases cocher vous permettent de spcifier la nature des


informations que vous voulez imprimer. Vous pouvez imprimer
chaque objet de la slection de la liste Base avec :

son contenu : Cela signifie que vous choisissez dimprimer le contenu des objets tel quil apparat dans la zone graphique (par exemple les formulaires ou les mthodes). Bien entendu, les objets qui,
par leur nature, ne peuvent tre affichs dans la zone graphique, ne
le seront pas limpression : seul leur nom sera imprim. Pour plus
dinformations, reportez-vous au chapitre Navigation parmi les
objets, page 29.

ses objets sources : Pour chaque objet de la liste Base, le nom des
objets de la liste Source seront imprims.

ses objets cibles : Pour chaque objet de la liste Base, le nom des
objets de la liste Cible seront imprims.

sa documentation : Si des objets de votre slection comportent une


documentation, le contenu de cette documentation sera imprim.
Pour plus dinformations sur la documentation des objets, reportezvous au chapitre Documentation, page 61.

3 Slectionnez vos options et cliquez sur OK.


La bote de dialogue standard dimpression saffiche alors.
4 Dfinissez vos paramtrages dimpression et validez la bote de
dialogue.
Une fentre de progression vous permet de contrler le droulement de
limpression.

Exporter des objets


4D Insider vous permet dexporter sous forme de fichier texte un
certain nombre dinformations concernant les objets dune base ou
dune librairie. Tout comme pour limpression, vous pouvez choisir
dexporter vos objets avec leur contenu, leur liste cible, leur liste source
et/ou leur documentation.
Comme le fichier dexport ne contient que du texte, seul les objets
orients texte pourront voir leur contenu export. Voici les objets
orients texte :
Messages daide
Mthodes formulaire
Mthodes projet
102 Manuel de rfrence de 4D Insider

Mthodes base
Mthodes objet
Triggers

Exporter des objets

Bien que la fonction dexport de 4D Insider soit identique entre


Windows et MacOS, la procdure diffre lgrement en fonction de la
plate-forme sur laquelle vous vous trouvez.

Pour exporter une slection dobjets :

1 Rduisez la liste Base aux objets que vous souhaitez exporter.


Pour cela, vous pouvez crer manuellement une sous-slection, appliquer un filtre ou encore effectuer une recherche.
2 Choisissez la commande Exporter... dans le menu Fichier.

La bote de dialogue dexport apparat.

A linstar de limpression, vous devez cocher les options en fonction


des lments que vous souhaitez faire figurer dans le fichier dexport.

Manuel de rfrence de 4D Insider

103

Chapitre 8 Impression et export

Vous pouvez exporter chaque objet de la slection de la liste Base avec :

son contenu : Si vous cochez cette option, vous choisissez dexporter le contenu des mthodes et des messages daide. Les objets
nayant pas de contenu de type Texte ne pourront pas tre
exports : seul leur intitul le sera.

ses objets sources, ses objets cibles : Si vous cochez lune ou lautre
de ces options, les noms des objets des listes correspondantes seront
galement exports pour chaque objet de la slection.

sa documentation : Si des objets de votre slection comportent une


documentation, le contenu de cette documentation sera export.

Format 4D XREF 2.0 : Lorsque cette option est coche, 4D Insider


exporte les documents slectionns au format de 4D XREF 2.0, afin
que vous puissiez utiliser une base de donnes sachant lire ce type
de format. Lorsque cette option est coche, les options prcdentes
sont grises. Par dfaut, le fichier export est de type Texte (ASCII).

3 Slectionnez les options de votre choix.


4 Sous Windows : cliquez sur le bouton OK.
Une bote de dialogue standard denregistrement de fichiers apparat.

Nom du fichier
exporter

Sous MacOS : allez directement ltape n5.


5 Modifiez le nom et lemplacement du fichier dexport votre
convenance.
Par dfaut, 4D Insider propose comme nom de fichier NomDeLaBase
suivi de .TXT sous Windows et .Export sous MacOS.
6 Cliquez sur le bouton Enregistrer.
Le document dexport est immdiatement cr sur le disque. Une fois
lopration termine, vous pouvez ouvrir le fichier gnr avec
nimporte quel traitement de texte.

104 Manuel de rfrence de 4D Insider

Redimensionnement des
formulaires

Pourquoi redimensionner les formulaires ?


4e Dimension et 4D Server, partir des versions 5.5 et 1.5, proposent
loption Redimensionner... dans le menu Formulaire de lditeur de
formulaires. Cette commande permet dappliquer rapidement un
redimensionnement proportionnel tous les objets dun formulaire.

Editeur de formulaires
de 4e Dimension / 4D Client
Commande de redimensionnement de formulaire

Le redimensionnement de formulaire est conu pour optimiser


laffichage de vos formulaires 4D, quelle que soit la plate-forme utilise.
En effet, un objet initialement affich sur un cran Macintosh puis sur
un cran PC Windows semblera plus petit sur lcran PC, bien quil soit
techniquement de la mme taille. Cela est d au fait que la
rsolution cran dun PC est denviron 25 % plus forte que celle dun
Macintosh. Par exemple, un texte en corps 12 sur Macintosh aura
laspect dun corps 9 sous Windows.

Manuel de rfrence de 4D Insider

105

Chapitre 9 Redimensionnement des formulaires

Si cela nest gnralement pas gnant, il peut arriver que les textes
affichs dans des corps 7 et infrieurs apparaissent trop petits sous
Windows. Cest pour cette raison que 4D dispose de loutil de
redimensionnement proportionnel et global des objets dun
formulaire.
La commande Redimensionner... du menu Formulaire (dans lditeur
de formulaires) vous permet dagrandir ou de rduire simultanment
tous les objets de votre formulaire.
Note A partir de la version 6 de 4e Dimension, les problmes lis la taille
des polices de caractres lors de lexploitation multi-plate-forme dune
base peuvent tre rsolus laide des feuilles de style.

Le redimensionnement dans 4D Insider


Tout comme 4D, 4D Insider permet dappliquer un
redimensionnement global aux objets de vos formulaires. Lintrt
majeur que prsente lexploitation de cette fonction depuis 4D Insider
est la possibilit deffectuer un redimensionnement global sur une
slection ou mme la totalit des formulaires de votre base.
Une fois excute, lopration de redimensionnement des formulaires
ne peut pas tre annule. En consquence, utilisez cette fonction avec
prcautions.

Pour redimensionner un ou plusieurs formulaires dune base ou dune


librairie :

1 Rduisez la liste Base au(x) formulaire(s) que vous souhaitez


redimensionner.
Vous pouvez utiliser les filtres, les recherches, ou effectuer une sousslection manuelle.

106 Manuel de rfrence de 4D Insider

Le redimensionnement dans 4D Insider

2 Choisissez Redimensionner les formulaires dans le menu Outils.

Note La commande nest active que si au moins un formulaire est


slectionn dans la liste Base.
La bote de dialogue suivante apparat :

Choix du taux de
redimensionnement
Option de redimensionnement
des images

3 Choisissez le taux de redimensionnement que vous souhaitez


appliquer au(x) formulaire(s).
Les options de cette bote de dialogue sont dcrites ci-dessous.
4 Validez la bote de dialogue.
Les formulaires slectionns sont redimensionns. Vous pouvez visualiser leffet du redimensionnement dans la zone graphique de 4D Insider.
Le redimensionnement dun formulaire provoque galement le dplacement des marqueurs verticaux den-tte, de corps, de rupture et de
pied du formulaire. En revanche, le marqueur dtiquettes (horizontal)
reste inchang.

Manuel de rfrence de 4D Insider

107

Chapitre 9 Redimensionnement des formulaires

Options de
redimensionnement
Macintosh vers
Windows (133%)

Cette option est slectionne par dfaut lorsque vous utilisez la version
Windows de 4D Insider. Elle vous permet de redimensionner des
formulaires construits pour les versions Macintosh de 4D et de les
adapter la rsolution des crans PC. La taille de tous les objets
prsents dans le formulaire est augmente denviron un tiers.

Windows vers
Macintosh (75%)

Cette option est slectionne par dfaut lorsque vous utilisez la version
MacOS de 4D Insider. Elle vous permet de redimensionner des
formulaires construits pour les versions Windows de 4D et de les
adapter la rsolution des crans Macintosh. La taille de tous les objets
prsents dans le formulaire est donc rduite denviron un quart.

Taux manuel

Lorsque vous slectionnez cette option, vous devez saisir un


pourcentage de rduction ou dagrandissement. Vous pouvez ainsi
adapter vos formulaires toute rsolution dcran. La valeur doit tre
comprise entre 25 et 400 %.

Redimensionner les
images

Cette option vous permet de redimensionner toutes les images


prsentes dans votre formulaire. Elle est dslectionne par dfaut car,
en gnral, le rsultat de laugmentation ou de la rduction de la taille
dune image Bitmap nest gure satisfaisant, dun point de vue
esthtique. Cette option est utiliser avec prcaution.
Voici par exemple leffet dun redimensionnement appliqu une
image Bitmap :

Redimensionnement SANS loption


Redimensionner les images

108 Manuel de rfrence de 4D Insider

Redimensionnement AVEC loption


Redimensionner les images

10

Dplacement dobjets

4D Insider permet de dplacer des objets dune base ou dune librairie


vers une autre, cest--dire de recopier dans une base les tables,
formulaires, mthodes... que vous avez crs pour une autre base. Cette
fonctionnalit facilite et acclre le dveloppement de vos bases.
4D Insider ne se limite pas la copie dobjets isols, il peut dupliquer un
objet et ses rfrences, cest--dire ses objets cibles. Vous dplacez ainsi
des fonctionnalits entires. Par exemple, si vous avez cr une bote de
dialogue de recherche personnalise, vous pouvez dplacer le
formulaire utilis pour la bote de dialogue ainsi que toutes les
mthodes, images, variables et autres objets quil utilise. Vous pouvez
copier le formulaire dans une autre base ou dans une librairie
regroupant les fonctionnalits couramment utilises dans vos bases.
Bien entendu, 4D Insider vous permet galement dopter pour un mode
de dplacement sans rfrences (lobjet seul).

Objets dplaables
Tous les objets physiques dune base de donnes peuvent tre
dplacs.
Sont considrs comme physiques les objets tels que les mthodes et
les formulaires, par opposition aux objets dclars tels que les
variables, les smaphores et les ensembles. Les objets dclars ne sont
pas dplaables (cf. paragraphe Objets physiques et objets dclars,
page 79).

Manuel de rfrence de 4D Insider

109

Chapitre 10 Dplacement dobjets

Pour des raisons de cohrence structurelle, la copie de certains objets


entrane la copie des objets qui leur sont indissociables. Par exemple, la
copie dun formulaire entranera la copie de la mthode formulaire et
des mthodes objet qui lui sont ventuellement attaches. Ces objets
indissociables, quant eux, ne peuvent tre directement dplacs.
Voici la liste des objets dplaables par 4D Insider ainsi que les objets
indissociables.
Objets dplaables

Objets indissociables

Barres de menus

Enumrations

Feuilles de style

Formats/Filtres

Formulaires

Mthodes formulaire
Mthodes objet

Groupes

Images

Menus

Messages daide (non lis un champ)

Mthodes projet

Mthodes base

STR#

Tables

Champs
Sous-champs (sous-tables)
Trigger

Messages daide (lis un champ)


Note Vous pouvez reconnatre un objet dplaable en plaant le curseur de
la souris sur son icne. Si lobjet est dplaable, le curseur se transforme
en un curseur de dplacement :

110 Manuel de rfrence de 4D Insider

Dplacement des objets

Dplacement des objets


Plusieurs types de
dplacements

Lorsque vous dplacez un objet, 4D Insider identifie tous les objets


quil rfrence.
Les objets dune base tant imbriqus et interdpendants, le
dplacement de lun deux peut ncessiter den dplacer plusieurs
autres, pour conserver toutes ses fonctionnalits. Dautre part, vous
pouvez navoir besoin que dune partie des rfrences dun objet, voire
lobjet seul.
Vous disposez donc de plusieurs modes de dplacements :

lobjet seul,

lobjet avec certaines de ses rfrences,

lobjet avec toutes ses rfrences.


Pour paramtrer le type de dplacement que vous souhaitez oprer,
4D Insider affiche au moment de la copie une fentre listant toutes les
questions sy rapportant. Il y a deux grandes familles de questions :

celles lies toute copie (si un objet de mme nom existe dj),

celles lies aux rfrences des objets.


Le type de dplacement dpendra des rponses que vous apporterez.

Note Il vous sera possible dagir au moment de la copie sur le type des
questions que 4D Insider vous posera. Cette possibilit est dtaille
dans le paragraphe suivant.

Excution dun
dplacement

Pour dplacer un ou plusieurs objets dun fichier vers un autre :

1 Ouvrez avec 4D Insider votre base ou librairie de dpart (contenant les


objets copier).
2 Ouvrez avec 4D Insider votre base ou librairie (devant recevoir les
objets copier).

Manuel de rfrence de 4D Insider

111

Chapitre 10 Dplacement dobjets

3 Slectionnez, dans la liste Base du fichier de dpart, le ou les objet(s)


dplacer.
Note Les diffrentes mthodes de slection de 4D Insider sont dcrites dans
le paragraphe Manipuler les listes de la fentre de navigation,
page 44.
4 Faites glisser les objets slectionns jusque dans la liste Base de la
fentre darrive. Suivant le type de dplacement que vous souhaitez
obtenir, vous pouvez maintenir une touche de contrle enfonce
pendant lopration (cf. options dcrites ci-dessous).

Si la copie soulve des questions, la fentre de dplacement apparat.


Affichage dtaill des
questions

Lors dun dplacement standard, seules les questions primordiales


(telles que lexistence dun objet de mme nom mais de contenu
diffrent dans le fichier darrive) seront poses. Les objets directement
rfrencs ou ceux dont vous aurez demand la copie automatique
dans les Prfrences de dplacement seront dplacs sans engendrer de
question.
Si vous souhaitez obtenir une liste dtaille des questions, et en
particulier celles lies toutes les rfrences des objets dplacs :

sous Windows, effectuez le dplacement laide du bouton droit de


la souris,

112 Manuel de rfrence de 4D Insider

Dplacement des objets

sous MacOS, maintenez la touche Contrle enfonce au moment du


dplacement.

Note Le rglage des Prfrences de dplacement est trait dans le paragraphe


Paramtrer les Prfrences de dplacement, page 118.
Dplacement rapide
(avec toutes les
dpendances)

Dans certains cas, il est possible que vous souhaitiez copier un objet
avec toutes ses dpendances sans avoir rpondre aux questions. Pour
cela :

Rpondre aux
questions de
4D Insider

sous Windows, maintenez la touche Alt enfonce au moment du


dplacement,

sous MacOS, maintenez la touche Option enfonce au moment du


dplacement.

Les diffrentes questions identifies par 4D Insider se prsentent sous la


forme dune liste. Chaque question se compose de deux lments :

Un titre (Nom de lobjet et question identifie par 4D Insider).

Un menu droulant permettant de slectionner une rponse.

Titre de la question
Menu droulant
pour les rponses
possibles

Pour chaque question pose par 4D Insider, une rponse par dfaut est
slectionne. Cette rponse correspond celle qui est dfinie dans les
Prfrences de dplacement. Le rglage des Prfrences de dplacement
est trait dans le paragraphe Paramtrer les Prfrences de
dplacement, page 118.

Manuel de rfrence de 4D Insider

113

Chapitre 10 Dplacement dobjets

La rponse que vous slectionnez laide du menu sapplique, quant


elle, lobjet considr et pour le dplacement considr.
En haut droite de cette fentre se trouve un menu permettant de
filtrer, par type de question ou dobjet, la liste des questions :

Menu de filtrage
des questions

Une fois que vous avez fini de rpondre aux questions poses, un clic
sur OK effectue la copie (une fentre de progression apparat alors). Le
bouton Annuler vous ramne ltat initial.
Le bouton Enregistrer... vous permet de sauvegarder sous forme dun
fichier texte les questions poses et les rponses que vous y avez
apportes. Vous pourrez ainsi ultrieurement analyser les paramtres
du dplacement.
Lorsque vous avez rpondu une question, une coche apparat en
regard de son intitul.

Question traite

114 Manuel de rfrence de 4D Insider

Dplacement des objets

Chaque rponse une question pouvant entraner dautres


interrogations, la fentre de dplacement est mise jour ds que vous
rpondez une question.
Note Une fois slectionnes, certaines rponses (telles que Copier lobjet)
ne permettent plus dautres choix. Le menu droulant est alors gris.
(cf. paragraphe Description des rponses, page 115).
Lindentation de certaines questions signifie quelles dpendent de la
rponse que vous allez fournir celle qui se trouve au-dessus.

Description des
rponses

Les rponses proposes par 4D Insider sont contextuelles, elles


dpendent de lorigine de la question souleve et du type de lobjet en
cause. Par consquent, chaque cas est un cas particulier. Nous ne
dcrivons ici que les effets gnraux des rponses qui sont proposes.
Note Dans la liste suivante, les termes base de dpart et base darrive
sappliquent bien entendu des fichiers de structure ou des librairies.

Copier et renommer

Contexte : il existe dj un objet portant ce nom dans la base darrive.


Action : 4D Insider affiche une bote de dialogue vous permettant de
renommer, dans la base darrive, lobjet dplacer :

Bien entendu, les rfrences de lobjet seront mises jour dans les
objets de la base ou de la librairie darrive.
Remplacer

Contexte : il existe dj un objet portant ce nom dans la base darrive.


Action : lobjet de la base darrive sera remplac par celui de la base de
dpart.

Ne pas copier

Contexte : il existe dj un objet portant ce nom dans la base darrive.


Action : lobjet de la base darrive sera conserv.

Manuel de rfrence de 4D Insider

115

Chapitre 10 Dplacement dobjets

Mettre jour

Contexte : il existe un objet plus ancien dans la base darrive (cette


rponse apparat principalement dans le cadre du dplacement de
Routines externes).
Action : la version la plus rcente de lobjet est dplace et installe
dans la base darrive.

Utiliser cet objet

Contexte : lobjet que vous souhaitez copier rfrence un objet


existant dj dans la base darrive.
Action : 4D Insider vous permet dutiliser en tant que rfrence lobjet
prsent dans la base darrive.

Ignorer

Contexte : lobjet que vous souhaitez dplacer rfrence un objet qui


nexiste pas dans la base darrive.
Action : les rfrences de lobjet dplac ne seront pas copies, elles
seront laisses vide. Notez que cette rponse peut ncessiter une
mise jour ultrieure de la base darrive.
Par exemple, imaginons une mthode contenant linstruction CREER
ENREGISTREMENT([Clients]). Vous dplacez cette mthode. 4D Insider
vous signale que la table [Clients] nexiste pas dans la base darrive. Si
vous slectionnez la rponse Ignorer, la mthode contiendra, dans la
base darrive, linstruction CREER ENREGISTREMENT().

Utiliser un autre objet

Contexte : lobjet que vous souhaitez copier est li un objet (existant


dj ou non dans la base darrive).
Action : 4D Insider vous permet dutiliser un autre objet dj prsent
dans la base darrive. La bote de dialogue suivante apparat :

116 Manuel de rfrence de 4D Insider

Dplacement des objets

Copier lobjet

Contexte : lobjet que vous souhaitez copier rfrence un objet qui


nexiste pas dans la base darrive.
Action : cest le cas le plus simple, 4D Insider dplace lobjet rfrenc
dans la base darrive.
Note Lorsque vous slectionnez cette rponse, il nest plus possible de la
modifier nouveau (le pop up menu est alors inactif). Si vous la
slectionnez par erreur, cliquez sur le bouton Annuler et recommencez
votre dplacement.

Ajouter le champ la
table

Contexte : vous dplacez un objet rfrenant une table. Soit cette


table nexiste pas dans la base darrive et vous choisissez den utiliser
une autre, soit cette table existe et vous dcidez de lutiliser. Mais, dans
les deux cas, les champs ne correspondent pas.
Action : le champ sera ajout la table de la base darrive.

Note Lorsque vous slectionnez cette rponse, il nest plus possible de la


modifier nouveau (le pop up menu est alors inactif). Si vous la
slectionnez par erreur, cliquez sur le bouton Annuler et recommencez
votre dplacement.
Copier et attribuer un
nouveau numro

Contexte : il existe dans la base darrive une barre de menus avec le


mme numro dID ou le mme contenu que celle que vous souhaitez
dplacer. Ou bien, vous dplacez un objet rfrenant une barre de
menus qui nexiste pas dans la base de destination.
Action : 4D Insider dplace la barre et lui assigne un nouveau numro.

Crer un autre menu

Contexte : il existe dans la base darrive un menu avec le mme nom


(mais pas le mme contenu) que celui que vous souhaitez dplacer, ou
lobjet que vous souhaitez dplacer rfrence un menu inexistant dans
la base darrive.
Action : 4D Insider cre le menu dans la base darrive.

Choisir une table pour


cet objet

Contexte : vous dcidez de ne pas dplacer une table, mais vous


souhaitez dplacer un formulaire qui lui est associ.
Action : 4D Insider affiche une bote de dialogue vous permettant de
dsigner, dans la base darrive, une table laquelle associer le
formulaire.

Manuel de rfrence de 4D Insider

117

Chapitre 10 Dplacement dobjets

Mettre le groupe jour

Contexte : il existe dans la base darrive un groupe de mme nom


mais de contenu diffrent.
Action : le groupe de la base darrive est mis jour avec le contenu de
celui de la base de dpart.

Paramtrer les
Prfrences de
dplacement

Les Prfrences de dplacement sont la liste de toutes les questions que


peut poser 4D Insider lors dun dplacement, et des diffrentes
rponses envisageables. Pour chaque question, vous pouvez
slectionner une rponse par dfaut.
Ce paramtrage aura deux effets :

Les rponses dfinies seront utilises au moment du dplacement, si


aucune question primordiale (telle que lexistence dun objet de mme
nom mais de contenu diffrent dans la table darrive) ne se pose, et si
vous navez pas effectu le dplacement laide du Bouton droit de la
souris (sous Windows) ou appuy sur la touche Contrle au moment
de la copie (sous MacOS). Dans ce cas, laction slectionne en Prfrences sera excute automatiquement, sans intervention de votre
part.

Ces rponses seront galement utilises pour laffichage des rponses


proposes par dfaut dans la fentre de dplacement de 4D Insider lorsque des questions primordiales sont souleves ou lorsque vous utilisez
le bouton droit de la souris (sous Windows) ou appuyez sur la touche
Contrle (sous MacOS) au moment du dplacement.

Note 4D Insider sauvegarde automatiquement vos prfrences de


dplacement dans le fichier de Prfrences du programme, plac :
sous MacOS, dans le dossier Prfrences:4D du dossier Systme.
sous Windows, dans le dossier C:\Windows\4D, o C:\Windows
reprsente le rpertoire systme actif.
Ainsi, vos paramtres seront conservs mme si vous mettez jour
votre version de 4D Insider.

Pour paramtrer les Prfrences de dplacement :

1 Choisissez la commande Fichier>Prfrences de 4D Insider, puis le sousmenu Dplacement.

118 Manuel de rfrence de 4D Insider

Dplacement des objets

La bote de dialogue suivante apparat :

Le fonctionnement de cette bote de dialogue est analogue celui de la


bote de dialogue de dplacement. La liste contient tous les types de
questions qui peuvent tre poses et les diffrentes rponses possibles.
Pour chacune dentre elles, vous pouvez spcifier la rponse par dfaut
que vous dsirez.
Les rponses que vous slectionnez dans cette bote de dialogue seront
affiches par dfaut dans la fentre des questions de 4D Insider lors de
vos dplacements. Cependant, il vous sera toujours possible de les
modifier au moment du dplacement si vous effectuez lopration
laide du bouton droit de la souris (sous Windows) ou maintenez la
touche Contrle enfonce (sous MacOS).
Note Si vous choisissez comme rponse par dfaut Copier lobjet ou
Ajouter le champ la table, vous ne pourrez pas revenir sur ce choix
lors de la copie (pour plus dinformations, reportez-vous la
description de ces rponses : paragraphe Copier lobjet, page 117 et
paragraphe Ajouter le champ la table, page 117).
Si vous souhaitez enregistrer vos paramtrages sous forme de fichier
texte, cliquez sur le bouton Enregistrer... La bote de dialogue standard
denregistrement de documents qui apparat vous permet de choisir un
nom et un emplacement pour votre fichier.
Quand vous avez termin, cliquez sur OK.

Manuel de rfrence de 4D Insider

119

Chapitre 10 Dplacement dobjets

Objets dlimiteurs
Quest-ce quun
objet dlimiteur ?

Un objet dclar dlimiteur aura pour particularit de stopper la


propagation des rfrences lors dun dplacement avec toutes les
dpendances, cest--dire lorsque vous maintenez la touche Alt (sous
Windows) ou Option enfonce (sous MacOS) au moment du
dplacement.
Par dfaut, 4D Insider spcifie que les barres de menus et les menus
constituent des objets dlimiteurs lors dune copie.
Pour les menus, cette dfinition semble vidente car un menu est le
pivot central dune application et fait donc rfrence toutes les
mthodes principales dune base. Si les menus ntaient pas des objets
dlimiteurs, cest quasiment lintgralit de la base que 4D Insider
recopierait en cas de dplacement dun objet rfrenant un menu.

120 Manuel de rfrence de 4D Insider

Objets dlimiteurs

Cependant, suivant le type dinterface et la mthode de


programmation que vous utilisez, vous pouvez tre amen modifier
ce paramtrage par dfaut, comme par exemple considrer que dautres
types dobjets doivent tre considrs comme dlimiteurs. Parfois
mme, vous pourrez avoir besoin de spcifier quun objet doit tre
indpendamment dlimiteur.
Ces deux possibilits vous sont offertes par 4D Insider.

Identifier les objets


dlimiteurs

Vous pourrez aisment identifier tous les objets dlimiteurs dune base
ou dune librairie grce aux fonctions de recherche de 4D Insider : la
bote de dialogue de recherche vous permet de slectionner ce critre.

Recherche des objets dlimiteurs

De plus, la zone dinformations de la fentre principale de 4D Insider


fait apparatre le symbole lorsquun objet est dlimiteur :

Symbole dobjet
dlimiteur

Note Pour plus dinformations sur cette bote de dialogue, reportez-vous au


chapitre Filtres, recherches et remplacements, page 67.

Dfinir des objets


dlimiteurs

Vous pouvez dfinir des objets dlimiteurs de deux manires :

globalement, par type dobjet.

spcifiquement, pour un objet particulier.

Manuel de rfrence de 4D Insider

121

Chapitre 10 Dplacement dobjets

Par type dobjet

Pour dfinir les types dobjets qui doivent tre dlimiteurs :

1 Slectionnez la commande Fichier>Prfrences, puis le sous-menu Objets


dlimiteurs...

La bote de dialogue suivante apparat :

Titre de la liste
Objet dlimiteur
Objet non dlimiteur

Tous les types dobjets suivis dune coche sont considrs comme
dlimiteurs.

Pour ajouter une coche un type dobjet, cliquez sur lobjet.

Pour supprimer la coche dun objet, cliquez de nouveau sur lobjet.

Pour cocher tous les types dobjets, utilisez la combinaison


Majuscule+clic sur le titre de la liste.

Pour supprimer toutes les coches, utilisez la combinaison Alt+clic


(Windows) ou Option+clic (MacOS) sur le titre de la liste.

Pour dfinir un objet particulier comme dlimiteur :

Par objet

1 Slectionnez lobjet dans la liste Base de 4D Insider.


2 Choisissez la commande Outils>Documenter lobjet.

122 Manuel de rfrence de 4D Insider

Objets dlimiteurs

La fentre de documentation de lobjet apparat. Elle comporte une


case cocher Objet dlimiteur :

Option
objet dlimiteur

Note Pour plus dinformations sur la fentre de documentation, reportezvous au chapitre Documentation, page 61.
Cette case cocher trois tats permet de changer le statut dun objet
pour dterminer sil stoppe ou non la propagation des rfrences lors
dun dplacement dobjet. Elle peut tre :

grise : la case cocher est sans effet. Loption dfinie dans les Prfrences des Objets dlimiteurs pour ce type dobjet sera applique (cf.
paragraphe Paramtrer les Prfrences de dplacement, page 118.

coche : lobjet est dlimiteur.

dslectionne : lobjet ne sera pas dlimiteur, quel que soit ltat


dfini pour ce type dobjet dans les Prfrences.

3 Cliquez sur la case cocher Objet dlimiteur jusqu ce quelle


atteigne ltat souhait.
4 Refermez la fentre de documentation.
Lobjet est alors dlimiteur.

Manuel de rfrence de 4D Insider

123

Chapitre 10 Dplacement dobjets

124 Manuel de rfrence de 4D Insider

11

Gestion des composants


4D

4D Insider vous permet de gnrer des composants et de les installer


dans des bases 4D (version 6.7 minimum). Les composants 4D
permettent aux dveloppeurs de commercialiser du code 4D en toute
scurit.
Ce chapitre traite des sujets suivants :

Prsentation et caractristiques des composants

Dvelopper et gnrer des composants

Installer ou mettre jour un composant

Contraintes et conseils de dveloppement

Prsentation et caractristiques des composants


Quest-ce quun
composant ?

Un composant regroupe un ensemble dobjets 4D (tables, mthodes


projet, formulaires, barres de menus, variables...) reprsentant une ou
plusieurs fonctionnalits supplmentaires. Par exemple, vous pouvez
dvelopper un composant 4D de courrier lectronique. Un composant
est autonome, il doit pouvoir tre install dans tout fichier de structure
4D.
Les composants sont dfinis, gnrs et installs laide de 4D Insider.
Lanalyse des rfrences croises effectue par 4D Insider permet de
regrouper la totalit des objets utiliss par un composant.

Manuel de rfrence de 4D Insider

125

Chapitre 11 Gestion des composants 4D

A la diffrence des librairies et des groupes, les composants intgrent la


notion de protection des objets qui les composent. Lors de la phase de
dveloppement du composant, chaque objet se voit attribuer le type
Public, Protg ou Priv. Cet attribut dtermine si lobjet, une
fois le composant install dans la base 4D, sera visible ou modifiable
dans 4e Dimension et dans 4D Insider.

Principes de
cration

Comme les groupes, les composants sont crs dans 4D Insider par
regroupement et ajout dobjets 4D provenant dune base ou dune
librairie. Chaque nouveau composant dispose automatiquement dun
ensemble de trois dossiers (Public, Protg et Priv), parmi
lesquels le dveloppeur doit rpartir chaque objet.

Une fois la rpartition termine, le dveloppeur gnre le composant,


qui devient alors un fichier stock sur disque. Ce fichier pourra ensuite
tre install dans une base 4D.

Principes
dinstallation

Vous pouvez installer autant de composants que vous voulez dans une
base 4D.
Linstallation dun composant seffectue par lintermdiaire dun
fichier de composant, gnr par 4D Insider et stock sur disque.
La procdure dinstallation de ce fichier dans une base 4D seffectue
galement depuis 4D Insider. Ce fonctionnement facilite la diffusion et
la mise jour des composants 4D. 4D Insider permet en effet de mettre
jour des bases 4D lorsque de nouvelles versions des composants sont
gnres.
Enfin, il est possible de dsinstaller un composant.

Dfinition des
attributs

Lors de la cration dun composant avec 4D Insider, chaque objet


inclus dans le composant reoit lun des trois attributs suivants :
Public, Protg ou Priv. Ces attributs, la base du systme de
protection des composants, indiquent si les objets concerns seront
visibles et modifiables dans le mode Structure de 4e Dimension et dans
4D Insider, une fois le composant install.
Note Bien entendu, en phase de dveloppement dun composant, tous les
objets restent visibles et dplaables dans 4D Insider, quel que soit leur
attribut.

126 Manuel de rfrence de 4D Insider

Prsentation et caractristiques des composants

Public : les objets publics seront visibles et modifiables par les


utilisateurs, toutefois ils ne pourront tre ni renomms ni supprims.
Ce type dobjet peut tre utile pour fournir des objets personnalisables
par les utilisateurs.
Dans les diteurs de 4D, les objets publics apparaissent comme tous les
autres objets.

Protg : les objets protgs seront visibles mais ne pourront tre ni


modifis ni supprims par les utilisateurs. Une mthode protge peut
tre appele, mais son contenu ne peut tre ni visualis ni modifi (la
zone de prvisualisation de lExplorateur reste vide).
Dans les diteurs de 4D, licne des objets protgs est barre dun trait
rouge :

Priv : les objets privs ne seront ni visibles ni, par consquent,


modifiables par les utilisateurs des composants, aussi bien dans
4e Dimension que dans 4D Insider.

Note Les tables et les champs ne peuvent avoir lattribut Priv. En outre,
en cas de dsinstallation du composant, ils ne seront pas supprims de
la base. Reportez-vous au paragraphe Dsinstaller un composant,
page 138.
Le tableau suivant rsume les possibilits offertes dans 4D et 4D Insider
par les objets contenus dans les composants, en fonction de leur
attribut :

Public
Protg
Priv

Nom visible

Contenu
visible

Oui
Oui
Non

Oui
Non
Non

Contenu Renommable ou
modifiable
supprimable
Oui
Non
Non

Non
Non
Non

Note De manire gnrale, les attributs des objets des composants seront
respects par toutes les applications et plug-ins de lenvironnement 4D,
tels que 4D Write ou 4D Compiler.

Manuel de rfrence de 4D Insider

127

Chapitre 11 Gestion des composants 4D

Visualisation et
Lorsquun composant est install dans une base 4D, tous les objets
utilisation des
quil contient sont ajouts dans la base et sont disponibles dans les
composants installs diteurs du mode Structure lorsque leur type est Public ou Protg
(cf. paragraphe Dfinition des attributs, page 126).
Chaque composant install dans la base est list dans la page
Composants de lExplorateur de 4D :
Onglet Composants

Liste des composants et


des plug-ins installs
dans la base
Proprits du composant
slectionn (saisies dans
4D Insider)

Dans 4D Insider, un composant install reste visible dans les listes. Le


filtre Groupes & Composants permet dafficher les composants
installs.
Toutefois, le dossier Priv napparat pas et le contenu du dossier
Protg ne peut tre visualis. Aucun objet du composant ne peut
tre supprim ou renomm. Les objets ne peuvent tre dissocis. Enfin,
le composant ne peut tre dplac dans une autre base ou librairie.

128 Manuel de rfrence de 4D Insider

Dvelopper et gnrer un composant

Dvelopper et gnrer un composant


Le dveloppement dun nouveau composant 4D seffectue en trois
principales tapes :
1 Dveloppement de la (des) fonctionnalit(s) du composant laide de
4D.
Le dveloppement de composants ncessite quelques prcautions.
Reportez-vous au paragraphe Contraintes et conseils de dveloppement, page 139.
2 Cration dans 4D Insider dun nouveau composant regroupant
lensemble des objets, et dfinition de lattribut de chaque objet.
Cette tape est traite dans le paragraphe Crer un nouveau composant, page 130.
3 Gnration dans 4D Insider dun fichier de composant destin
linstallation du composant dans les bases 4D.
Cette tape est traite dans le paragraphe Gnrer le fichier de composant, page 135.
Lultime tape consiste installer ou mettre jour le composant dans
les bases 4D. Reportez-vous au paragraphe Installer et mettre jour un
composant, page 135.

Types dobjets
admis

La plupart des objets identifis par 4D Insider comme objets


dplaables (cf. chapitre Dplacement dobjets, page 109) peuvent
tre inclus dans un composant :

Tables et champs

Triggers

Formulaires

Mthodes formulaire, Mthodes objet et Mthodes projet

Menus et Barres de menus

Enumrations

Info-bulles

Ressources1 (STR# et PICT)

Images de la bibliothque

Formats et filtres
1. Lutilisation de ressources dans un composant ncessite des prcautions
demploi. Reportez-vous au paragraphe Grer les numros de ressources
STR# et PICT, page 140.

Manuel de rfrence de 4D Insider

129

Chapitre 11 Gestion des composants 4D

Feuilles de style

Commentaires

Les objets de langage suivants peuvent galement tre inclus dans un


composant :

Variables locales, process et interprocess

Ensembles

Slections

Smaphores

Note Par consquent, notez en particulier que les mthodes base, plug-ins,
groupes et composants ne peuvent pas tre inclus dans un composant.

Crer un nouveau
composant

La cration dun nouveau composant seffectue partir dune librairie


ou dune base de donnes 4D ouverte par 4D Insider.
4D Insider vous propose deux options :

Crer un composant vide, que vous remplirez par glisser-dposer.

Crer un composant partir de la slection courante dobjets. Par


dfaut, les objets slectionns seront placs dans le dossier Protg. Ce composant peut tre modifi par la suite.

Pour crer un composant vide :

1 Ouvrez la structure dune base ou dune librairie avec 4D Insider.


2 Slectionnez la commande Nouveau... dans le menu Composants.
La bote de dialogue des proprits du composant apparat :

Choix du mode (dsactiv


lorsquaucun objet nest
slectionn)

130 Manuel de rfrence de 4D Insider

Dvelopper et gnrer un composant

3 Saisissez les informations concernant le composant.


Ces informations seront affiches dans lExplorateur de 4D, une fois le
composant install. Notez que les proprits du composant peuvent
tre modifies tout moment. Pour plus dinformations, reportez-vous
au paragraphe Proprits du composant, page 132.
4 Si le bouton radio de choix du mode de cration est dsactiv (aucun
objet ntait slectionn lorsque vous avez utilis la commande
Nouveau...), cliquez sur le bouton OK.
OU
Si le bouton radio de choix du mode est actif, slectionnez loption
Crer un composant vide et cliquez sur le bouton OK.
Le nouveau composant est immdiatement cr dans une nouvelle
fentre. Il comporte trois dossiers vides, Priv, Protg et Public.
5 Rpartissez dans les dossiers chaque objet que vous souhaitez inclure
dans le composant.

Pour ajouter un ou plusieurs objet(s) dans un des dossiers du composant, slectionnez-le(s) dans les autres fentres, faites-le(s) glisser
et dposez-le(s) dans le dossier souhait. Vous pouvez galement
rorganiser le contenu des dossiers du composant par glisserdposer dobjets.

Pour supprimer un ou plusieurs objet(s) dun dossier du composant,


slectionnez-le(s) et faites un glisser-dposer de la slection vers la
fentre dorigine.
Bien entendu, seuls des objets dplaables peuvent tre inclus dans un
composant (cf. paragraphe Types dobjets admis, page 129).
Les objets sont dplacs avec leurs dpendances, en respectant la cohrence des attributs. Par exemple, si un formulaire est plac dans le dossier Priv, tous les objets quil rfrence seront galement dplacs
dans le mme dossier. Pour plus dinformations sur ce point, reportezvous au paragraphe Attributs des objets dplacs, page 134.

Pour crer un composant partir de la slection courante dobjets :

1 Ouvrez la structure dune base ou dune librairie avec 4D Insider.


2 Slectionnez, dans la liste Base, les objets que vous souhaitez inclure
dans le composant.
Seuls les objets dplaables seront inclus dans le composant (cf. paragraphe Types dobjets admis, page 129).

Manuel de rfrence de 4D Insider

131

Chapitre 11 Gestion des composants 4D

3 Slectionnez la commande Nouveau... dans le menu Composants.


La bote de dialogue des proprits du composant apparat.

Options de mode
de cration

4 Saisissez les informations concernant le composant.


Ces informations seront affiches dans 4D, une fois le composant install. Notez quen phase de dveloppement, les proprits du composant peuvent tre modifies tout moment. Pour plus dinformations,
reportez-vous au paragraphe Proprits du composant, page 132.
5 Vrifiez que loption Crer daprs la slection est slectionne et
cliquez sur le bouton OK.
Le composant est immdiatement cr dans une nouvelle fentre. Il
comporte trois dossiers, Priv, Protg et Public.

Tous les objets slectionns sont automatiquement placs dans le


dossier Protg.

Toutes les dpendances (cibles) des objets slectionns sont automatiquement places dans le dossier Priv.

6 Si ncessaire, rorganisez le contenu des dossiers Priv, Protg et


Public en utilisant le glisser-dposer (cf. tape n5 de la cration de
composants vides).

Proprits du
composant

Les proprits du composant apparaissent dans la zone de


prvisualisation de lExplorateur de 4D, lorsque celle-ci est dploye :
Nom, Date de cration, Nom et Numro de version, Prfixe et
Commentaires. Ces informations permettront didentifier prcisment
tout composant install dans une base.

132 Manuel de rfrence de 4D Insider

Dvelopper et gnrer un composant

Vous pouvez afficher tout moment les proprits du composant


slectionn en choisissant la commande Proprits... dans le menu
Composants.

Nom : Nom du composant, tel quil apparatra aux utilisateurs. Au sein


dune mme base ou librairie, le nom dun composant doit tre unique.
Ce nom sera utilis par 4D Insider au moment de lintgration du composant pour dterminer si lopration est une installation ou une mise
jour. Ce nom sera aussi utilis par dfaut pour le fichier de composant gnr.
Le nom dun composant peut comporter jusqu 32 caractres.

Note Vous pouvez renommer un composant laide de la commande


Renommer de 4D Insider (cf. paragraphe Remplacer, page 78).

Date : Date de cration du composant. Par dfaut, la date du jour est


affiche. Vous pouvez toutefois saisir toute date.

Nom de version : Indicateur du type de version du composant


(Dmo, Complte, Macintosh, etc.). Le nom de version sera
ajout au nom du composant afin de fournir le nom par dfaut du
fichier de composant.

Numro de version : Numro de version du composant, utile pour la


maintenance et la mise jour des composants. Sil sagit dune mise
jour, ce numro est utilis par 4D Insider pour dterminer si le composant en cours dinstallation est plus rcent que le composant dj install. Cette zone est obligatoire et le numro de version doit tre
suprieur 0.

Prfixe : Prfixe (4 caractres maximum) que 4D Insider placera devant


le nom des objets privs du composant. Lorsque vous utilisez cette
option, 4D Insider renomme alatoirement (encrypte) tous les objets
privs lors de la phase de gnration du composant afin de renforcer sa
protection. Le nom des objets encrypts dbutera par le prfixe saisi.

Manuel de rfrence de 4D Insider

133

Chapitre 11 Gestion des composants 4D

Le prfixe est obligatoire lorsque loption Renommer les objets privs a


t coche le renommage des objets privs est optionnel afin dassurer la compatibilit avec les composants dvelopps en version 6.7.x.
Bien entendu, il est recommand dutiliser dans cette bote de dialogue
le mme prfixe que celui associ tous les objets du composant (cf.
paragraphe Eviter les conflits de noms, page 139).

Attributs des objets


dplacs

Commentaires : Tout texte (255 caractres) que vous jugerez utile


dassocier au composant (copyrights, conseils, etc.).
Lorsque vous dplacez des objets vers les dossiers des composants,
4D Insider dplace automatiquement leurs dpendances (objets cibles).
Les attributs par dfaut des objets cibles sont dtermins de la manire
suivante :
Objet plac dans le dossier...

Attribut des cibles de lobjet

Public
Protg
Priv

Public
Priv
Priv

Si un mme objet apparat simultanment dans les dossiers Public et


Protg (par exemple, une variable utilise plusieurs emplacements
de la base), il sera dfini en Public. De manire gnrale, lorsquun
mme objet est rfrenc dans plus dun dossier du composant, le
niveau de protection le moins lev est utilis.

Oprations sur les


composants en
cours de cration
dans 4D Insider

Toutes les fonctions de 4D Insider continuent de sappliquer aux objets


placs dans les diffrents dossiers dun nouveau composant.
Les composants saffichent toujours la suite des autres objets, quel
que soit le type de filtre qui est appliqu. Le filtre Groupes & composants permet dafficher les composants (en dveloppement ou installs).
Dans le cas dune slection laquelle vous avez appliqu un filtre, les
dossiers du composant ouvert nafficheront que les objets correspondant ce filtre.
De mme, lorsque vous effectuez une recherche, il se peut que certains
des objets rpondant aux critres de recherche se trouvent lintrieur
dun composant. Dans ce cas, le composant apparatra dans la liste
issue de la recherche, mais naffichera que les objets trouvs.

134 Manuel de rfrence de 4D Insider

Installer et mettre jour un composant

Gnrer le fichier de Une fois que vous avez dfini un composant, vous devez gnrer le
composant
fichier qui sera utilis pour linstallation ou la mise jour du
composant. Un fichier de composant est multi-plate-forme : il peut
tre gnr sur une plate-forme et install sur une autre.

Pour gnrer un fichier de composant :

1 Dans la liste Base de 4D Insider, slectionnez le composant gnrer.


2 Choisissez la commande Gnrer... dans le menu Composants.
Une bote de dialogue standard denregistrement de fichiers apparat :

Par dfaut, un fichier de composant reoit le nom donn au composant


suivi dun espace puis du nom et du numro de la version (par exemple
MonComposant Dmo-2). Sous Windows, lextension .4CP lui est
en outre associe et un fichier .RSR est gnr.
3 Dfinissez le nom et lemplacement du fichier et cliquez sur
Enregistrer.
Le fichier de composant est alors gnr sur le disque, prt tre install.

Installer et mettre jour un composant


Linstallation dun nouveau composant ou dune version de mise
jour au sein dune base 4D seffectue par lintermdiaire de 4D Insider.
Le principe consiste installer le composant (gnr par 4D Insider)
dans une structure1 pralablement ouverte par 4D Insider.
Le programme gre les ventuels conflits issus de linstallation et en
informe lutilisateur mesure quils sont dtects (cf. paragraphe
Gestion des conflits dinstallation, page 137).
1. Il nest pas possible dinstaller un composant dans une librairie.

Manuel de rfrence de 4D Insider

135

Chapitre 11 Gestion des composants 4D

Pour installer ou mettre jour un composant :

1 Ouvrez avec 4D Insider la base dans laquelle vous souhaitez installer le


composant.
2 Choisissez la commande Installer/Mettre jour... dans le menu
Composants.
Une bote de dialogue standard douverture de fichiers apparat.
3 Slectionnez le fichier du composant et cliquez sur le bouton Ouvrir.
4D Insider analyse le contenu du composant et lintgre la base
ouverte.
Le programme dtecte si lopration correspond une installation ou
une mise jour. Cette dtection est base sur le nom et le numro de
version du composant, dfinis dans les Proprits du composant (cf.
paragraphe Proprits du composant, page 132).

en cas dinstallation nouvelle, tous les objets du composant sont


installs.

en cas de mise jour, 4D Insider compare le numro de version du


composant en cours dinstallation avec celui du composant dj
prsent. Si la date du nouveau composant est plus ancienne que
celle du composant dj install, une bote de dialogue dalerte le
signale lutilisateur il peut alors Poursuivre ou Annuler la mise
jour.
4D Insider remplace les anciens objets par les objets plus rcents
(nom identique), ajoute les nouveaux objets et ne modifie pas les
objets nexistant plus dans la nouvelle version du composant.

4D Insider tient compte des objets publics ayant t modifis par


lutilisateur et lui propose de les conserver ou de les remplacer. En
outre, si lintgration provoque des conflits ou des interrogations,
lutilisateur en est inform.
Ces points sont traits dans le paragraphe suivant, Gestion des
conflits dinstallation.
4 Enregistrez la base laide de 4D Insider.
Le composant est alors install dans la base et est list dans la page
Composants de lExplorateur de 4D (cf. paragraphe Visualisation et
utilisation des composants installs, page 128).

136 Manuel de rfrence de 4D Insider

Installer et mettre jour un composant

Gestion des conflits


dinstallation

Lorsquun composant est install ou mis jour dans une base 4D,
divers interrogations et conflits peuvent se produire :

en cas de mise jour, 4D Insider dtecte quun ou plusieurs objets


publics ont t modifis par lutilisateur aprs linstallation du
composant.

un ou plusieurs objets de mme type et de mme nom existent dj


dans la base.

4D Insider dtecte ces conflits au moment de linstallation et propose


de les rsoudre :

Objets publics modifis (mise jour uniquement)


Dans ce cas, 4D Insider affiche une bote de dialogue dalerte et permet
lutilisateur de choisir le mode de mise jour :

Remplacer lobjet

Tout remplacer

Ne pas remplacer lobjet

Stopper linstallation

Conflits de noms
Dans ce cas, 4D Insider stoppe le processus dinstallation du composant, affiche une bote de dialogue dalerte et enregistre la liste des
objets en conflit. Cette liste est stocke sous forme de fichier texte dans
le dossier de la base 4D. A noter que les noms de tous les objets mis en
cause sont lists, y compris ceux des dossiers privs et protgs.
Les conflits de noms entre les objets logiques tels que les variables sont
grs, de manire permettre la compilation de la base et viter les
conflits inter-composants.
Pour pouvoir installer le composant, il pourra tre ncessaire de
renommer certains objets de la base ou du composant.

Cas particulier : Table dinterface des composants


Il est frquent que les dveloppeurs aient besoin de crer une table
dinterface dans le but de gnrer des formulaires utiliss comme botes
de dialogue. Gnralement, ces formulaires nutilisent pas de champs,
mais uniquement des variables.
Comme il nest pas possible de supprimer une table dans 4D, linstallation successive de composants dans une mme base risque de provoquer une multiplication inutile des tables du type [Interface].

Manuel de rfrence de 4D Insider

137

Chapitre 11 Gestion des composants 4D

Pour rsoudre cette question, 4D Insider propose dutiliser une table


dinterface des composants. Lorsquune telle table est dfinie dans un
composant, une bote de dialogue spcifique est affiche au moment
de linstallation du composant :

Le choix suivant est propos :

Copier cette table dans la base


Dans ce cas, la table est cre dans la base 4D, mais devient une
table 4D standard, nappartenant pas au composant. Elle sera donc
utilisable comme table dinterface lors de linstallation ventuelle
dautres composants.
Cette option peut tre utilise lors de linstallation dun premier
composant.

Relier la table une table existante de la base


Dans ce cas, la liste des tables de la base est prsente, lutilisateur
doit slectionner celle que le composant utilisera comme table
dinterface.

Ce fonctionnement est rendu possible par le fait que les composants


nutilisent aucun des champs de la table dinterface ; elle peut tre
modifie et utilise sans risquer dinteragir avec le comportement du
composant.
Pour quune table puisse tre dfinie comme table dinterface des
composants, ses caractristiques doivent tre les suivantes :

Dsinstaller un
composant

aucun des champs de la table nest utilis par le composant,

lattribut de la table est public.

4D Insider propose une fonction permettant de dsinstaller des


composants pralablement installs dans des bases 4D.

Pour dsinstaller un composant dune base 4D :

1 Ouvrez avec 4D Insider la base contenant le composant dsinstaller.


2 Dans la liste Base, slectionnez le nom du composant supprimer.

138 Manuel de rfrence de 4D Insider

Contraintes et conseils de dveloppement

3 Slectionnez la commande Dsinstaller... dans le menu Composants.


Cette commande nest active que lorsquun composant a t install
dans la base.
Une bote de dialogue apparat, vous permettant de confirmer ou
dannuler lopration.
4 Cliquez sur OK pour valider lopration.
Tous les objets du composant sont alors supprims.
Les tables ventuellement cres par le composant ne sont pas supprimes. Ces objets deviennent publics et sont renommes [Table Supprime]. Les champs ne sont pas modifis.
Note Pour supprimer tous les objets dun composant (tables et champs
compris), vous pouvez galement procder de la manire suivante :
slectionnez tous les objets de la base contenant le composant et
dplacez-les vers une nouvelle base vierge. Comme les objets dun
composant ne peuvent tre dplacs, la nouvelle base ne contiendra
pas les objets du composant.

Contraintes et conseils de dveloppement


Le dveloppement de composants destins tre diffuss au sein de
multiples bases 4D entrane des contraintes spcifiques. Ce paragraphe
dresse la liste de ces contraintes et fournit quelques conseils de
dveloppement.

Eviter les conflits de Lors de linstallation dun composant, 4D Insider prserve lintgrit de
noms
la base en contrlant les noms des objets. En cas dinstallation dun
nouveau composant, si des objets de mme nom sont dtects dans le
composant et dans la base, linstallation est annule.
Vous devez donc veiller utiliser des noms dobjets originaux, par
exemple leur attribuant des prfixes personnaliss.
Nous conseillons aux dveloppeurs de composants dutiliser la
nomenclature suivante :

saisir un identifiant unique comprenant 4 caractres au dbut de


chaque nom dobjet (par exemple mdev) ; cet identifiant unique
pourra tre utilis comme prfixe des objets privs (cf. paragraphe
Proprits du composant, page 132),

faire suivre cet identifiant dun trait de soulignement (_),

Manuel de rfrence de 4D Insider

139

Chapitre 11 Gestion des composants 4D

insrer trois ou quatre caractres indiquant lattribut de lobjet


(priv ou pub),

faire suivre cet attribut dun autre trait de soulignement,

enfin, saisir le nom de lobjet.

Exemples :
mdev_Priv_MonFormulaire
Dcom_Pub_MaMthode

Dclarer les
variables

En vue de la compilation des bases ayant intgr un ou plusieurs


composants, il est ncessaire de sassurer quaucun conflit ou
ambigut de typage ne puisse se produire, en particulier au sein de
mthodes prives ou protges. Par dfaut, 4D Compiler naffiche
pas les noms des mthodes prives. Toutefois, 4D Compiler listera les
noms des mthodes en cause en cas de conflit de typage, quel que soit
leur attribut.
Il est donc fortement conseill de typer toutes les variables 4D utilises
dans les mthodes des composants, par exemple dans une mthode
dont le nom dbute par COMPILER (voir ce sujet les commandes du
thme Compilateur dans le manuel Langage de 4D).

Grer les numros


de ressources STR#
et PICT

Si votre composant utilise des ressources personnalises de type PICT


(incluses dans des formulaires) ou STR#, il les rfrence laide de
numros spcifiques.
Or, lorsque le composant est install dans une structure, il est possible
que ces numros soient dj attribus, par exemple si un autre
composant utilisant des ressources a dj t install. Dans ce cas, 4D
renumrote automatiquement les nouvelles ressources lors de
linstallation. Ce mcanisme garantit quaucune ressource nest
crase au cours de linstallation, mais peut savrer problmatique si
le code de votre composant rfrence les ressources par des numros
en dur.
Pour viter ce problme, 4D propose la commande Lire ID ressource
composant. Sur la base du nom du composant, du type de ressource et
de son numro original, cette commande retourne le numro
rellement utilis de toute ressource dans la base.

140 Manuel de rfrence de 4D Insider

Contraintes et conseils de dveloppement

Par exemple, le code ci-dessous ne permet pas de garantir que les


appels de ressources seront correctement effectus :
`Si les ressources sont renumrotes, cet appel sera incorrect
vNumRes := 15000
LISTE DE CHAINES VERS TABLEAU(vNumRes; tabChanes; fichierRes)
Il est fortement conseill de prfrer le code suivant :
`Cet appel sera correct dans tous les cas
vNumRes :=Lire ID ressource composant("LeComposant";"STR#";15000)
LISTE DE CHAINES VERS TABLEAU (vNumRes; tabChanes; fichierRes)
De mme, si vos formulaires exploitent des ressources PICT, vous
pouvez utiliser Lire ID ressource composant avec les commandes de
gestion des ressources PICT telles que LIRE RESSOURCE IMAGE.
Pour plus dinformations sur ces commandes, reportez-vous au manuel
Langage de 4D.

Grer les numros


dimages de la
bibliothque

A linstar des ressources, si un composant 4D fait appel des images


stockes dans la bibliothque dimages, leurs numros de rfrence
seront modifis lors de linstallation au cas o des images ayant le
mme numro existent dj dans la base.
Pour viter ce problme, vous devez utiliser dans le composant la
commande LIRE IMAGE DANS BIBLIOTHEQUE et lui passer comme
premier paramtre un nom dimage et non un numro. A la diffrence
du numro de rfrence, le nom de limage ne pourra pas tre modifi
au cours de linstallation, et les appels seront corrects dans tous les cas.
En revanche, comme pour les autres objets, 4D Insider interdira
linstallation dun composant si une image de mme nom existe dj
dans la bibliothque.

Note La commande SUPPRIMER IMAGE DANS BIBLIOTHEQUE na pas deffet


avec une image appartenant un composant. La commande ECRIRE
IMAGE DANS BIBLIOTHEQUE na pas deffet avec une image appartenant
un composant et dont lattribut est priv ou protg.

Manuel de rfrence de 4D Insider

141

Chapitre 11 Gestion des composants 4D

Protger les
composants

Vous pouvez, si vous le souhaitez, lier chaque copie de votre


composant une seule application 4D installe, afin dempcher toute
copie illicite. En effet, une cl unique est gnre pour chaque
application 4D installe. Sur la base de cette cl, vous pouvez contrler
que le composant est bien utilis dans lapplication pour laquelle la
licence dutilisation a t octroye.
Ce systme de protection est bas sur lemploi de la commande de 4D
LIRE INFORMATIONS SERIALISATION : un utilisateur souhaitant acqurir
un composant fournit au dveloppeur sa cl unique gnre laide
de la commande LIRE INFORMATIONS SERIALISATION. Cette opration
peut, par exemple, tre effectue par lintermdiaire dun formulaire
Bon de commande intgr la version de dmonstration du
composant.
Le dveloppeur du composant peut alors gnrer son propre numro
de srie, en combinant la cl et lalgorithme de cryptage de son choix.
Le composant livr comportera une fonction permettant de tester si les
informations retournes par LIRE INFORMATIONS SERIALISATION
correspondent bien ce numro de srie. Dans le cas contraire, le
composant sera rendu inutilisable.
Pour plus dinformations sur la commande LIRE INFORMATIONS
SERIALISATION, reportez-vous la description de cette commande dans
le manuel Langage de 4D.

142 Manuel de rfrence de 4D Insider

12

Exploiter un fichier SQL

4D Insider vous permet, partir dun script SQL de description de base


de donnes (script DDL), de gnrer un nouveau fichier de structure
4D. Ce fichier comportera les tables, les champs et les liens dcrits par
les commandes SQL du script.
Ce fichier SQL peut tre cr partir doutils de conception (case tools)
tels que AMC*Designor1 ou Erwin/Desktop2, ou dun diteur de texte.
Note 4D Insider analyse les scripts compatibles SQL92 enregistrs au format
Texte MacOS ou Windows. Ces fichiers Texte ne doivent pas comporter
de commentaires. Les liens gnrs sont des liens manuels. Si
4D Insider rencontre une erreur de syntaxe SQL, lopration est
annule.

Voici un exemple (simple) de contenu dun fichier Texte SQL gnr


par un outil de conception :
CREATE TABLE SALARIE
(
SALNUM NUMERIC(4)
NOT NULL,
DIVNUM NUMERIC(4)
NOT NULL,
SAL_SALNUM NUMERIC(4),
SALNOM CHAR(40),
SALPRE CHAR(40),
SALFON CHAR(40),
SALREM NUMERIC(8,2),
SALCOM NUMERIC(8,2),
PRIMARY KEY (SALNUM),
FOREIGN KEY (DIVNUM) REFERENCES DIVISION (DIVNUM),
FOREIGN KEY (SAL_SALNUM) REFERENCES SALARIE (SALNUM)
);
1. AMC*Designor est une marque enregistre de Sybase Corporation.
2. Erwin/Desktop est une marque enregistre Logic Works Corporation

Manuel de rfrence de 4D Insider

143

Chapitre 12 Exploiter un fichier SQL

Verbes et options SQL interprts par 4D Insider


4D Insider interprte deux verbes SQL : CREATE TABLE et CREATE INDEX,
ainsi quun certain nombre doptions. Le tableau ci-dessous fournit la
liste de ces commandes et options :
Commande SQL Options
Action dans la base 4D
CREATE TABLE
Cre une table 4D
PRIMARY KEY() Indexe le champ 4D cr et lui affecte
la proprit Unique
FOREIGN KEY() La combinaison de ces deux options
REFERENCES() cre un lien manuel de type N vers 1.
FOREIGN KEY() cre un champ index
unique recevant le lien.
REFERENCES() cre un champ 4D
index pointant vers lautre champ
NOT NULL
Cette contrainte rend obligatoire le
champ 4D cr
CREATE INDEX
Cre un champ 4D index
UNIQUE
Cre un champ 4D index unique
Note Toutes les commandes SQL92 sont acceptes, 4D Insider ignore
simplement celles quil ninterprte pas.

Table de conversion des types de champs


Lors de lanalyse, 4D Insider effectue une conversion de types entre les
champs dcrits et les champs disponibles dans 4D.
Types SQL ODBC et SQL 92
CHAR, NCHAR
CHAR(x)*, NCHAR(x)*
VARCHAR(x)
CHAR VARYING, NCHAR VARYING
LONG VARCHAR
TINYINT, SMALLINT
INT, INTEGER
BIGINT, DOUBLE, DOUBLE PRECISION
NUMERIC, NUMERIC(x), NUMERIC(x,y)
DECIMAL, DECIMAL (x), DECIMAL (x,y)

144 Manuel de rfrence de 4D Insider

Types 4D
Alpha(2)
Alpha(x)
Texte
Texte
Texte
Entier
Entier Long
Numrique
Numrique
Numrique

Table de conversion des types de champs

Types SQL ODBC et SQL 92


DEC, DEC (x), DEC (x,y), REAL, FLOAT
BIT
BIT(x), BIT VARYING
BINARY(x), VARBINARY(x)
LONG VARBINARY
DATE
TIME, TIMESTAMP, TIME WITH TIME ZONE
TIMESTAMP WITH TIME ZONE

Types 4D
Numrique
Boolen
BLOB
BLOB
BLOB
Date
Heure
Heure

* lorsque le nombre de caractres est suprieur 80, 4D Insider tronque


automatiquement la longueur du champ 4D 80 caractres.

Voici des exemples de fichiers Texte SQL dcrivant une base comportant plusieurs tables et des liens :
CREATE TABLE SOCIETES (
REF
INTEGER,
NOM CHAR (25) NOT NULL,
ADRESSE VARCHAR (200),
CODE_P CHAR (5),
TEL CHAR (15),
FAX CHAR (15),
CREDIT FLOAT,
ECHEANCE DATE,
PRIMARY KEY (REF) );
CREATE TABLE CONTACTS (
REF INTEGER,
REF_SOCIETE INTEGER NOT NULL,
NOM CHAR (20),
F_NOM CHAR (20),
EXTENSION CHAR (3),
PRIMARY KEY (REF),
FOREIGN KEY (REF_SOCIETE) REFERENCES SOCIETES (REF) );
CREATE UNIQUE INDEX COMP_IDX ON SOCIETES (REF);
CREATE INDEX NOMSOCIETE_IDX ON SOCIETES (NOM);
CREATE UNIQUE INDEX CONT_IDX ON CONTACTS (REF);
CREATE INDEX NOMCONT_IDX ON CONTACTS (NOM);

Manuel de rfrence de 4D Insider

145

Chapitre 12 Exploiter un fichier SQL

Gnrer une base partir dun fichier Texte SQL

Pour gnrer un fichier de structure 4D partir dun fichier Texte SQL :

1 Choisissez la commande Ouvrir fichier SQL... dans le menu Fichier.

Une bote de dialogue standard douverture de documents saffiche.


2 Slectionnez votre fichier de description SQL et cliquez sur le bouton
Ouvrir.

4D Insider affiche alors une bote de dialogue standard de sauvegarde


de documents, vous permettant de dfinir le nom et lemplacement du
fichier de structure 4D crer.
3 Nommez le fichier de structure crer et cliquez sur le bouton
Enregistrer.
4D Insider analyse alors le fichier SQL et gnre le fichier de structure.
Le programme construit ensuite la table des rfrences croises du
fichier de structure 4D gnr.

146 Manuel de rfrence de 4D Insider

Gnrer une base partir dun fichier Texte SQL

Une fois ces analyses effectues, 4D Insider affiche une nouvelle fentre
comportant le nom de la base et affichant les tables gnres.
Comme pour toute base ou librairie ouverte par 4D Insider, la slection
dun champ provoque laffichage :

dans zone graphique, du type du champ (numrique, alpha...), de


ses proprits (saisissable, index, unique...), lexistence dune relation sil y en a.

dans zone dinformation, le nom de la table dappartenance et le


nom du champ.

dans liste Source, les tables et champs pointant sur le champ


slectionn.

dans liste Cible, les tables et champs points.

Manuel de rfrence de 4D Insider

147

Chapitre 12 Exploiter un fichier SQL

148 Manuel de rfrence de 4D Insider

Personnaliser 4D Insider

4D Insider et 4D Customizer Plus


Vous pouvez personnaliser plusieurs aspects de lapplication 4D Insider
laide de lutilitaire 4D Customizer Plus :

la langue des routines,

le Script manager,

la coloration des mthodes,

les polices utilises par 4D Insider,

la ressource Conversions,

Note 4D Customizer Plus existe en version MacOS et Windows. Ce


programme est fourni avec 4e Dimension et 4D Server.
Pour accder ces ressources, ouvrez lapplication 4D Insider avec
4D Customizer Plus.
La bote de dialogue Slecteur de 4D Customizer Plus apparat :

Pour accder la fentre de personnalisation dune ressource, doublecliquez sur son icne.
Manuel de rfrence de 4D Insider

149

Annexe A Personnaliser 4D Insider

Trois ressources ont un fonctionnement identique celles de 4D :

Traduction, qui vous permet de choisir la langue utilise pour laffichage des commandes 4D par 4D Insider,

Mthodes, qui vous permet de dfinir votre choix de couleurs pour


laffichage des mthodes dans la zone daffichage de 4D Insider,

Conversions (ressource non cre par dfaut), qui vous permet dadapter les tables internes de conversion ASCII des systmes particuliers.
Gnralement, vous navez pas besoin dutiliser cette ressource.
Pour ces ressources, reportez-vous la documentation 4D Customizer
Plus (Acrobat), fournie avec 4e Dimension. Les ressources Script Manager
et Polices sont dcrites ci-dessous.

Script Manager

Le Script Manager est la partie du systme qui gre lcriture des


langues caractres non romains (japonais, arabe...). Si vous utilisez
4D Insider sous Script Manager, vous pouvez avoir besoin de modifier
certains paramtres prsents dans cette fentre.

Editeur de mthodes : si laffichage des mthodes est rendu impossible


par lutilisation dun systme particulier, slectionnez loption Editeur
sans style. Les styles (gras, italiques, indentations, couleurs...) ne sont
plus affichs lorsque vous ditez une mthode.

Impression des mthodes : si limpression des mthodes est rendue


impossible par lutilisation dun systme particulier, slectionnez
loption Impression sans style.

Comparaisons : ce menu droulant propose divers choix pour vos tris


et recherches :

4e Dimension : utilise la ressource TRIC ou, dfaut, la ressource


TRI#.

Systme : utilise les routines de comparaison et de mise en majuscules de la ROM (ignore la ressource TRIC).

150 Manuel de rfrence de 4D Insider

4D Insider et 4D Customizer Plus

Polices

Mixte : utilise la ressource TRIC pour les comparaisons de chanes


uniquement ; la table des majuscules est gre par le systme.

Allemand : mthode de comparaison utilise en allemand avec des


dispositions spciales pour le caractre .

Turc : mthode de comparaison utilise en turc.

Ressources TRIC : par dfaut, la ressource TRIC est prsente. Les tris
sont donc bass sur une table propose par 4D Insider (e, , ,
, sont tris sparment ; en revanche, la recherche de trouvera e). Cette table diffre selon les langues (caractres spciaux...).
Lorsque la ressource TRIC est supprime, 4D Insider reconstruit cette
table au lancement suivant.
La bote de dialogue de la ressource Polices comporte quatre pop up
menus vous permettant de choisir, pour linterface de 4D Insider, des
polices diffrentes de celles proposes par dfaut.
Outre son aspect esthtique, cette fonctionnalit est apprciable dans
les pays alphabet non roman, pour la prsentation de lapplication
elle-mme.
Windows

MacOS

Application

Le premier pop up menu dfinit la police de lapplication, cest--dire


celle qui sera utilise dans les zones de dfilement de la fentre
principale, de lditeur de filtres et dobjets dlimiteurs ainsi que dans
celles des botes de dialogue Texte vers STR# et Rechercher. Le contenu
de la fentre de documentation saffichera galement dans cette police.
Manuel de rfrence de 4D Insider

151

Annexe A Personnaliser 4D Insider

Pop up menus

Le second pop up menu dfinit la police des menus de 4D Insider, soit :

les listes dobjets de la fentre principale,

les menus de la liste des questions,

les menus de la bote de dialogue de recherche.

Impression

Le troisime pop up menu concerne limpression. La police choisie sera


utilise dans diffrents styles pour prsenter clairement les documents
imprims.

Liste des questions

Le quatrime pop up menu dfinit la police utilise dans la liste des


questions lies aux dplacements dobjets.

152 Manuel de rfrence de 4D Insider

Raccourcis-clavier

Le tableau ci-dessous dresse la liste des fonctions de 4D Insider


accessibles par raccourci-clavier :
Pour :

Listes de la
fentre
principale

Raccourci clavier :
Sous Windows

Sous MacOS

Activer la liste suivante


dans la fentre principale

Tabulation

Tabulation

Activer la liste prcdente


dans la fentre principale

Majuscule +
Tabulation

Majuscule +
Tabulation

Dplacer la liste Cible vers


Ctrl- ou Ctrl-
la liste Base

Commande- ou
Commande-

Dplacer la liste
Source vers la liste Base

Commande-
ou Commande-

Ctrl- ou Ctrl-

Ouvrir une fentre centre


Alt-Clic sur lobjet
sur lobjet slectionn

Option-Clic sur lobjet

Ouvrir une fentre centre Clic avec le Bouton


sur le parent de lobjet
droit de la souris sur
slectionn
lobjet

Contrle-Clic sur
lobjet

Effectuer une slection


continue des objets

Majuscule-Clic sur les Majuscule-Clic sur les


objets dune liste
objets dune liste

Effectuer une slection


discontinue des objets

Ctrl-Clic sur les objets Commande-Clic sur


dune liste
les objets dune liste

Rduire la liste aux objets


slectionns

Clic avec le Bouton


Contrle-Clic dans le
droit de la souris dans
titre dune liste
le titre dune liste

Appliquer des filtres


successifs la slection

Alt + slection
successive de filtres

Option + slection
successive de filtres

Exclure un type dobjet de Alt-Maj + slection


la liste (anti-filtre)
dun filtre

Option-Maj +
slection dun filtre

Manuel de rfrence de 4D Insider

153

Annexe B Raccourcis-clavier

Pour :

Sous Windows

Sous MacOS

Double-clic sur une


commande de menu

Double-clic sur une


commande de menu

Alt-Clic sur une


commande de menu

Option-Clic sur une


commande de menu

Accder directement aux


paramtrages dun filtre
existant, dans la bote de
dialogue ddition des
filtres

Double-Clic sur le
nom dun filtre

Double-Clic sur le
nom dun filtre

Cocher tous les objets de


la colonne

Clic dans le titre de la Clic dans le titre de la


colonne
colonne

Dcocher tous les objets


de la colonne

Alt-Clic dans le titre


de la colonne

Option-Clic dans le
titre de la colonne

Bouton droit de la
souris pour le
dplacement de
lobjet

Contrle +
dplacement de
lobjet

Afficher la mthode
associe la
commande de menu

Zone
graphique de
Afficher la mthode
la fentre
associe la commande
principale
de menu dans une
nouvelle fentre

Bote de
dialogue
de filtres/de
recherche

Raccourci clavier :

Afficher une liste dtaille


des questions souleves
Dplacement par le dplacement
dobjets
Dplacer un objet avec
toutes ses dpendances
(ses objets cibles)

154 Manuel de rfrence de 4D Insider

Option +
Alt + dplacement de
dplacement de
lobjet
lobjet

Index
Symboles/Chiffres
.4CP (extension composant Windows) . . . . . . . 135
.4DB (extension Structure Windows) . . . . . . . 20, 24
.4IL (extension librairie Windows) . . . . . . . . . 20, 24
.Export (format de fichier dexport) . . . . . . . . . . 104
.LIB (extension librairie Windows) . . . . . . . . . 20, 24
.rex (extension de fichiers Windows) . . . . . . . . . . 27
.tes (extension de fichiers Windows) . . . . . . . 26, 27
.tex (extension de fichiers Windows) . . . . . . . . . . 26
.TXT (format de fichier dexport) . . . . . . . . . . . . 104
@ (recherche) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
(symbole dobjet dlimiteur) . . . . . . . . . . . . . . 121
4D (dossier) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
4D Customizer Plus . . . . . . . . . . . . . . . . . . . . . . . 149
Conversions . . . . . . . . . . . . . . . . . 150
Mthodes . . . . . . . . . . . . . . . . . . . 150
Polices . . . . . . . . . . . . . . . . . . . . . 151
Script Manager . . . . . . . . . . . . . . . . 150
Traduction . . . . . . . . . . . . . . . . . . 150
4D Insider
Liste des raccourcis-clavier . . . . . . . . . . 153
Mise en route . . . . . . . . . . . . . . . . . . 15
Personnaliser . . . . . . . . . . . . . . . . . 149
4D Server
Connexion . . . . . . . . . . . . . . . . . . 26
Ouvrir une base . . . . . . . . . . . . . . . . . 26
4D Transporter . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
4D XREF 2.0 (format dexport) . . . . . . . . . . . . . . 104

A
Acrobat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Affichage des commandes de menus . . . . . . . . . . 41
Affichage dtaill des questions . . . . . . . . . . . . . 112
Afficher la mthode associe une commande de
menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Afficher le dialogue douverture de documents (prfrences gnrales) . . . . . . . . . . . . . . . . . . . 18
Ajouter le champ la table . . . . . . . . . . . . . . . . . 117
Ajouter un objet un groupe . . . . . . . . . . . . . . . . 55
Ajouter un prfixe... . . . . . . . . . . . . . . . . . . . . . . . 87
Aligner les fentres . . . . . . . . . . . . . . . . . . . . . . . . 52
Analyse (signal de modification de la base) . . . . . 27
Anti-filtres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Appliquer un filtre . . . . . . . . . . . . . . . . . . . . . . . . . 68
une sous-slection dobjets . . . . . . . . . . 68
Anti-filtres . . . . . . . . . . . . . . . . . . . . 69
Attributs des composants . . . . . . . . . . . . . . . . . . 126

B
Barres de menus . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Mode daffichage . . . . . . . . . . . . . . . . 36
Objets de type . . . . . . . . . . . . . . . . . . 36
Base (liste) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Bases
Crer . . . . . . . . . . . . . . . . . . . . 20, 21
Documentation gnrale . . . . . . . . . . . . 64
Fermer . . . . . . . . . . . . . . . . . . . . . . 28
Ouvrir . . . . . . . . . . . . . . . . . . . . . . 23
Sauvegarder . . . . . . . . . . . . . . . . . . . 22
Bibliothque dimages
Composant . . . . . . . . . . . . . . . . . . 141
Filtre . . . . . . . . . . . . . . . . . . . . . . . 36
Boutons (Traduire) . . . . . . . . . . . . . . . . . . . . . . . . . 92
Bulles daide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

C
Case tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Chane (Remplacer) . . . . . . . . . . . . . . . . . . . . . . . . 81
Champ (objets de type) . . . . . . . . . . . . . . . . . . . . . 37
Champs
Affichage . . . . . . . . . . . . . . . . . . . . 31
Objets de type . . . . . . . . . . . . . . . . . . 37
Champs et sous-tables . . . . . . . . . . . . . . . . . . . . . . 37
Chercher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Choisir une table pour cet objet . . . . . . . . . . . . . 117
Cible (liste) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Commandes 4D
Objets de type . . . . . . . . . . . . . . . . . . 37
Remplacer . . . . . . . . . . . . . . . . . . . . 84
Commandes de menus
Afficher la mthode associe . . . . . . . . . . 41
Modes daffichage . . . . . . . . . . . . . . . . 41
Traduire . . . . . . . . . . . . . . . . . . . . . 90
Commentaires des composants . . . . . . . . . . . . . . 134

Manuel de rfrence de 4D Insider

155

Index
Compatibilit
Ouverture en local . . . . . . . . . . . . . . . .25
Sur 4D Server . . . . . . . . . . . . . . . . . .27
COMPILER (mthode) . . . . . . . . . . . . . . . . . . . . .140
Composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125
Attributs . . . . . . . . . . . . . . . . . . . . 126
Attributs des objets dplacs . . . . . . . . . 134
Caractristiques . . . . . . . . . . . . . . . . 125
Commentaires (Proprits) . . . . . . . . . . 134
Conflits dinstallation . . . . . . . . . . . . . 136
Conseils de dveloppement . . . . . . . . . . 139
Contraintes . . . . . . . . . . . . . . . . . . 139
Cration . . . . . . . . . . . . . . . . . . . . 130
Cration (principes) . . . . . . . . . . . . . . 126
Date (Proprits) . . . . . . . . . . . . . . . . 133
Dfinition . . . . . . . . . . . . . . . . . . . 125
Dsinstaller . . . . . . . . . . . . . . . . . . 138
Dveloppement . . . . . . . . . . . . . . . . 129
Gnrer le fichier . . . . . . . . . . . . . . . 135
Images de la bibliothque . . . . . . . . . . . 141
Installation (principes) . . . . . . . . . . . . 126
Installer . . . . . . . . . . . . . . . . . . . . 135
Mettre jour . . . . . . . . . . . . . . . . . . 135
Nom (Proprits) . . . . . . . . . . . . . . . 133
Nom de version (Proprits) . . . . . . . . . 133
Noms des objets . . . . . . . . . . . . . . . . 139
Numro de version (Proprits) . . . . . . . . 133
Numros de PICT . . . . . . . . . . . . . . . 140
Numros de STR# . . . . . . . . . . . . . . . 140
Objets de type . . . . . . . . . . . . . . . . . .37
Objets grs . . . . . . . . . . . . . . . . . . 129
Oprations . . . . . . . . . . . . . . . . . . . 134
Prfixe(Proprits) . . . . . . . . . . . . . . . 133
Prsentation . . . . . . . . . . . . . . . . . . 125
priv (attribut) . . . . . . . . . . . . . . . . . 127
Proprits . . . . . . . . . . . . . . . . . . . 132
Protection . . . . . . . . . . . . . . . . . . . 142
protg (attribut) . . . . . . . . . . . . . . . 127
public (attribut) . . . . . . . . . . . . . . . . 127
Table dinterface . . . . . . . . . . . . . . . . 137
Visualisation et utilisation . . . . . . . . . . 128
Confirmer la fermeture dune base (prfrences gnrales) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Conflits dinstallation (Composants) . . . . . . . . . .137
Conflits de noms . . . . . . . . . . . . . . . . . . . . . . . . .137
Conflits de noms (Composants) . . . . . . . . . . . . .139
Connexion au serveur . . . . . . . . . . . . . . . . . . . . . .26
Constante (objets de type) . . . . . . . . . . . . . . . . . . .37

156 Manuel de rfrence de 4D Insider

Contenu
Recherche . . . . . . . . . . . . . . . . . . . 74
Remplacer dans le . . . . . . . . . . . . . . . 84
Conventions dcriture . . . . . . . . . . . . . . . . . . . . . 11
Conversion de bases 4D . . . . . . . . . . . . . . . . . . . . 25
Conversions (4D Customizer Plus) . . . . . . . . . . . 150
Copier et attribuer un nouveau numro . . . . . . 117
Copier et renommer . . . . . . . . . . . . . . . . . . . . . . 115
Copier lobjet . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Copier-coller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Couleurs daffichage des mthodes . . . . . . . . . . 150
CREATE INDEX (SQL) . . . . . . . . . . . . . . . . . . . . . 144
CREATE TABLE (SQL) . . . . . . . . . . . . . . . . . . . . . 144
Crer
base partir dun fichier Texte SQL . . . . . . 146
composant ( partir de la slection courante dobjets) . . . . . . . . . . . . . . . . . . . 131
composant (vide) . . . . . . . . . . . . . . . 130
documentation . . . . . . . . . . . . . . . . 62
documentation gnrale . . . . . . . . . . . 64
filtre personnalis . . . . . . . . . . . . . . . 71
groupe . . . . . . . . . . . . . . . . . . . . . 54
librairie . . . . . . . . . . . . . . . . . . . . . 21
objets dlimiteurs . . . . . . . . . . . . . . . 121
sous-slection . . . . . . . . . . . . . . . . . 46
Crer daprs la slection (composant) . . . . . . . 132
Crer un autre menu . . . . . . . . . . . . . . . . . . . . . 117
Crer une base ou une librairie . . . . . . . . . . . . . . . 20
Crer/Modifier un groupe . . . . . . . . . . . . . . . . . . . 54
Curseur de dplacement . . . . . . . . . . . . . . . . . . . 110

D
Date (Composants) . . . . . . . . . . . . . . . . . . . . . . . 133
Dgrouper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Dlimiteurs, voir aussi Objets dlimiteurs . 120, 122
Dplacement dobjets . . . . . . . . . . . . . . . . . . . . . 109
Affichage dtaill des questions . . . . . . . . 112
Composants . . . . . . . . . . . . . . . . . . 134
Curseur de . . . . . . . . . . . . . . . . . . . 110
Enregistrer les questions . . . . . . . . . . . . 114
Excution . . . . . . . . . . . . . . . . . . . 111
Objets dlimiteurs . . . . . . . . . . . . . . . 120
Objets dplaables . . . . . . . . . . . . . . . 109
Objets indissociables . . . . . . . . . . . . . 110
Options . . . . . . . . . . . . . . . . . . . . 112
Prfrences . . . . . . . . . . . . . . . . . . . 118
Principes . . . . . . . . . . . . . . . . . . . . 111
Questions . . . . . . . . . . . . . . . . . . . 113

Index
rapide (avec toutes les dpendances) . . . . . 113
Rpondre aux questions . . . . . . . . . . . 113
Rponses (voir aussi Rponses) . . . . . . . . 115
Types de dplacements . . . . . . . . . . . . 111
Dplacement rapide (avec toutes les dpendances) .
113
Dernire modification . . . . . . . . . . . . . . . . . . . . . . 63
Description des rponses . . . . . . . . . . . . . . . . . . . 115
Dslectionner un objet . . . . . . . . . . . . . . . . . . . . 46
Dsinstaller un composant . . . . . . . . . . . . . . . . . 138
Disposition des zones (modifier) . . . . . . . . . . . . . 50
Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Crer . . . . . . . . . . . . . . . . . . . . . . 62
Exporter . . . . . . . . . . . . . . . . . . . . 104
gnrale . . . . . . . . . . . . . . . . . . . . . 64
Imprimer . . . . . . . . . . . . . . . . . . . 102
Imprimer (voir aussi Impression) . . . . . . . . 66
Menu . . . . . . . . . . . . . . . . . . . . 63, 65
multi-utilisateurs . . . . . . . . . . . . . . . . 66
Objets pouvant tre documents . . . . . . . . 61
Sauvegarde . . . . . . . . . . . . . . . . . . . 63
Supprimer . . . . . . . . . . . . . . . . . . . . 65
Visualisation . . . . . . . . . . . . . . . . . . 65
Documenter lobjet . . . . . . . . . . . . . . . . . . . . . . . . 62
Dossier 4D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

E
Empiler les fentres . . . . . . . . . . . . . . . . . . . . . . . . 52
En local (Ouvrir) . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Enlever
composant . . . . . . . . . . . . . . . . . . 138
objets des groupes . . . . . . . . . . . . . . . 56
Ensemble (objets de type) . . . . . . . . . . . . . . . . . . . 37
Enumration (objets de type) . . . . . . . . . . . . . . . . 37
Equivalents clavier . . . . . . . . . . . . . . . . . . . . . . . 153
Remplacer listes . . . . . . . . . . . . . . . . . 48
Exporter
contenu . . . . . . . . . . . . . . . . . . . . 104
documentation . . . . . . . . . . . . . . . . 104
Format 4D XREF 2.0 . . . . . . . . . . . . . 104
objets . . . . . . . . . . . . . . . . . . . . . 102
objets cibles . . . . . . . . . . . . . . . . . . 104
objets sources . . . . . . . . . . . . . . . . . 104

F
Fentre de 4D Insider
Manipuler les listes . . . . . . . . . . . . . . . 44
Menus . . . . . . . . . . . . . . . . . . . . . . 44
Slectionner . . . . . . . . . . . . . . . . . . . 30
Fentre de bienvenue . . . . . . . . . . . . . . . . . . . . . . 16
Fentres
Aligner . . . . . . . . . . . . . . . . . . . . . 52
Disposition des zones . . . . . . . . . . . . . . 50
Empiler . . . . . . . . . . . . . . . . . . . . . 52
Fermer . . . . . . . . . . . . . . . . . . . . . . 28
Numros . . . . . . . . . . . . . . . . . . . . 49
Ouvrir sur un objet slectionn . . . . . . . . 35
Prfrences gnrales . . . . . . . . . . . . . . 18
Redimensionner les zones . . . . . . . . . . . 49
Fentres (menu) . . . . . . . . . . . . . . . . . . . . . . . . 50, 52
Fermer
base ou librairie . . . . . . . . . . . . . . . . . 28
fentres . . . . . . . . . . . . . . . . . . . . . 28
Prfrences gnrales . . . . . . . . . . . . . . 19
Feuille de style (objets de type) . . . . . . . . . . . . . . . 38
Fichier de composant . . . . . . . . . . . . . . . . . . . . . 135
Fichiers prfrs . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Fichiers rcents . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Fichiers SQL
Conversion des types de champs . . . . . . . 144
Cration de bases partir de . . . . . . . . . 143
Crer une base partir de . . . . . . . . . . . 146
Options interprtes par 4D Insider . . . . . 144
Verbes interprts par 4D Insider . . . . . . . 144
Filtres
Anti-filtres . . . . . . . . . . . . . . . . . . . . 69
Appliquer . . . . . . . . . . . . . . . . . . . . 68
Construire . . . . . . . . . . . . . . . . . . . . 73
Crer . . . . . . . . . . . . . . . . . . . . . . 71
Dfinition des critres . . . . . . . . . . . . . 73
Groupes & Composants . . . . . . . . . . . 128
Groupes & composants . . . . . . . . . . . . 134
Menu caractristique . . . . . . . . . . . . . . 73
Modes de recherche . . . . . . . . . . . . . . . 74
Modifier . . . . . . . . . . . . . . . . . . . . . 71
Modifier le contenu des pop ups . . . . . . . . 69
Nom . . . . . . . . . . . . . . . . . . . . . . . 71
personnaliss . . . . . . . . . . . . . . . . . . 71
Prfrences . . . . . . . . . . . . . . . . . 69, 71
Prsentation . . . . . . . . . . . . . . . . . . . 67
Renommer . . . . . . . . . . . . . . . . . . . 72
Supprimer . . . . . . . . . . . . . . . . . . . . 72

Manuel de rfrence de 4D Insider

157

Index
FOREIGN KEY (SQL) . . . . . . . . . . . . . . . . . . . . . . .144
Formats/Filtres (objets de type) . . . . . . . . . . . . . . .38
Formulaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38
Macintosh vers Windows (133%) . . . . . . . 108
Mode daffichage . . . . . . . . . . . . . . . .38
Navigation (multi-pages) . . . . . . . . . . . .39
Options de redimensionnement . . . . . . . 108
Redimensionner (dans 4D Insider) . . . . . . 106
Redimensionner (dans 4D) . . . . . . . . . . 105
Redimensionner les images . . . . . . . . . . 108
Taux manuel . . . . . . . . . . . . . . . . . 108
Windows vers Macintosh (75%) . . . . . . . 108

documentation . . . . . . . . . . . . . . . . 66
objets . . . . . . . . . . . . . . . . . . . . . 101
Police dimpression . . . . . . . . . . . . . . 152
Info-bulles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Installer des composants . . . . . . . . . . . . . . 126, 135

Hypertexte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10

Langue des commandes 4D (traduction) . . . . . . 150


Largeur/Hauteur (prfrences gnrales) . . . . . . . 18
Librairies
Crer . . . . . . . . . . . . . . . . . . . . 20, 21
Dfinition . . . . . . . . . . . . . . . . . . . 20
Documentation gnrale . . . . . . . . . . . 64
Fermer . . . . . . . . . . . . . . . . . . . . . 28
Ouvrir . . . . . . . . . . . . . . . . . . . . . 23
Sauvegarder . . . . . . . . . . . . . . . . . . 22
Lire ID ressource composant (commande 4D) . . 140
LIRE INFORMATIONS SERIALISATION (commande
4D) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
LIRE RESSOURCE IMAGE (commande 4D) . . . . 141
Liste Base (dfinition) . . . . . . . . . . . . . . . . . . . . . . 14
Liste des questions (Police) . . . . . . . . . . . . . . . . . 152
Listes
Activation des menus . . . . . . . . . . . . . 44
Affichage par dfaut . . . . . . . . . . . . . . 18
Equivalents clavier . . . . . . . . . . . . . . . 48
Interactions . . . . . . . . . . . . . . . . . . 33
Manipuler . . . . . . . . . . . . . . . . . . . 44
Mode d'affichage . . . . . . . . . . . . . . . 50
Redimensionner . . . . . . . . . . . . . . . . 49
Remplacer . . . . . . . . . . . . . . . . . . . 48
Slectionner . . . . . . . . . . . . . . . . 30, 45
Listes (prfrences gnrales) . . . . . . . . . . . . . . . . 18

Ignorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116
Images
Objets de type . . . . . . . . . . . . . . . . . .36
Redimensionner (formulaires) . . . . . . . . 108
Images de la bibliothque
Utilisation avec les composants . . . . . . . . 141
Imprimer
avec sa documentation . . . . . . . . . . . . 102
avec ses objets cibles . . . . . . . . . . . . . 102
avec ses objets sources . . . . . . . . . . . . . 102
avec son contenu . . . . . . . . . . . . . . . 102

Mac4DX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Macintosh vers Windows (formulaires) . . . . . . . 108
Manuel
Acrobat . . . . . . . . . . . . . . . . . . . . 10
Contenu . . . . . . . . . . . . . . . . . . . . . 9
Conventions . . . . . . . . . . . . . . . . . . 11
Navigation hypertexte . . . . . . . . . . . . . 10
Organisation . . . . . . . . . . . . . . . . . . 10
Mmoire alloue . . . . . . . . . . . . . . . . . . . . . . . . . . 16

G
Gnrales (Prfrences) . . . . . . . . . . . . . . . . . . . . .17
Groupe
Objets de type . . . . . . . . . . . . . . . . . .40
Groupes
Ajout dobjets . . . . . . . . . . . . . . . . . .55
Crer partir dune slection . . . . . . . . . .57
Crer avec les dpendances . . . . . . . . . . .58
Crer, modifier . . . . . . . . . . . . . . . . .54
Dfinition . . . . . . . . . . . . . . . . . . . .53
Dgrouper (supprimer) . . . . . . . . . . . . .58
Oprations . . . . . . . . . . . . . . . . . . . .54
Ouvrir . . . . . . . . . . . . . . . . . . . . . .56
Regrouper avec leurs dpendances... . . . . . .58
Regrouper les objets... . . . . . . . . . . . . . .57
Supprimer . . . . . . . . . . . . . . . . . . . .58
Groupes & composants (filtre) . . . . . . . . . . . . . . .134

158 Manuel de rfrence de 4D Insider

Index
Menu (objets de type) . . . . . . . . . . . . . . . . . . . . . . 40
Afficher la mthode associe . . . . . . . . . . 41
Traduire . . . . . . . . . . . . . . . . . . . . . 90
Menu Documentation . . . . . . . . . . . . . . . . . . . 63, 65
Menu STR# . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Message daide (objets de type) . . . . . . . . . . . . . . . 41
Mthode COMPILER (composants) . . . . . . . . . . 140
Mthodes
Couleurs . . . . . . . . . . . . . . . . . . . 150
Objets de type . . . . . . . . . . . . . . . . . 42
Mettre jour . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
composants . . . . . . . . . . . . . . . . . . 135
Mettre le groupe jour . . . . . . . . . . . . . . . . . . . . 118
Mise en route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Mode daffichage des barres de menus . . . . . . . . . 36
Mode daffichage des formulaires . . . . . . . . . . . . . 38
Modifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
contenu des pop ups des filtres . . . . . . . . . 69
dimensions des zones . . . . . . . . . . . . . 49
documentation . . . . . . . . . . . . . . . . . 62
documentation gnrale . . . . . . . . . . . . 64
filtre personnalis . . . . . . . . . . . . . . . . 71
STR# . . . . . . . . . . . . . . . . . . . . . . . 98
Montrer la fentre de prsentation (prfrences gnrales) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Montrer les n dID dans la liste Base (prfrences gnrales) . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Mots de passe . . . . . . . . . . . . . . . . . . . . . . . . . 25, 26

N
Navigation dans 4D Insider . . . . . . . . . . . . . . . . . 29
Navigation dans un formulaire multi-page . . . . . 39
Ne pas copier . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Nom de version (Composant) . . . . . . . . . . . . . . . 133
Nom du composant . . . . . . . . . . . . . . . . . . . . . . 133
NOT NULL (SQL) . . . . . . . . . . . . . . . . . . . . . . . . 144
Nouveau composant . . . . . . . . . . . . . . . . . . . . . . 130
Nouveau groupe... . . . . . . . . . . . . . . . . . . . . . . . . . 54
Nouvelle base . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Nouvelle librairie . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Numro de version (Composant) . . . . . . . . . . . . 133
Numros des fentres . . . . . . . . . . . . . . . . . . . . . . 49

O
Objets
Ajouter un groupe . . . . . . . . . . . . . . 55
Barres de menus . . . . . . . . . . . . . . . . 36

Champs . . . . . . . . . . . . . . . .
Cible vers Base . . . . . . . . . . . .
Commandes 4D . . . . . . . . . . . .
Composants . . . . . . . . . . . . . .
Constantes . . . . . . . . . . . . . .
Copie, voir Dplacement dobjets . .
Date de modification . . . . . . . . .
dclars . . . . . . . . . . . . . . . .
dlimiteurs . . . . . . . . . . . . . .
dplaables . . . . . . . . . . . . . .
Dplacement . . . . . . . . . . . . .
Dslectionner . . . . . . . . . . . .
documents . . . . . . . . . . . . . .
en rouge . . . . . . . . . . . . . . . .
Enlever dun groupe . . . . . . . . .
Ensembles . . . . . . . . . . . . . . .
Enumrations . . . . . . . . . . . . .
estims non utiliss . . . . . . . . . .
Exporter . . . . . . . . . . . . . . . .
Feuilles de style . . . . . . . . . . . .
Formats/Filtres . . . . . . . . . . . .
Formats/filtres . . . . . . . . . . . .
Formulaires . . . . . . . . . . . . . .
Groupes . . . . . . . . . . . . . . . .
Imprimer . . . . . . . . . . . . . . .
indissociables lors dun dplacement
Interaction entre les listes . . . . . .
inutiliss . . . . . . . . . . . . . . .
Menus . . . . . . . . . . . . . . . . .
Messages d'aide . . . . . . . . . . . .
Mthodes et triggers . . . . . . . . .
Noms (Composants) . . . . . . . . .
non reconnus . . . . . . . . . . . . .
physiques . . . . . . . . . . . . . . .
Plug ins . . . . . . . . . . . . . . . .
Regrouper . . . . . . . . . . . . . . .
Regrouper avec leurs dpendances . .
Renommer . . . . . . . . . . . . . .
Routines externes . . . . . . . . . . .
Slectionner (plusieurs) . . . . . . . .
Slectionner (unique) . . . . . . . . .
Slections . . . . . . . . . . . . . . .
Smaphores . . . . . . . . . . . . . .
Source vers Base . . . . . . . . . . . .
Sous-tables . . . . . . . . . . . . . .
STR# . . . . . . . . . . . . . . . . . .
Tables . . . . . . . . . . . . . . . . .
Types identifis . . . . . . . . . . . .
Variables . . . . . . . . . . . . . . .

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

. . . 37
. . . 48
. . . 37
37, 129
. . . 37
. . 109
. . . 63
. . 109
63, 120
. . 109
. . 109
. . . 46
. . . 61
. . . 32
. . . 56
. . . 37
. . . 37
. . . 32
. . 102
. . . 38
. . . 38
. . . 38
. . . 38
. . . 40
. . 101
. . 110
. . . 33
. . . 32
. . . 40
. . . 41
. . . 42
. . 139
. . . 32
. . 109
. . . 42
. . . 57
. . . 58
. . . 79
. . . 42
. . . 46
. . . 45
. . . 43
. . . 43
. . . 48
. . . 37
. . . 43
. . . 43
. . . 30
. . . 44

Manuel de rfrence de 4D Insider

159

Index
Visualiser . . . . . . . . . . . . . . . . . . . .29
Visualiser lobjet parent . . . . . . . . . . . . .34
Visualiser le contenu . . . . . . . . . . . . . .35
Zone daffichage . . . . . . . . . . . . . . . . .30
Objets cibles (dfinition) . . . . . . . . . . . . . . . . . . . .14
Objets de 4e Dimension (dfinition) . . . . . . . . . . .13
Objets dlimiteurs
Crer par objet . . . . . . . . . . . . . . . . . 122
Crer par type dobjet . . . . . . . . . . . . . 122
Dfinir . . . . . . . . . . . . . . . . . . . . . 121
Dfinition . . . . . . . . . . . . . . . . . . . 120
Documentation . . . . . . . . . . . . . . 63, 122
Identification . . . . . . . . . . . . . . . . . 121
Option de la fentre de documentation . . . 123
Prfrences . . . . . . . . . . . . . . . . . . . 122
Prsentation . . . . . . . . . . . . . . . . . . 120
Objets identifis . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Objets privs
Prfixe . . . . . . . . . . . . . . . . . . . . . 133
Objets publics modifis . . . . . . . . . . . . . . . .136, 137
Objets sources (dfinition) . . . . . . . . . . . . . . . . . . .14
Oprations sur les composants . . . . . . . . . . . . . .134
Oprations sur les objets groups . . . . . . . . . .54, 134
Option Objet dlimiteur . . . . . . . . . . . . . . . . . . .123
Organisation de lcran . . . . . . . . . . . . . . . . . . . . .49
Organiser les diffrentes fentres ouvertes . . . . . .52
Ouverture dune base ou dune librairie . . . . . . . .20
Ouvrir
fentre centre sur un objet slectionn . . . .49
Fichiers rcents (Windows) . . . . . . . . . . .25
Ouvrir fichier SQL... . . . . . . . . . . . . . . . . . . . . . . .146
Ouvrir une base ou une librairie . . . . . . . . . . . . . .23
en local . . . . . . . . . . . . . . . . . . . . .24
Fichiers rcents . . . . . . . . . . . . . . . . .25
sur 4D Server . . . . . . . . . . . . . . . . . .26

P
Parent (Visualiser) . . . . . . . . . . . . . . . . . . . . . . . . .34
Partout (renommer) . . . . . . . . . . . . . . . . . . . . . . . .80
Personnaliser 4D Insider . . . . . . . . . . . . . . . . . . .149
PICT (Composants) . . . . . . . . . . . . . . . . . . . . . . .140
Plug-ins
Fichiers . . . . . . . . . . . . . . . . . . . . .26
Objets de type . . . . . . . . . . . . . . . . . .42
Polices de 4D Insider (modification) . . . . . . . . . .151
Prface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

160 Manuel de rfrence de 4D Insider

Prfrences
dplacement . . . . . . . . . . . . . . . . . . 118
dplacement (Enregistrer) . . . . . . . . . . . 119
gnrales . . . . . . . . . . . . . . . . . . . . 17
Objets dlimiteurs . . . . . . . . . . . . . . . 122
Prfrences de filtres . . . . . . . . . . . . . . . . . . . . . . . 71
Prfrences gnrales
Afficher le dialogue douverture de documents 18
Au dmarrage . . . . . . . . . . . . . . . . . 18
Confirmer la fermeture dune base . . . . . . 19
Fentres . . . . . . . . . . . . . . . . . . . . 18
Largeur/Hauteur . . . . . . . . . . . . . . . . 18
Listes . . . . . . . . . . . . . . . . . . . . . . 18
Modifier . . . . . . . . . . . . . . . . . . . . 17
Montrer la fentre de prsentation . . . . . . 18
Montrer les n dID dans la liste Base . . . . . 19
Prfixe (Composant) . . . . . . . . . . . . . . . . . . . . . . 133
Prfixer
slection . . . . . . . . . . . . . . . . . . . . 86
variables . . . . . . . . . . . . . . . . . . . . 86
PRIMARY KEY (SQL) . . . . . . . . . . . . . . . . . . . . . . 144
Priv (dossier de composant) . . . . . . . . . . . . . . . 127
Proprits des composants . . . . . . . . . . . . . . . . . 132
Protg (dossier de composant) . . . . . . . . . . . . . 127
Protger les composants . . . . . . . . . . . . . . . . . . . 142
Public (dossier de composant) . . . . . . . . . . . . . . 127

Q
Questions (dplacement dobjets) . . . . . . . . . . . 113
Enregistrer... . . . . . . . . . . . . . . . . . . 114

R
Raccourcis-clavier . . . . . . . . . . . . . . . . . . . . . . . . 153
Rechercher dans la slection . . . . . . . . . . . . . . . . 74
Rechercher dans le contenu . . . . . . . . . . . . . . . . . 74
Recherches
Composants . . . . . . . . . . . . . . . . . . 134
Construire . . . . . . . . . . . . . . . . . . . 73
dans la base, la slection . . . . . . . . . . . 74
dans le contenu . . . . . . . . . . . . . . . . 74
Dfinition des critres . . . . . . . . . . . . . 73
Dlimiteurs . . . . . . . . . . . . . . . . . . 75
Documents . . . . . . . . . . . . . . . . . . 75
Excuter . . . . . . . . . . . . . . . . . . . . 72
Exemples . . . . . . . . . . . . . . . . . . . . 75
Formule de . . . . . . . . . . . . . . . . . . . 73
Inutiliss . . . . . . . . . . . . . . . . . . . . 75

Index
Menu caractristique . . . . . . . . . . . . . . 73
par date . . . . . . . . . . . . . . . . . . . . . 74
par nom . . . . . . . . . . . . . . . . . . . . . 74
par nombre doccurrences . . . . . . . . . . . 74
Personnaliser les ressources . . . . . . . . . . 150
Police de lditeur . . . . . . . . . . . . . . . 151
Prsentation . . . . . . . . . . . . . . . . . . 67
Redimensionnement de formulaire . . . . . . . . . . 105
Options . . . . . . . . . . . . . . . . . . . . 108
Rduire la liste aux objets slectionns . . . . . . . . . 46
Refaire lanalyse . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
REFERENCES (SQL) . . . . . . . . . . . . . . . . . . . . . . . 144
Rfrences croises
Dfinition . . . . . . . . . . . . . . . . . . . . 13
Visualiser . . . . . . . . . . . . . . . . . . . . 29
Regrouper avec les dpendances . . . . . . . . . . . . . . 58
Regrouper une slection . . . . . . . . . . . . . . . . . . . . 57
Relier la table (composants) . . . . . . . . . . . . . . . . 138
Remplacer . . . . . . . . . . . . . . . . . . . . . . . . . . . 78, 115
Ajouter un prfixe... . . . . . . . . . . . . . . 87
commande (mthode vierge) . . . . . . . . . . 86
Crer et remplacer (mthode) . . . . . . . . . 86
dans le contenu . . . . . . . . . . . . . . . . . 84
dans une slection . . . . . . . . . . . . . . . 81
les commandes . . . . . . . . . . . . . . . . . 84
liste principale par liste secondaire . . . . . . . 48
Prfixer une slection . . . . . . . . . . . . . . 86
Remplacer une variable . . . . . . . . . . . . . 79
Renommer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79, 81
composant . . . . . . . . . . . . . . . . . . 133
filtres . . . . . . . . . . . . . . . . . . . . . . 72
objet . . . . . . . . . . . . . . . . . . . . . . 79
Partout . . . . . . . . . . . . . . . . . . . . . 80
variables . . . . . . . . . . . . . . . . . . . . 81
Rorganiser lcran . . . . . . . . . . . . . . . . . . . . . . . . 49
Rponses
Ajouter le champ la table . . . . . . . . . . 117
Choisir une table pour cet objet . . . . . . . 117
Copier et attribuer un nouveau numro . . . 117
Copier et renommer . . . . . . . . . . . . . 115
Copier lobjet . . . . . . . . . . . . . . . . . 117
Crer un autre menu . . . . . . . . . . . . . 117
Ignorer . . . . . . . . . . . . . . . . . . . . 116
Mettre jour . . . . . . . . . . . . . . . . . 116
Mettre le groupe jour . . . . . . . . . . . . 118
Ne pas copier . . . . . . . . . . . . . . . . . 115
Remplacer . . . . . . . . . . . . . . . . . . . 115
Utiliser cet objet . . . . . . . . . . . . . . . 116
Utiliser un autre objet . . . . . . . . . . . . 116

Ressources STR# . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Ajouter une chane . . . . . . . . . . . . . . . 99
Associer du texte . . . . . . . . . . . . . . . 93
Associer un titre de bouton . . . . . . . . . . 92
Associer aux menus et commandes de menus . 92
Crer dans 4D Insider . . . . . . . . . . . . . . 95
Dfinition . . . . . . . . . . . . . . . . . . . . 90
Filtre . . . . . . . . . . . . . . . . . . . . . . . 43
Insrer une chane . . . . . . . . . . . . . . . 99
Modifier . . . . . . . . . . . . . . . . . . . . . 98
Supprimer la chane . . . . . . . . . . . . . . 99
Utilisation avec les composants . . . . . . . 140
Utiliser dans 4D Insider . . . . . . . . . . . . . 94
vers texte . . . . . . . . . . . . . . . . . . . . 96

S
Sauvegarder
base ou librairie . . . . . . . . . . . . . . . . . 22
filtres personnaliss . . . . . . . . . . . . . . . 71
prfrences de dplacement . . . . . . 118, 119
Script Manager (Customizer Plus) . . . . . . . . . . . . 150
Slection
continue . . . . . . . . . . . . . . . . . . . . 46
discontinue . . . . . . . . . . . . . . . . . . . 46
Remplacer dans une . . . . . . . . . . . . . . 81
Slectionner
Dslectionner . . . . . . . . . . . . . . . . . 46
Liste . . . . . . . . . . . . . . . . . . . . . . . 30
Listes . . . . . . . . . . . . . . . . . . . . . . 45
Objet (unique) . . . . . . . . . . . . . . . . . 45
Objets (plusieurs) . . . . . . . . . . . . . . . . 46
Rduire une liste aux objets slectionns . . . . 46
Sous-slections automatiques . . . . . . . . . . 47
Tout slectionner . . . . . . . . . . . . . . . . 46
Zone daffichage . . . . . . . . . . . . . . . . 45
Smaphores (objets de type) . . . . . . . . . . . . . . . . . 43
Source (liste) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Sous-slection . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Crer . . . . . . . . . . . . . . . . . . . . . . 46
Crer un groupe . . . . . . . . . . . . . . . . . 57
Prfixer . . . . . . . . . . . . . . . . . . . . . 86
Sous-table (objets de type) . . . . . . . . . . . . . . . . 37, 43
SQL
Exploitation de fichiers . . . . . . . . . . . . 143
interprt par 4D Insider . . . . . . . . . . . 144
STR# . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Ajouter une chane . . . . . . . . . . . . . . . 99
Associer du texte . . . . . . . . . . . . . . . 93

Manuel de rfrence de 4D Insider

161

Index
Associer un menu ou une commande de menu
92
Associer un titre de bouton . . . . . . . . . .92
Edition . . . . . . . . . . . . . . . . . . . . . .98
Grer les numros (composants) . . . . . . . 140
Insrer une chane . . . . . . . . . . . . . . . .99
Menu STR# . . . . . . . . . . . . . . . . . . .99
Modifier la ressource . . . . . . . . . . . . . .98
Objets de type . . . . . . . . . . . . . . . . . .43
Prsentation . . . . . . . . . . . . . . . . . . .89
STR# vers Texte . . . . . . . . . . . . . . . . .96
Supprimer la chane . . . . . . . . . . . . . . .99
Utilisation dans 4D . . . . . . . . . . . . . . .90
Utiliser dans 4D Insider . . . . . . . . . . . . .94
Supprimer
composant . . . . . . . . . . . . . . . . . . . 138
documentation dun objet . . . . . . . . . . .65
documentation gnrale . . . . . . . . . . . .66
filtres . . . . . . . . . . . . . . . . . . . . . . .72
groupe (dgrouper) . . . . . . . . . . . . . . .58
objets de composants . . . . . . . . . . . . . 131

T
Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
Table dinterface des composants . . . . . . . . . . . .137
Table des rfrences croises (dfinition) . . . . . . . .13
Table des symboles . . . . . . . . . . . . . . . . . . . . . . . . .44
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
Affichage . . . . . . . . . . . . . . . . . . . .31
Objets de type . . . . . . . . . . . . . . . . . .43
Taux manuel (formulaires) . . . . . . . . . . . . . . . . . .108
Texte vers STR# . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
Nouvelle ressource . . . . . . . . . . . . . . .95
Police . . . . . . . . . . . . . . . . . . . . . 151
Ressource existante . . . . . . . . . . . . . . .96
Tout slectionner . . . . . . . . . . . . . . . . . . . . . . . . . .46
Traduction des commandes 4D . . . . . . . . . . . . . .150
Traduire
bases . . . . . . . . . . . . . . . . . . . . . . .89
boutons . . . . . . . . . . . . . . . . . . . . .92
menus et commandes de menus . . . . . . . .90
zones de texte . . . . . . . . . . . . . . . . . .93
Tri (Personnaliser les ressources) . . . . . . . . . . . . .150
Types dobjets . . . . . . . . . . . . . . . . . . . . . . . . . .30, 31
Types de champs (fichiers SQL) . . . . . . . . . . . . . .144

162 Manuel de rfrence de 4D Insider

U
UNIQUE (SQL) . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Utiliser cet objet . . . . . . . . . . . . . . . . . . . . . . . . . 116
Utiliser un autre objet . . . . . . . . . . . . . . . . . . . . . 116

V
Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Prfixer . . . . . . . . . . . . . . . . . . . . .
Renommer . . . . . . . . . . . . . . . . . . .
Variables (Objets de type) . . . . . . . . . . . . . . . . . . .
Visualiser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
contenu des objets . . . . . . . . . . . . . . .
groupes . . . . . . . . . . . . . . . . . . . .
objets et relations . . . . . . . . . . . . . . .
relations . . . . . . . . . . . . . . . . . . . .

44
86
81
44
56
35
56
29
33

W
Win4DX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Windows vers Macintosh (formulaires) . . . . . . . 108

Z
Zone daffichage (Slectionner) . . . . . . . . . . . . . . 45

Vous aimerez peut-être aussi