Gambas Documentation
Application Repository
Code Snippets
Compilation & Installation from source code
Components
Controls pictures
Deprecated components
Developer Documentation
Development Environment Documentation
Documents
About The Best Formula In The World
Architecture details
Benchmarks
Books
By Reference Argument Passing
Compatibility between versions
Creating And Using Libraries
Database Datatype Mapping
Database Request Quoting
Date & time management
Dates and calendars
DBus and Gambas
Differences Between Shell And Exec
Differences From Visual Basic
Distributions & Operating Systems
Drag & Drop
DrawingArea Internal Behaviour
External functions datatype mapping
Frequently Asked Questions
Gambas Farm Server Protocol
Gambas Mailing List Netiquette
Gambas Markdown Syntax
Gambas Naming Conventions
Gambas Object Model
Gambas Scripting
Gambas Server Pages
Gambas Unit Testing
Gambas Wiki Markup Syntax
Getting Started With Gambas
Getting Started With The IDE
Hall Of Fame
Housekeeping, cleaning up
Image Management In Gambas
Including Help Comments in Source Code
Installation from binary packages
Interpreter limits
Introduction
Just In Time Compiler
Just In Time Compiler (old version)
License
Localisation and Internationalization
Mailing Lists & Forums
Naming Conventions
Network Programming
ODBC Component Documentation
PCRE Pattern Syntax
Porting from Gambas 2 to Gambas 3
Previous News
Project Directory Structure
Release Notes
Reporting a problem, a bug or a crash
Rich Text Syntax
Screenshots
Text highlighting definition file syntax
The Program has stopped unexpectedly by raising signal #11
Variable Naming Convention
Wayland and Gambas
WebPage Syntax
Web site home page
What Is Gambas?
Window & Form Management
Window Activation & Deactivation
Window Life Cycle
XML APIs
Error Messages
Gambas Playground
How To's
Language Index
Language Overviews
Last Changes
Learning topics
Lexicon
README
Search the wiki
To Do
Topics
Tutorials
Wiki License
Wiki Manual

Getting Started With The IDE

Before starting the IDE make sure you have read Getting Started With Gambas first, so you have a proper installed version of Gambas.

Gambas installed from a repository

If you have installed Gambas from binaries you will find it in your system menu Programming. Just click Gambas3 and the IDE will launch.

Gambas installed from compilation

If you have compiled Gambas3 yourself you will need to open a Terminal and type:

$ gambas3.gambas

Note that you have to create your own .desktop file to make a system menu entry or start Gambas3 from Terminal.

Create a new GUI project

  • Click on New Project.

  • In the opened dialog Select a project click on Graphical Application in the right panel.

  • Name the project HelloWorld

  • Select a location for the project in the left panel

  • Once done click button Create



Meet the IDE

The IDE, short for Integrated Development Environment, is the place to be, for developing Gambas applications. As the term suggests is is all that is needed to develop in Gambas, integrated into one application. Do note that the Gambas IDE is written in Gambas, so you get an idea of the power of the language.

The IDE is mainly divided into 3 big sections. These sections can have further subdivisions depending on where you are and what you are doing in your project. These 3 main sections are:

  • Menu and toolbar section

  • The Project Browser

  • The Form/Code Editor



The Menu and toolbar section is quite self explanatory.

The Project Browser shows you all that is part of the project. It will hold the form related files, the files with code, but it can hold much more, actually all that you think you need in your project, like image files, license files etc.

The Form/Code Editor is where most of the work is done. You can design your forms here, switch between code and form design, and write your code to make it all work. The looks of the Form/Code Editor are situational, meaning you will get another layout when in form design then when in code design. Even better, if you click on an image in the Project Browser it will change into an image editor.

Create a control, write some code

Make sure to click on FMain in the Project Browser before you continue with the next step.

You are going to add a button control to the form. You will find the button in the Form/Code Editor subsection Toolkit.



Click on the Button control and next drag a rectangle on the form the size of the button. In the Properties the subsection above the Toolkit scroll down to the Text property of the Button and change it to Hello.



Double click on the Button. This will open the code editor in the click event of the created button. In the click event for Button1 (your created button) you place code you want to be executed when Button1 is clicked. Type the code shown in the illustration below for the click event.



Run your project

Now that all is setup all that is left is see if it works. The Gambas IDE allows you to run your projects from the IDE, so you can easily test them. For this press F5 on your keyboard. This will run your application.



Congratulations, you have just created and run you first GUI project in Gambas.



Page revisions

Getting Started With The IDE by: W. Raets - Aug 24th, 2025