[WELCOME]<p>Bienvenue dans <b>Gambas</b> !<img src="img/gambas.png" align=right></p><p><b>Gambas</b> est un environnement graphique de développementbasé sur un interpréteur <i>Basic</i> avancé.</p><p>Le but de <b>Gambas</b> est de vous permettre de concevoir depuissants programmes, et ce facilement et rapidement. Mais la propreté de cesprogrammes reste sous <i>votre</i> entière responsabilité...</p><p>En espérant que vous l'apprécierez !</p><p align=right>Beno&icirc;t Minisini<br><u>gambas@users.sourceforge.net</u></p>[STARTUP]<p>Tout projet doit avoir une <i>classe de démarrage</i>. Cette classe de démarrage doit posséder une méthode publique statique appelée <i>Main</i> ne possédant aucun paramètre. Celle-ci agira alors comme méthode de démarrage de votre programme.</p><p>Pour définir la classe de démarrage, cliquez dessus avec le bouton droit dans l'arbre du projet, et cochez l'entrée <i>Classe de démarrage</i> dans le menu contextuel.</p><p>Il n'est pas nécessaire de définir la méthode <i>Main</i> dans un formulaire de démarrage, car celui-ci en possède une par défaut.</p><p>Cette méthode de démarrage par défaut se charge d'instancier puis d'afficher le formulaire, à la manière de <i>Visual Basic&trade;</i>.</p>[EXEC]Vous pouvez créer un fichier exécutable à partir de votre project.Pour cela, sélectionnez <i>Générer l'exécutable...</i> dans le menu<i>Projet</i>.<p>L'exécutable est placé par défaut dans le répertoire du project.Il porte le même nom que le project.[OPEN]L'instruction <b><tt>OPEN</tt></b> de <b>Gambas</b> ne fonctionnepas comme celle de <i>Visual Basic&trade;</i>. Elle ne retournepas le fichier ouvert sous forme d'un entier, mais d'un objet dela classe <i>File</i>.<p>Ainsi, au lieu de taper:<pre>DIM handle AS Integer...OPEN "myfile" FOR READ AS #handle</pre><p>Vous devez taper:<pre>DIM handle AS File...OPEN "myfile" FOR READ AS #handle</pre>[CATDIR]Savez-vous que vous pouvez concaténer des noms de répertoires etde fichiers avec l'opérateur <b><tt>&/</tt></b> ? <p>Cet opérateur s'occupe d'ajouter le caractère de délimitationde répertoire <tt>'/'</tt> lorsque c'est nécessaire.<p>Par exemple :<pre>PRINT "/home/gambas" &/ ".bashrc"/home/gambas/.bashrcPRINT "/home/gambas/" &/ "/tmp" &/ "foo.bar"/home/gambas/tmp/foo.bar</pre><p>N'est-ce pas merveilleux ? :-)[PATH]Les chemins relatifs ont une signification particulière dans <i><b>Gambas</b></i>.Ils font référence aux fichiers situés à l'intérieur de votre projet.<p>Il n'y a pas de concept de <i>répertoire courant</i>, et aucune instructiontelle que <tt>CHDIR</tt> qui serait susceptible de le modifier.<p><b>Attention :</b> vous devez toujours utiliser des chemins relatifs pouraccéder aux fichiers de votre projet, car les chemins absolus vers cesfichiers n'ont plus de signification lorsque le projet est transforméen exécutable.[GLOBAL]Il n'y a <u>pas</u> de variables globales en <b><i>Gambas</i></b>&nbsp;!<p>Par contre, vous pouvez placer les variables auquel vous désirez de toutvotre project dans votre module principal en les déclarant <tt>PUBLIC</tt>.<p>Si vous n'avez pas de module principal, mais un formulaire principal,déclarez-les comme <tt>STATIC PUBLIC</tt>.<p>Pour accéder à ces variables, vous devez utiliser le nom du module ou duformulaire principal ainsi&nbsp;: <tt>MonModulePrincipal.MaVariableGlobale</tt> ou<tt>MonForumairePrincipal.MaVariableGlobale</tt>.[EMPTY]Pour savoir si une cha?ne est vide, il n'est pas nécessaire d'effectuerune comparaison avec <tt>""</tt> ou bien d'utiliser la fonction<tt><b>Len()</b></tt>. Il est possible de la tester directement, car unecha?ne vide est équivalente à <tt><b>FALSE</b></tt> et une cha?ne non-videest équivalente à <tt><b>TRUE</b></tt>.<p>Par exemple, plut?t que de faire :<pre>IF Len(MyString) > 0 THEN ...IF Len(MyString) = 0 THEN ...</pre><p>Vous devriez plut?t faire :<pre>IF MyString THEN ...IF NOT MyString THEN ...</pre>[EVENT]Chaque contr?le, et chaque objet pouvant générer des évènements, possèdeun <i>observateur d'évènement</i> et un <i>nom de groupe</i> d'évènement.<p>L'observateur d'évènement re?oit chaque évènement généré par un object, etle nom de groupe d'évènenement est le préfixe de la fonction qui seraappelée pour gérer l'évènement.<p>Par défaut, l'observateur d'évènement est l'objet à l'intérieur duquelvous avez créé le contr?le, et le nom de groupe est le nom du contr?le.<p>De cette manière, un formulaire recevra tous les évènements des contr?leslui appartenant.<p><pre>' Gambas formDIM hButton AS ButtonPUBLIC SUB _new()&nbsp;&nbsp;hButton = NEW Button(ME) AS "MyButton"ENDPUBLIC SUB MyButton_Click()&nbsp;&nbsp;PRINT "You have clicked MyButton !"END</pre>[FORM]En <b><i>Gambas</i></b>, un formulaire est son propre observateur, afinque vous puissez directement gérer ses évènements (cille <i>Resize</i>,<i>Activate</i>, ...) dans le code même de la classe associée.<p>De cette manière, les débutants venant de <i>Visual Basic</i> ne sontpas désorientés :-).[EMBED]<p>You can embed any form into other forms with <b><i>Gambas</i></b>&nbsp;!</p><p>To do such a powerful thing, just instanciate the form by passinga parent container as last argument of the contructor.</p><p>For example&nbsp;:</p><p><tt>DIM hForm AS MyDialog<br>DIM hSuperControl AS MyForm<br><br>' Create a dialog<br>hForm = NEW MyDialog<br>' Insert a form into this dialog<br>' Note that this form takes two parameters before the container<br>hSuperControl = NEW MyForm(Param1, Param2, MyDialog)<br>' Moves and resizes the form<br>hSuperControl.Move(8, 8, 128, 64)<br></tt></p><p>Be careful: a form embedded into another form is still a form, andso is its own event observer.</p>[GROUP]<p>Every control has a <i>(Group)</i> property. When this propertyis set, the prefix of the event handler name is the name of the groupand not the name of the control.</p><p>Let's suppose you have a <i>Button</i> named <b>btnAction</b>with the following <i>Click</i> event handler :</p><pre>PUBLIC SUB btnAction_Click()</pre><p>If you set the <i>(Group)</i> property of <b>btnAction</b> to<i>MyGroup</i>, then the event handler that will receive events fromthe button will be the following :</p><pre>PUBLIC SUB MyGroup_Click()</pre><p>This property lets you handle events of different controls ina single function. And the controls of the same group do not needto have the same type !</p><p><b>Note :</b> The old <i>Visual Basic</i> veteran may recognizethe concept of <i>control array</i>, but in a more powerfulimplementation. :-)</p>[TAG]<p>Each control has a <i>Tag</i> property. This property is for theprogrammer, and can contain any <b>VARIANT</b> data that you findrelevant.</p><p>This is very useful, when you want to distinguish controls of thesame group in a common event handler.</p>[LAST]<p>The <b>LAST</b> keyword returns the last control that hasreceived an event. This is very useful when you want to write anevent handler that is independent of any control name.</p><p>For example, let's suppose you want to write a calculator program.You have defined ten buttons, one for each digit, each one in thesame <i>group</i> "Digit". The <i>Tag</i> of each control is set tothe digit drawn in the button. Your event handler may look like that :</p><p><tt>PUBLIC SUB Digit_Click()<br><br>&nbsp;&nbsp;Display = Display & LAST.Tag<br>&nbsp;&nbsp;RefreshDisplay<br><br>END</tt></p>[LEFT]<p>The well known <i>BASIC</i> routines <b>Left$</b>, <b>Right$</b>and <b>Mid$</b> have useful behaviours in <b><i>Gambas</i></b></p><p>The second parameter of <b>Left$</b> and <b>Right$</b> isoptional, and is one by default.</p><p><tt>Left$("Gambas")</tt> returns <tt>"G"</tt><br><tt>Right$("Gambas")</tt> returns <tt>"s"</tt></p><p>This second parameter can be negative, and then gives the numberof characters not to extract.</p><p><tt>Left$("Gambas", -2)</tt> returns <tt>"Gamb"</tt><br><tt>Right$("Gambas", -2)</tt> returns <tt>"mbas"</tt></p><p>Likewise, the third argument of <b>Mid$</b> can be negative, andthen gives the number of characters from the end of the stringnot to extract.</p><p><tt>Mid$("Gambas", 2, -2)</tt> returns <tt>"amb"</tt>[END]<p>Vous avez lu toutes les astuces du jour. J'espère que vous êtesdevenu un expert <b>Gambas</b> maintenant ! :-)</p><p>Si vous désirez ajouter de nouvelles astuces de votre cru,n'hésitez-pas à les envoyer à l'adresse suivante&nbsp;:</p><p><u>gambas@users.sourceforge.net</u></p><p>Merci d'avance !</p>