A Beginner's Guide to Gambas - ibiblio

1 A Beginner's Guide to GambasCover design by Fabien BodardForeword by Fabien Bodard and Beno t Minisini1A Beginner's Guide to GambasCopyright Notice for the printed version of this work:A Beginner's Guide to Gambas (this work) is copyright 2005 by John , all rights are reserved. Personal use of this material is , permission to reprint/republish this material for advertising or promotionalpurposes or for creating new collective works for resale or redistribution to servers orlists, or to reuse any copyrighted component of this work in other works must beobtained from the the author, John W. Rittinghouse. The author grants a perpetuallicense to the Gambas user-community for use of the electronic version of this printedwork under the terms and conditions of the OpenContent License printed on thefollowing Beginner's Guide to GambasCopyright Notice for the electronic (online) version of this work, based on the OpenContent License(OPL), Version , July 14, 1998.

2 This document outlines the principles underlying the OpenContent (OC) movement and may be redistributed provided it remainsunaltered. For legal purposes, this document is the license under which OpenContent is made available for use. The originalversion of this document may be found at . LICENSE Terms and Conditions for Copying, Distributing, and Modifying Items other than copying, distributing, and modifying the Content with which this license was distributed (such as using, etc.)are outside the scope of this license. 1. You may copy and distribute exact replicas of the OpenContent (OC) as you receive it, in any medium, provided that youconspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intactall the notices that refer to this License and to the absence of any warranty; and give any other recipients of the OC a copy ofthis License along with the OC.

3 You may at your option charge a fee for the media and/or handling involved in creating a uniquecopy of the OC for use offline, you may at your option offer instructional support for the OC in exchange for a fee, or you may atyour option offer warranty in exchange for a fee. You may not charge a fee for the OC itself. You may not charge a fee for thesole service of providing access to and/or use of the OC via a network ( the Internet), whether it be via the world wide web,FTP, or any other method. 2. You may modify your copy or copies of the OpenContent or any portion of it, thus forming works based on the Content, anddistribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified content to carry prominent notices stating that you changed it, the exact nature and content ofthe changes, and the date of any ) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the OC or anypart thereof, to be licensed as a whole at no charge to all third parties under the terms of this License, unless otherwisepermitted under applicable Fair Use law.

4 These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the OC, andcan be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply tothose sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which isa work based on the OC, the distribution of the whole must be on the terms of this License, whose permissions for other licenseesextend to the entire whole, and thus to each and every part regardless of who wrote it. Exceptions are made to this requirementto release modified works free of charge under this license only in compliance with Fair Use law where applicable. 3. You are not required to accept this License, since you have not signed it.

5 However, nothing else grants you permission tocopy, distribute or modify the OC. These actions are prohibited by law if you do not accept this License. Therefore, bydistributing or translating the OC, or by deriving works herefrom, you indicate your acceptance of this License to do so, and allits terms and conditions for copying, distributing or translating the OC. NO WARRANTY 4. BECAUSE THE OPENCONTENT (OC) IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE OC, TOTHE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THECOPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE OC "AS IS" WITHOUT WARRANTY OF ANY KIND,EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK OF USE OF THE OC IS WITHYOU.

6 SHOULD THE OC PROVE FAULTY, INACCURATE, OR OTHERWISE UNACCEPTABLE YOU ASSUME THE COST OFALL NECESSARY REPAIR OR CORRECTION. 5. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHTHOLDER, OR ANY OTHER PARTY WHO MAY MIRROR AND/OR REDISTRIBUTE THE OC AS PERMITTED ABOVE, BELIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIALDAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE OC, EVEN IF SUCH HOLDER OR OTHER PARTYHAS BEEN ADVISED OF THE POSSIBILITY OF SUCH Beginner's Guide to GambasTable of 1 Introducing Gambas Programming IDE 2 Gambas Language Variables, Data types and Using The WITH and operators ..36 Arithmetic 's Start Coding , RETURN and QUIT 3 Keywords and Program Flow PRINT IF SELECT / CASE and FOR / NEXT [WHILE] [Expression] WEND Loops.

7 52 The REPEAT UNTIL loop ..53 Defining and Using Arrays in FOR EACH 4 Introducing the Gambas Button Control Beginner's Guide to GambasButton Picture 5 Controls for Gathering 6 Menus, Modules, Dialogs and Message Gambas Menu or Alert Class File related OpenFile SaveFile SelectDirectory Example 7 Handling Strings and Converting Data Beginner's Guide to GambasUpper$/Ucase$/Ucase and Lower$/Lcase$/Lcase ..126 Trim$, LTrim$, and RTrim$..127 Left$, Mid$, and Right$ ..128 Space$..130 Replace$ ..130 String$ ..131 Subst$ .. Data and Chr$ ..135 Bin$..136 CBool .. / Cinteger and CShort ..140 CStr / CString ..140 Hex$..141 Conv$ ..141 Val and Str$ ..142 Str$ ..142 Format$..145 Datatype management .. 8 Using Advanced the Gambas Icon Edit TreeView GridView ColumnView Controls HBox, VBox, HPanel and Vpanel.

8 176 HBox and and Beginner's Guide to GambasThe TabStrip 9 Working with / Dir? ..191 Stat ..191 Temp / Temp$ ..192 OPEN and , SEEK, WRITE and , KILL and , 10 Math of / / / / / / and and Beginner's Guide to GambasMax and and Math 11 Object Oriented of Object Oriented Gambas Approach to program: Contact Controls to Quit the Labels and () Toolbuttons: First, Prev, Next, and ToolButtons: Adding a ToolButtons: Clearing User Beginner's Guide to GambasAdding a Search DoFind again: Updating a again: Deleting a again: Saving a Stand alone 12 Learning to and ,FillStyle,FillX, Primitives: Point/Rect/ Primitives: Polygon and with a Drawing 13 Error Concepts of Error Related and Later Flow in Handling or Interpreting and Load and Hardware , Version, and ID Control Plan Error IF Beginner's Guide to GambasCatch and Finally Event 14 Mouse, Keyboard and Bit 15 Gambas and Concept of a Class Beginner's Guide to GambasThe Database Example 16 Global Character Set (UCS).

9 To translate in Beginner's Guide to GambasTable of FiguresFigure 1 General overview of Gambas 2 the Gambas Opening 3 The Gambas Project Creation 4 A dialog to select the type of Gambas project you wish to 5 Project Name Selection 6 Project Directory Selection 7 New Project confirmation 8 The Gambas 9 Project Explorer File 10 Project 11 Project Explorer View 12 Project Explorer Tools 13 Project Explorer Menu and 14 A Division by Zero Error 15 The Gambas 16 Additional controls for 17 First Button code 18 Demonstrating font 19 The dotted line indicates focus for a 20 The layout for SecondProject 21 A partially constructed form with our first four 22 Event 23 Adding the FunBtn to our 24 What our form looks like when a

10 Mouse is detected over the the text is blanked out..77 Figure 25 The progress bar when the FunBtn is clicked three 26 ThirdProject (almost) final 27 Using HTML to format TextLabel 28 Modified TextLabel output using HTML 29 Adding a ToolTip to inform the user how to show/hide a 30 Our 31 The Edit list property 32 Formatting a TextLabel with 33 Plus and minus buttons to alter the ComboBox 34 What our ListBox will look 35 ListBox Edit list property 36 What the example frame we build will look Beginner's Guide to GambasFigure 37 A Panel with 38 Menu Project Final 39 The Gambas Menu Editor when it first 40 Edit fields for the Menu 41 Building our project 42 A formatted text label displaying the color 43 Selecting colors and 44 Making a new default font for the TextLabel1 45 An Information 46 A checked menu 47 A Question 48 An Error 49 A Warning 50 Delete