LE GUIDE DU DÉBUTANT DELPHISTE

Le Guide du débutant Delphiste 1ere Edition

Ce tutoriel à pour objectif d'apprendre aux débutants les règles essentielles pour la création d'un projet à la fois propre et professionnel et ce afin de prendre les bonnes habitudes dès le début de votre apprentissage dans le monde de Delphi, ainsi que des conseils pour chercher ou poser des questions sur le forum de Delphifr. (en collaboration avec Francky2301230)

Copyright & Informations Légales.

Le contenu de cette article appartient à ses Auteurs respectifs, l'intitulé "Le Règlement" à Francky23012301 et l'intitulé "Le Projet Clean" à Shining-Freeman,

Toute reproduction ou représentation intégrale ou partielle, par quelque procédé que ce soit, faite sans autorisation au préalable auprès de ses Auteurs est illicite et constitue une contrefaçon. Conformément au dispositions du code de la propriété intellectuelle, seules sont autorisées, d'une part, les reproductions strictement réservées à l'usage privé du copiste, d'autre part, le site Delphifr.com qui en détient l'exclusitivé, sur ce nous vous souhaitons une bonne lecture :).

Le Règlement

Chapitre I - Introduction :

J'ai lu dans le bar, une remarque d'un membre qui disait qu'un jour il finirait par mettre le règlement de CS entier dans sa description. Et là je me suis dis : "Pourquoi ne pas expliquer par le biais d'un tuto le règlement de CS et comment mener à bien ses recherches ?". Il en découle ce tutorial qui va etre très simple.

En fait cela faisant longtemps que je voulais le faire : c'est pour moi quelque chose qui manquait. En espérant froisser personne.

Chapitre II - Les 10 commandements de CS :

AVANT DE POSTER : Tu chercheras

GOOGLE, LA TOUCHE F1, L'INSPECTEUR D'OBJET : Tu les aimeras

BONJOUR, MERCI, AUREVOIR : Tu diras

LE STYLE SMS : Tu l'éviteras

COURAGEUX ET RESPECTUEUX : Tu le seras

LES SOURCES ET LES COMPOSANTS : Tu les étudiras

AUCUN CODES : tu n'exigeras.

EXECUTABLES et BATCH : Tu n'en metteras pas

AVANT DE METTRE UN SOURCE : regarder qu'il y en pas déjà, tu vérifieras

REPONDRE TOI AUSSI AUX QUESTIONS : Tu le feras

Voilà le règlement de CS résumé: donc plus d'excuses pour ne pas le connaitre.

Chapitre III - Pourquoi chercher ?

Des composants il y en a des milliers pour ne pas dire plus. Chacun ayant sa spécificité. Chacun d'entre nous est devant l'inconnu quand il travaille avec un nouveau composant. Et pourtant tout le monde ne poste pas : Ce n'est donc pas lié à une différence de niveau mais de courage.

Cependant il est normal qu'un débutant poste plus qu'un membre avancé.

Chapitre IV - Comment poster ?

Avant de valider un post il faut :

Se poser la question : "Est ce que j'ai respecté le règlement?"

Se poser une autre question : "Est ce que j'ai donné assez d'informations pour être aidé ?"

Se poser une autre question : "Est ce que j'ai été clair ?"

Si on a donné une mauvaise réponse, ne pas sentir humilié : on est pas là pour faire un concours et l'erreur est humaine.

Si on a pas compris un tuto, une fonction, ou un code : mettre l'URL correspondant.

Si on dispose d'un code, il faut le donner : c'est impératif pour être aidé.

Si on ne sait pas comment procéder pour réaliser quelque chose : on ne demande pas de sources mais on intérroge les membres sur la méthodologie à utiliser.

Ne pas hésiter à demander l'avis voir une correction ou un béta-test à un membre avancé.

A lors quand poster sur CS ? quand après une rechercher approfondie et différents essais (qui se chiffrent en plusieurs heures), on a pas trouvé ou pas compris.

Chapitre V-Comment chercher

Voici une méthode de recherche, étape par étape :

Sélectionner le message d'erreur, la fonction, le composant qui nous interpelle puis appuyer sur la touche F1 : regarder la hiérarche, les propriétés, les méthodes, les évènements ainsi que les exemples fournient dans cette aide.

Faire une recherche sur Google avec des mots simples séparés par le caractère "+". Le premier mot à mettre est Delphi. Exemple : "delphi+base de données+access". Vous trouverez un lien vers un tutorial pour vous connecter à une base de données Access.

Essayer plusieurs combinaisons de mots si cela est nécessaire.

Faire une rechercher sur CS dans le moteur de recherche. N'hésitez pas à faire un tour sur les sites des autres langages. Vous trouverez des sources que vous pourrez traduire dans votre langage. Regarder aussi les snippets.

Regarder les sources disponibles et aussi ceux des composants : vous y trouverez beaucoup d'informations.

Etudiez les codes : en plus d'apprendre "l'orthographe" de votre langage, vous y apprendrez aussi la "grammaire".

Toute étude doit se faire avec minutie : un code ne se lit pas mais se comprend. Il arrive que des codes ne correspondent pas exactement à nos besoins mais peuvent etre un bon tremplin pour aboutir vers ce que l'on doit faire.

Chapitre VI - Conclusion ?

Chaque fois qu'un membre passe une minute pour vous répondre, c'est une minute durant laquelle il ne code pas.
Ceci ne doit pas vous empecher de poster mais vous obligez à vous rappeler qu'il faut chercher avant de le faire.

Copyright © 2006 Francky23012301. Tous droits réservés

Le Projet Clean

Chapitre I - Introduction

On constate généralement qu'il y'a très peu de devellopeurs qui publient des projets "clean", en effet on voit assez souvent des projets avec pleins de fiches et d'unités partout et lors de la compilation du projet on se retrouve avec tout un tas de déchets inutiles bref c'est un véritable chantier !!!, ce tutoriel à pour but de vous apprendre à créer un projet propre et d'appliquer quelques règles de bases pour le bien être de tous. y compris ceux qui seront amener à vous venir en aide !!!.

Chapitre II - La création d'un nouveau projet

Nous allons créer un nouveau projet pour se faire allez dans le menu de Delphi comme suit:

Menu->Fichier->Nouveau->Application

vous devez maintenant avoir une fenêtre comme celle-ci :

A) Menu de Delphi

B) Commande "Tout enregistrer"

C) L'inspecteur d'Objet

D) Form Designer

E) Unité(Code Delphi)

Chapitre III - Le plan de travail

Maintenant nous allons enregistrer notre projet, Cliquez sur la commande "Tout enregistrer", Delphi vous invite alors à enregistrer l'unité en cours "unit1", mais avant nous allons créer quatre repertoires avec la commande de la figure "A"

A) Commande "Créer un nouveau dossier"

- Un repertoire Forms: pour toutes les fiches de notre projet.avec leur unité respective

- Un repertoire Exe : pour la sortie du projet compilé(executable).

- Un repertoire Dcu : pour les unités compilées(dcus)

- Un repertoire Units : qui contiendra toutes les nouvelles unités de notre projet

Maintenant nous allons pouvoir enregistrer notre fiche principale, tout d'abord entrez dans le repertoire "Forms" puis renommé votre unité "Unit1" en "Main" puis un cliquez sur "Enregistrer" comme ceci:

Maintenant Delphi vous invite à enregistrer votre projet "*.dpr", sortez du repertoire "Forms" en faisant un clique sur "Dossier Parent" voir figure "B"

Avant de cliquer sur "Enregistrer" n'oubliez pas de renommé le projet avec le nom que vous voulez.!!

Chapitre IV - Options du projet

Maintenant il va nous falloir définir les options de compilations afin de placer correctement les bonne unités dans les repertoires que nous avons créer au préalable.

Menu->Projet->Options...

Destination : étant le repertoire de sortie de l'executable

Destination de l'unité : étant le repertoire de sortie des unités compilées(dcu)

Chemin de recherche : étant l'emplacement de fichiers source supplémentaire, en effet il arrive parfois d'avoir une librairie qui peut avoir plusieurs centaine de fichiers, dans ce cas là au lieu de faire "Projet->Ajouter au projet", il suffit de créer un repertoire et de placer dedans toutes les unités externes au projet et d'inclure le chemin de recherche, evitez de mettre un path complet tel que "c:\MyMib", et mettez plutôt ces unités dans un repertoire qui se trouve dans le repertoire racine du projet exemple "Forms, Exe" , imaginons que ce repertoire s'appel "ExtrasLib" alors dans Chemin de recherche on mettra "\ExtrasLib". pour le reste je vous invite à consulter l'aide en ligne de Delphi !!

Attention !!! par défaut Delphi fait une copie des fichiers de votre projet précédé du symbole "~", par exemple main.~pas, main.~dfm, généralement on se sert que très rarement de ces fichiers "Backup", voir pratiquement jamais !!!, de ce fait vous pouvez désactivé cette fonction depuis l'IDE.

pour se faire allez dans le menu de Delphi Menu->Outils->Options de l'éditeur...

Cliquez sur l'onglet "Affichage" et décochez la case "Créer un fichier de sauvegarde"

Chapitre V - Le renommage des composants

Prennez l'habitude de renommer les composants de votre projet:

Eh oui si vous mettez un 50 boutons dans votre projet il se peut que dans l'instant même vous voyez capable de reconnaître la fonction de chacun mais quand n'est-il deux mois après ?, vous serez dans l'incapacité de reconnaître la fonction de tel ou tel bouton, menu ect..., il ya une règle très simple pourtant :

Abréviation du Composant + Action du Composant

si notre bouton sert à ouvrir un dialogue dans ce cas là, le bouton va être renommé en btnOpen, car étant donné que c'est un bouton son abréviation sera "btn", son action étant d'ouvrir, mais il ouvre quoi au fait ?, il est alors plus judicieux d'être le plus explicite que possible quant au choix du nom du composant, si il ouvre un fichier via un dialogue, alors mettez btnOpenFile, tout comme dans la figure plus haut, il suffit de changer le nom du composant avec la propriété "Name" dans l'inspecteur d'objet, et il en va de même pour chaque composant du projet !!!.

voici une liste des abréviations des composants les plus fréquemment utilisées:

Noubliez pas de renommé votre fiche principale par "FrmMain" !!!, de plus à chaque fois que vous allez ajouter une nouvelle fiche veuillez respecter cette règle:

On renomme le nom de la fiche et ainsi que son unité, tout en sachant que le nom de l'unité de chaque fiche devra se terminer par "Wnd" , Exemple j'ai une fiche qui s'appel FrmConfig, son unité s'appel ConfigWnd, de ce fait en mettant dans la clause uses ConfigWnd on sait de suite que cette unité fait référence à une fiche et non à une unité spécifique, à l'execption de al fiche principale qui elle devra s'appeler "FrmMain" et son unité "Main.pas".

On enregistre la fiche dans le repertoire "Forms", de ce fait Delphi va placer la fiche et son unité dans ce même repertoire.

Chapitre VI - L'indentation du code

L'indentation de code consiste à laisser de l'espace entre les lignes de code de sorte à avoir un champ visuel "clean", en effet si vous ne faites pas d'indentation le code risque alors d'être illisible, vous même risquez de ne plus savoir ou et quand se termine telle boucle ect..., il ya une règle simple à appliquer :

votre code doit commencer en dessous de chaque "n" de "begin", de telle sorte que si on prend une règle et qu'on trace une ligne verticale sur le "b" de "begin" on devrait logiquement tomber sur le "end" de ce dernier !!!

Copyright © 2006 Francky23012301& Shining-Freeman. Tous droits réservés