Gambas Documentation
Documents
Books

Gambas 3.14.0

What's new?

This release brings the main following features:
  • The IDE can now print a source code file.

  • A lot of fixes in the packager wizard.

  • A 16 point size version of the Gambas font.

  • Support for immutable (read-only) arrays.

  • PROPERTY...USE... is a new shortcut syntax for defining properties.

  • Uncaught errors raised from an event handler can be ignored now.

  • The compiler emits column position on errors and warnings if possible.

  • Many fixes for dark themes.

  • Message boxes are not native anymore.

  • Web applications based on gb.web or gb.web.form now correctly handle the Accept-Language HTTP header.

Compilation and installation

Read the instructions there.

If everything was fine, type "gambas3" to run the development environment.

Enjoy it !

Changelog

CONFIGURATION

  • Fix Willy Raets' mail address.

  • Update Gambas 3 desktop file and add french translations.

DEVELOPMENT ENVIRONMENT

About dialog

  • Wrap license text so that it is not truncated.

  • Update design.

  • Display financial support again.

Automatic completion

  • Handle boxed strings.

  • Fix constructor signature computation.

Code editor

  • Fix keyboard handling in procedure list.

  • Add a print button and menu entry that prints the contents of the editor.

  • Automatic insertion of global variables now inserts the STATIC keyword if the current function is static.

Database editor

  • Locating SQLite database inside the home directory or inside the project now works correctly.

Debugger

  • Make debugging windows fully readable with dark themes.

  • Fix a possible crash when disabling/enabling a breakpoint.

Farm client

  • ESC key now closes the window.

Form editor

  • Fix a possible crash when dragging a toolbox control on a form.

Help browser

  • The loading spinner is now always correctly centered.

Image editor

  • Selection drawing tool now works correctly when snapping lines to 15° angles by pressing the ALT key.

  • Show the grid below the selection and other tool strokes.

Make executable dialog

  • Add an option not to increment version. This option is saved in the local project settings.

Menu editor

  • Double-clicking on a menu entry now automatically closes the menu editor to open the Click event handler of that menu.

Options dialog

  • Use icon-only tool buttons for configuring highlight style.

  • Add an option to define the font used for printing.

Packager wizard

  • Remove deprecated entries in SPEC file for mageia.

  • Remove support for mandriva.

  • Do not remove deprecated entries from SPEC file for Mageia, it does not work.

  • Don't use absolute path for executable in desktop files.

  • The desktop file Name entry is now emitted with its translations.

  • Extra desktop file entries can override default entries.

  • Allow to enter the minimum Gambas version required.

  • Translate project description in desktop file.

  • When making a *.deb package, clean-up the target directory from possible already existing similar packages. Otherwise dpkg-buildpackage does not build.

  • Doing the same package several times without closing the wizard works correctly now.

  • Autotools package does not use the deprecated AM_INIT_AUTOMAKE syntax anymore.

  • Create lower-case symbolic links on executables for Debian, Slackware, ArchLinux and Autotools packages.

Project creation dialog

  • Forbid <, >, (, ), { and } in project names.

  • Disable templates using components not installed on the system.

Project properties dialog

  • Environment variables menus must not be translatable.

  • Standardize the look of lists widgets.

  • Add support for extra references, i.e. external executables that add their symbol information to the automatic completion. This is useful if your project is a library loaded by the extra reference that uses its exported classes.

Project tree

  • Startup class is now drawn with underline bold text instead of using an emblem.

  • "Open in folder" menu entry is now visible on file items, not just directories.

Search dialog

  • The "Public" folder is now correctly browsed in all cases.

Text editor

  • Add a print button and menu entry that prints the contents of the editor.

Translation dialog

  • New button that adds a new translation.

  • The "-" string is not used anymore for strings marked as not to be translated. Instead a specific "# gb-ignore" comment and a void translation are written into the PO file.

  • Automatic translation now works better with multi-line translations.

  • The automatic translation now stops as soon as the translation program fails.

Translations

  • Update French translation.

  • Update French translation so that top-level menu does not use characters with diacritics for shortcuts.

  • Always read the translation of project title and description when displaying a project box, and read them correctly.

  • Updated Dutch translation.

  • Update translations of license.

  • Update Spanish translation.

  • Update Italian translation.

Version control

  • Command timeout is now 15 seconds instead of 30.

  • Add a new tab in the bottom panel for managing version control.

  • Always reload the project after a pull / update from the repository.

Miscellaneous

  • Remove the now useless authors.txt file.

  • Add cyrillic and greek character in the SDL default font generation function.

  • When a component of the opened project is not installed, do not remove it from the project component list. Keep it uncheckable.

  • Correctly read multi-lines translations of project title and description.

  • Redraw some icons.

  • Update financial support.

  • Update highlight themes.

  • Support for new Highlight.Alternate style.

  • Add support for the new gb.form.print component.

  • When gb.gui is used, only propose GUI components actually installed on the system.

  • Support for the ByRef annotation in .info files.

  • Update Gambas fonts.

  • Update error messages.

  • Add a 16 point version of the Gambas font, in medium and bold weight.

  • Add dark theme versions of component chooser icons (checked, partially checked, locked).

  • Add a bookmark on the current project in all directory and file choosers.

WIKI

  • Discount comments in .info files when calculating number of symbols.

  • Updated Dutch translations

  • Support for ByRef annotations in .info files.

  • Fix links inside symbol syntax, so that they keep the current language.

WEB SITE MAKER

  • Updated Dutch translations

EXAMPLES

  • DnsClient: Fix mageia web site hostname.

  • Replace "mandrake" by "mageia" in DnsClient example.

  • Make Games/Invaders compile correctly.

  • Update some translations.

INTERPRETER

  • Add two new standard errors: "Multidimensional array" and "Unknown class".

  • Fix gb.Scientific number format.

  • Stream.Eof is a new property that returns if end of stream has been reached. It's the same thing as Eof(Stream).

  • Ignore errors when loading a class for the JIT compiler.

  • Component.Load() can load a component located at an absolute path now.

  • If the current translation does not exist, try to use the first available translation of the same language in another country.

  • The archive path is now a dynamic string.

  • Don't crash anymore when searching into an archive that failed to load.

  • Replace some specific error messages by standard errors.

  • The "Embedded array" error message has been rewritten as "Read-only array".

  • Array.ReadOnly is a new property that make an array read-only. Once set, the property cannot be unset.

  • Static class initializer are now always correctly run in the context of their component.

  • Fix JIT compilation when there are a lot of functions.

  • &/ operator now automatically converts its arguments to strings.

  • Error.Clear() now clears the error flag returned by the ERROR function.

  • Uncaught errors raised from an event handler can be ignored now.

COMPILER

  • Take project extra references into account.

  • Emit column position in almost all error messages. It makes the compiler about 0.5% slower.

  • Some optimizations in symbol table routines.

  • Add ByRef annotations to the ".info" files generated by the compiler. The name of "ByRef" method arguments is now prefixed with a & character.

  • PROPERTY...USE... is a new syntax to declare a property automatically associated with a private global variable.

INFORMER

  • Fix a forgotten ! that broke the informer.

GB.ARGS

  • Updated Dutch translations

GB.CLIPPER

  • Get rid of a gcc warning.

  • Update library to version 6.4.2.

GB.COMPRESS.BZLIB2

  • Fix a few error messages.

  • Fix incorrect datatype of some driver function arguments that lead to a crash.

GB.COMPRESS.ZLIB

  • Fix a few error messages.

GB.DB

  • Print the current date/time before any debugging message.

GB.DB.FORM

  • DataComboView: Add argument to the signature of Event Validate.

  • DataSource: IgnoreParent is a new property that tells the DataSource not to filter its contents with any of its parent DataSource.

  • Updated Dutch translations

GB.DB.MYSQL

  • Build with newer mysql/mariadb.

GB.DB.SQLITE3

  • Multiple statements in the same query does not leak memory anymore. In that case, the result of the last statement is returned.

  • Take newlines, tabs, and backticks into account when analyzing a table schema.

GB.DBUS

  • Always specify the direction of input method arguments in introspection, otherwise the qdbusviewer tool does not work.

GB.DESKTOP

  • Desktop.Passwords: Work correctly now when multiple desktops are included in the Desktop.Type property.

  • DesktopFiles: Remove some useless array copies.

  • DesktopMime: Correctly identify executables as "application/x-executable".

  • Desktop.Types is a new property that returns a read-only array of each desktop defined in Desktop.Type.

GB.DRAW

  • Paint: Scale() second argument is now optional, and takes the same value as the first argument if omitted.

  • Paint: FontScale is a new property that defines a scale applied to the size of the fonts assigned to the Paint.Font property.

  • Painting on an already painted device now correctly inherits the Paint.FontScale property.

GB.EVAL

  • Highlight.Alternate is a new constant that represents the background style used for coloring code embedded into webpages.

GB.EVAL.HIGHLIGHT

  • CSS highlighter: Support for CSS escaped characters.

  • Support for new Highlight.Alternate style.

GB.FORM

  • DocumentView: Allow zoom up to 800%.

  • DocumentView: Desaturate is a new property that desaturates the preview. It's slow when the zoom is huge.

  • DocumentView: ShowPage is new property that displays the current page and the number of pages inside the preview.

  • DocumentView: Fix some cases of page drawing not correctly triggered.

  • DocumentView: Use Paint.Begin() instead of Draw.Begin(), so that preview uses anti-aliasing.

  • DocumentView: The default background color is now a mix of the default text foreground and background colors.

  • DocumentView: Correctly reset the scroll position when setting Arrangement to Arrange.Fill.

  • DocumentView: Remove erroneous public constant written in French.

  • Expander: Redesign the Expander title.

  • FileView: Add information about each file next to the icon in icon view mode.

  • IconPanel: Fix cursor keys management, so that hidden tabs cannot be selected by keyboard.

  • ListEditor: Exist() is a new method that returns if an item exists in the list.

  • ListEditor: Add() is a new method that insert a new element in the list.

  • ListEditor: Add is new event that is raised when the add button is clicked.

  • ListEditor: ReadOnly is a new property that makes ListEditor enter read-only mode.

  • ListEditor: Use the remove icon instead of the delete one.

  • MenuButton: Handle right-to-left written language correctly.

  • MenuButton: Use selected background color when the MenuOnly property is set and the MenuButton has the focus.

  • MenuButton: Focus should not be stolen anymore when clicking on a menu-only MenuButton.

  • MenuButton: Fix possible crashes with focus management.

  • SliderBox: Hitting the ESC key in the SpinBox resets the SliderBox to its default value.

  • Spinner: Use the foreground color to draw the spinner and its label.

  • TabPanel: Draw tab focus like hovered buttons.

  • TabPanel: Fix drawing of tab header contents.

  • TabPanel: Use the TabPanel foreground color to draw the titles of the tabs.

  • Update some translations.

  • Italian translations improvements.

  • Updated Dutch translations.

  • New new-tab stock icon.

  • New call stock icon.

  • Bookmarks is a new static class that allows to define global bookmarks for all FileChooser and DirChooser controls.

  • FileChooser: Add separators between the different kind of bookmarks in the bookmark menu.

GB.FORM.DIALOG

  • Updated Dutch translations

GB.FORM.EDITOR

  • TextEditor: Undo now groups successive single character insertions, and successive single character deletions as well.

  • TextEditor: Don't enclose selection with quotes anymore, it is more annoying than anything else.

  • TextEditor: TextEditor[].Paint() is a new method that paint the contents of a line, without the margin.

  • TextEditor: Now we can set up to 32 style colors without crashing.

  • TextEditor: Draw wrapped lines with a normal background, but with a gray hook to its right.

  • TextEditor: Translate popup menu.

  • TextEditor: When the cursor moves, the blinking timer is reset so that the cursor blinks only when it is not moving.

  • TextEditor: Matching braces now blink with the cursor.

  • TextEditor: Support for new Highlight.Alternate style.

GB.FORM.MIDI

  • Updated Dutch translations

GB.FORM.PRINT

  • gb.form.print is a new component that extends the Printer class with a generic preview and print dialog.

GB.FORM.STOCK

  • Add a 128 pixel version of the delete stock icon.

  • Redraw a few icons.

  • New new-tab stock icon.

  • Add call stock icon and redraw archive icon.

  • Add 128 pixels versions of stock icons used by mimetypes.

GB.FORM.TERMINAL

  • TerminalView: Update colors so that they are readable both on a light and a dark background.

GB.GTK

  • Control: Fix the Tooltip property name.

  • Control: Fix the symbol lookup error of the Tooltip property.

  • Message: Remove the message box native implementation.

  • Paint: Implementation of Paint.FontScale.

  • Printer: All printer events are raised between a single Paint.Begin() / Paint.End().

  • Message boxes now correctly use the translated title.

  • Tooltips now support rich text, like in the QT components.

  • Disable top-level menus shortcuts when the window menu bar is hidden.

  • Drag.X and Drag.Y properties are now writable.

  • Drag.Show() and Drag.Hide() methods are now implemented in gb.gui.base.

  • Automatically set Paint.FontScale when painting on a printer, so that font size is actually the same as on the screen.

  • Fix a memory leak when getting the size of a piece of text.

  • Fix menu proxy management that could crash combo-box popups.

  • Uncaught errors raised from an event handler can be ignored now.

GB.GTK3

  • Control: Fix the Tooltip property name.

  • Control: Fix the symbol lookup error of the Tooltip property.

  • Message: Remove the message box native implementation.

  • Paint: Implementation of Paint.FontScale.

  • Printer: Font sizes now are the same as with QT components.

  • Printer: Print() does now crash anymore.

  • Printer: All printer events are raised between a single Paint.Begin() / Paint.End().

  • Rudimentary support for GDK backends that are not X11.

  • Message boxes now correctly use the translated title.

  • Tooltips now support rich text, like in the QT components.

  • Disable top-level menus shortcuts when the window menu bar is hidden.

  • Finishing a drag & drop now correctly releases the button grab.

  • Drag.X and Drag.Y properties are now writable.

  • Drag.Show() and Drag.Hide() methods are now implemented in gb.gui.base.

  • Automatically set Paint.FontScale when painting on a printer, so that font size is actually the same as on the screen.

  • Fix a memory leak in font object creation.

  • Fix a memory leak when getting the size of a piece of text.

  • Fix menu proxy management that could crash combo-box popups.

  • Uncaught errors raised from an event handler can be ignored now.

GB.GUI.BASE

  • GridView: GridView.Rows[].TextAlign is a new property that allows to define the alignment of the row header text.

  • GridView: The padding of column headers is at least half of Desktop.Scale.

  • GridView: Compute preferred column width correctly.

  • GridView: Border padding is now applied inside the cell, not outside like the margin.

  • GridView: Rich-text in centered cells with no text wrapping is correctly drawn now.

  • IconView: Draw selected icons with a rectangular frame.

  • Message: Implement the message boxes entirely in Gambas.

  • ScrollArea: The Scroll() method returns TRUE now if no scrolling actually occured.

  • SpinBox: Forgot to implement the ReadOnly property.

  • SpinBox: Hitting the ENTER or RETURN key triggers the Change event if needed.

  • TreeView: Item X property now correctly takes the TreeView padding into account.

  • TreeView: Setting the item Font property to NULL does not crash anymore.

  • TreeView: A Scroll event is raised now when the TreeView, the ListView or the ColumnView scrolls.

  • TreeView & ColumnView: The arrow size now follows the font size.

  • TreeView & ColumnView: ShowLines is a new property that makes the control draw tree lines.

  • Paint.DrawRichTextShadow() default radius is now the same as Paint.DrawTextShadow().

  • Add helper function for disabling/enabling top-level menu shortcuts.

  • Drag.Show() and Drag.Hide() methods are now implemented in gb.gui.base.

  • Top-level menus initialization routine takes invalid menus into account now.

  • Paint.Arrow() is a new method that draws an arrow.

  • Don't depend on gb.form, it breaks the compilation!

GB.JIT

  • Loading a class during JIT compilation can fail. Take that into account.

  • Enumerating an unknown datatype does not raise an error automatically anymore.

  • Fix boolean datatype management.

GB.MEDIA.FORM

  • Emit standard control events from the inner DrawingArea.

  • Don't crash when seeking if no media is played.

GB.NET

  • Workaround a bug in system header files on PPC systems.

GB.NET.CURL

  • DownloadManager: Add a Connect event raised when the distant server is connected.

  • DownloadManager: Remove useless Message event.

GB.NET.POP3

  • Fix .project and .component files that incorrectly had conflict marks in it.

  • Updated Dutch translations

GB.OPENSSL

  • Add linking exception for OpenSSL (Thanks, Bastian Germann).

  • Allow arbitrary digest methods to be passed to HMac(). They are now identified by their name. The integer arguments are deprecated.

  • Add OpenSSL.RandomBytes to generate a cryptographically strong pseudo-random string of given length

  • Add static class OpenSSL for general utility methods provided by OpenSSL

GB.PDF

  • Compile with poppler >= 0.76.

GB.QT4

  • Message: Remove the message box native implementation.

  • Paint: Implementation of Paint.FontScale.

  • Dialog.SelectDirectory() now correctly shows hidden files when Dialog.ShowHidden is TRUE.

  • Drawing text now respects right-to-left languages the same way on every drawing device.

  • Disable top-level menus shortcuts when the window menu bar is hidden.

  • Drag.X and Drag.Y properties are now writable.

  • Drag.Show() and Drag.Hide() methods are now implemented in gb.gui.base.

  • Fix rich text size computation.

  • Fix rich text size margins between paragraphs and titles.

  • Automatically set Paint.FontScale when painting on a printer, so that font size is actually the same as on the screen.

  • Uncaught errors raised from an event handler can be ignored now.

GB.QT4.EXT

  • Editor: Fix Highlight.Alternate property.

GB.QT5

  • Message: Remove the message box native implementation.

  • Paint: Implementation of Paint.FontScale.

  • Dialog.SelectDirectory() now correctly shows hidden files when Dialog.ShowHidden is TRUE.

  • Drawing text now respects right-to-left languages the same way on every drawing device.

  • Disable top-level menus shortcuts when the window menu bar is hidden.

  • Drag.X and Drag.Y properties are now writable.

  • Drag.Show() and Drag.Hide() methods are now implemented in gb.gui.base.

  • Fix build with Qt 5.13.

  • Fix rich text size computation.

  • Fix rich text size margins between paragraphs and titles.

  • Automatically set Paint.FontScale when painting on a printer, so that font size is actually the same as on the screen.

  • Uncaught errors raised from an event handler can be ignored now.

GB.QT5.EXT

  • Fix build with Qt 5.13.

GB.QT5.OPENGL

  • Fix build with Qt 5.13.

GB.QT5.WEBKIT

  • Fix build with Qt 5.13.

GB.REPORT

  • Updated Dutch translations.

GB.REPORT2

  • Updated Dutch translations.

GB.SDL2

  • Add Greek and Cyrillic characters to the default font.

  • Update default font with latest version of Gambas font.

GB.TERM.FORM

  • Fix Dutch translation file which had conflict markers inside.

  • Fix project description.

  • Remove useless void translation files.

  • Updated Dutch translator e-mail

GB.UTIL

  • Date.IsWeekEnd() is a new method that returns if a date is a week end.

  • Update French translation.

GB.WEB

  • Request: Posted field request using multipart/form-data and having initial void lines were incorrectly trimmed. Posted files were not affected.

  • Enhance language detection done by the Request.Language property.

  • CGI error message is not translatable.

  • If the request exceeds the maximum size defined by Request.MaxFileSize, a "Request too big" error is raised instead of "Response too big".

  • Request.Language now takes the priority of languages specified in the Accept-Language HTTP header into account.

  • Request.Language now uses an internal dictionary to convert the Accept-Language HTTP header to a correct system language.

  • Request.ContentLength is a new property that returns the Content-Length HTTP header, or -1 if the header is not present.

  • Request.ContentType is a new property that returns the Content-Type HTTP header.

GB.WEB.FEED

  • Update translations.

  • Updated Dutch translator e-mail.

GB.WEB.FORM

  • WebForm: Fix message box icons preloading.

  • WebForm: An error is raised now when trying to show an embedded form.

  • WebForm: Forms embedded into other forms work correctly now.

  • Updated Dutch translator e-mail.

GB.XML

  • Error messages must not be translatable.

  • Component version is now taken from the VERSION file.

  • Fix XmlExplorer constructor declaration.

TEMPLATES

  • Update french translation of some template projects.