Accueil CanalOpenSource
SourceServer
Langage xShell
BasicBrick
tcp OpenClient
tcp_OpenServer

DesignServer

openSource Shop Gallery
Main Street
freeway Avenue

Liens :

www.pmarty.biz
www.4DToday.com
www.4D.fr
Documentation 4D
Documentation ITK
www.4D-forum.org
www.solutions4d.com

BasicBrick regroupe 15 librairies 4D Insider tirées de xShell. Ces librairies sont indépendantes les unes des autres et directement exploitable dans vos développements.

Les librairies

AreaList Pro - 4D List 6.8

Cette librairie contient 57 méthodes au total et 34 méthodes dédiées à la manipulation d'une zone externe AreaList Pro ou 4D List 6.8. La librairie Alp4DList simplifie de manière significative l'implémentation de ce plug in car elle regroupe un ensemble de commandes sous une syntaxe générique au sein d'un groupe de méthodes. Vous trouverez dans la partie language une documentation complète de cette librairie et des exemples de syntaxe.

Langage

Focus :
alp_OnStartupProcess | alp_SetFile | alp_SetArray | alp_SetDefault | alp_SetColumn | alp_SetCurrentArea | alp_AreaMethode | alp_UpdateOnOutSideCall

Array

Cette librairie contient 19 méthodes pour manipuler les tableaux. Elles sont documentées dans la partie language.

Langage

Blob

Trois méthodes sont proposées dans cette librairie avec comme propos de chercher, extraire ou remplacer une chaine dans un blob.

blb_Search | blb_Extract | blb_Replace

Execute

Cette librairie vous permet d'executer un bloc de code 4D. Ce bloc de code peut être passé en paramètre à la méthode exe_ et vous pouvez aussi donnez le chemin d'accès à un fichier text. Le code peut être complexe et contenir tous les mots clés du langage de 4D. Boucle, Au cas ou, vous pouvez les imbriquer sans limite.

Il existe une restriction : exe_ ne gère pas les variables locales. En compilé, vous ne pouvez utiliser que des variables connues du compilateur.

Vous pouvez faire appel à la méthode "o" si vous avez intégré la librairie Object et ainsi vous avez la possibilité de vous affranchir de cette limitation du compilateur vis à vis des variables.

Il faut trapper l'erreur 60. Cette erreur est générée par le compilateur qui n'accepte pas d'executer une méthode avec des paramètres. La méthode OnErrorCall est incluse dans la librairie. Cette erreur une fois gérée, il est tout à fait possible d'executer une méthode avec paramètres.

exe_ accepte d'être empilé, c'est à dire que vous pouvez appeler exe_ dans le code source que vous faites executer à exe_. exe_gère jusqu'à sept appels empilés.

Langage

Focus:
exe_ | exe_SetExpr

Field

Cette librairie contient 7 méthodes à utiliser avec les champs. fld_GetSingle est à utiliser en saisie d'un champ alpha. fld_IsIndexable retourne vrai si le champ accepte d'être indexé. fld_TypeToArray retourne le type de tableau correspondant au type de champ passé en paramètre. fld_TypeToPict retourne le numéro de ressource image utilisé dans 4D pour symboliser le type de champ...

Langage

FormObjectPosition

Les commandes 4D qui permettent de positionner les objets d'un formulaire par programmation sont extrèmement utiles. Leur syntaxe n'est pas évidente. Cette librairie simplifie ces syntaxes en les décomposant en méthodes (11 au total) plus parlante. FormObjectPosition ajoute quelques possibilitées à la gestion des objets d'un formulaire si vous prenez soin d'appeler fop_Declare avant. Cette librairie est entièrement documentée.

Langage

Handle

6 méthodes qui tournent autour de l'id unique, du handle, du time stamp. A voir tout particulièrement hdl_GetHandle capable de générer des identifiants alpha numérique de manière alléatoire.

Langage

HierarchicalList

La liste hierarchique de 4D est un objet indispensable mais pas simple. Cette librairie de douze méthodes aide sensiblement à la mise en place de listes complexes. Construire une liste se fait à l'aide de 3 méthodes :

hls_SetParam (Faux;0;502;0)
hls_AddArray (->hls_vl2;->dsg_arrtMethod)
hls_SetParam (Faux;1;0)
hls_AddList (->hls_vl1;->vtext;->hls_vl2)

Ajout d'un tableau, puis ajout d'une sous liste.

En plaçant la méthode hls_ObjectMethod dans la méthode objet de votre liste hierarchique, la majeur partie des possibilités graphique de la liste sont gérées, en particulier le glisser déposer entre les objets de la liste, depuis un objet du formulaire ou depuis une liste d'un autre process. La méthode hls_ObjectSpecialCode est un point d'entrée appelé par hls_Objectmethod qui vous permet de trapper un appel et d'executer du code spécifique.

hls_SetOnClic permet de paramétrer le code à executer sur le clic souris. En affectant la variable hls_vtExecuteOnDBClic vous paramétrez le code à executer sur le double clic souris.
La méthode dsg_Explorer employée dans Designer Explorer est un bon exemple d'utilisation des méthodes de cette librairie.

Longtemps employée, hls_Set est devenue obsolete. Il est conseillé d'utiliser hls_AddArray et hls_AddList.

Langage

HierarchyFileSystem

Cette librairie composée de 34 méthodes gère l'accès aux documents sur disque et les chemins d'accès à ces documents.

Langage

Focus :
hfs_CopyFileByRSP | hfs_DeleteFolder | hfs_FolderPath | hfs_RenameFolder

Object

Les deux méthodes présentées dans cette librairie vous permettent de disposer d'un ensemble de variables pré-typées que vous utilisez par l'intermédiaire d'un pointeur qui vous est retourné. o et oi sont très interressantes.

Properties

Cette librairie contient 54 méthodes. Son propos est de structurer un champ ou une variable texte pour y stocker de l'information sous la forme propriete=valeur. Il est possible de créer des sections pour encadrer ces propriétés. Cette librairie est très utilisée dans xShell.

Langage

Focus :
prp_SetCurList | prp_Add | prp_Set | prp_Get | prp_Drop

Search

Cette librairie de 5 méthodes encapsule la commande CHERCHER en proposant une autre syntaxe, et encapsule FIXER LIMITE RECHERCHE et FIXER DESTINATION RECHERCHE.

sch_ | sch_Set | sch_GetDestination | sch_GetLimit | sch_GetFound

Stuff

Deux méthodes pour compresser et décompresser des documents même s'ils sont très gros. La librairie contient au total 21 méthodes.

stf_Compact | stf_UnCompact

Texte

Cette librairie contient des méthodes pour manipuler les chaines de caractères ou convertir des textes en différents format.

Langage

Focus :
txt_ArraysToText | txt_TextToArrays | txt_CutOut | txt_Extract

Window

Cette librairie de 47 méthodes au total en contient 19 dédiées aux fenêtres avec une syntaxe simplifiée.
Alors que wnd_SetDialog fixe la barre de menus des dialogues, wnd_SetInterfaceTable fixe la table de vos formulaires d'interface. Alors il reste à écrire wnd_ResizableFloatingPalette ("Dsg_Explorer") pour avoir une palette flottante redimensionnable.
wnd_PrpLoad et wnd_PrpSave sont appelées automatiquement par les méthodes d'ouverture de fenêtre comme wnd_Dialog vont conserver et restituer les positions et les tailles des fenêtres lors de leur fermeture.

Language

Focus :
wnd_Move | wnd_Resize | wnd_Centre | wnd_Dock

Informations :

L'archive téléchargeable contient l'ensemble des librairies de basicBrick avec le stub xSh_ pour MacOS 9 et X et Windows.

Chaque libriaire contient un groupe du nom de la librairie qui regroupe les méthodes projet propres à cette librairie et en dehors de ce groupe les méthodes utilisées par la librairie. Déplacez l'ensemble des méthodes projet. Sauf indication préalable, les librairies ne contiennent pas de barre de menu, de table ou de formulaire.