Monthly Archives: September 2021

Versie van je bibliotheek (Library Version)

Posted on by

De versie van je eigen programma en die van Gambas kennen we al, maar hoe kennen we de versies van de libraries die we gebruiken?
In de programmeeromgeving kan je die vinden in Project, Eigenschappen, Bibliotheken, maar hoe kunnen we in een lopend programma weergeven welke versie van bibliotheken er gebruikt worden?

Library versie
Voor mijn eigen libraries kan ik het oplossen door een functie te maken die het versienummer levert.
In het library project gebruik ik een bestand met de naam VERSION (volledig in hoofdletters).
Dat is ook voorzien in de IDE: vink aan bij project: “Haal uit ‘VERSION’ bestand”.

Dan maak ik een method die ik getVersion() noem en die me de versie uitleest en doorspeelt:

Return File.Load("VERSION")

Tussen de methodes van de klasse zie je nu ook getVersion() staan.

ps: In Gambas kan je die informatie vinden in het verborgen .project bestand.
Library=:supplier/SomeLib:0.2

Gebruikte Libraries
(Upd. 07-2023)

Een Gambas programma (applicatie/project) dat één of meer libraries gebruikt, is voor zijn werking afhankelijk van de versies daarvan; je moet dus te weten kunnen komen welke versies van de libraries je moet installeren om het programma goed te draaien.
Ik standaardiseer daarvoor op een bestand “Libraries.txt”, waarin ik in volgorde de libraries opsom met hun versienummer, 1 per lijn, en in volgorde van afhankelijkheid; bv DataContext gebruikt zelf RunCounter, dan:

RunCounter 0.0.1
DataContext 0.2.9

Als tijdens de ontwikkeling van het programma overgeschakeld wordt naar RunCounter 0.0.2 dan pas je in Libraries.txt deze versie aan, en dan weet je dat het de bedoeling is met die versie te werken.

Demo in je Form

Posted on by

Ik heb een grappige manier gevonden om iets te demonstreren in je Gambas3 programma.
Ik heb in het “Help” menu (of ? menu) naast About, What’s new, Licentie, Help, enz een item bijgemaakt: Demo.
Ik laat daarbij op het scherm, in volgorde, oplichten wat een gebruiker achtereenvolgens moet doen.
Oplichten doe ik door tijdelijk een (achtergrond-)kleurtje te geven, bv geel. Na een kleine wachttijd van 2 seconden (die gemakkelijk kan aangepast worden in de code – misschien moet ik het instelbaar maken voor de gebruiker), krijgt het voorwerp terug de normale kleur.

mniHelpDemo_Click()
'
Dim iWaitABit as integer = 2
'
'...
'
Button1.Background = Color.Yellow
'
Wait iWaitABit
'
Button1.Background = Color.Background
'
Tabstrip1.index=4
'
Tabstrip1.Background = Color.Yellow
'
Wait iWaitABit
'
Tabstrip1.Background = Color.Background
'
Textbox1.Background = Color.Yellow
'
Wait iWaitABit
'
Textbox1.Background = Color.Background
'
'
combobox1.Background = Color.Yellow
'
combobox1.Popup
'
Wait iWaitABit
'
' combobox1.Popdown - doesn't exist? *
'
combobox1.Background = Color.Background
'
' etc...

* Combobox sluiten
Het enige wat niet goed werkt is dat ik een combobox (rolluikje met keuzes) wel kan openen om te tonen wat er allemaal in staat, maar ik kan het niet sluiten zonder een keuze te maken. Dit was niet voorzien in Gambas3, maar zal er aan toegevoegd worden vanaf de volgende versie.
Het is al opgenomen in de broncode, in commit:
https://gitlab.com/gambas/gambas/-/commit/9d08d1371982221fe876fb29ea12d020d2dd264b

Commit 9d08d137
authored 4 days ago by Benoît Minisini’s avatar Benoît Minisini
ComboBox: Close() is a new method that closes the ComboBox popup.
‘
[GB.QT4]
* NEW: ComboBox: Close() is a new method that closes the ComboBox popup.
‘
[GB.QT5]
* NEW: ComboBox: Close() is a new method that closes the ComboBox popup.

Niet voldoende argumenten / Not enough arguments

Posted on by

Situatie: Bij het proces van het integreren van een library die voorheen gemaakte eigen classes moet vervangen, treedt deze fout op.

We krijgen geen regelnummer bij de fout.

1. Klasse
Onderaan zien we aktief:

FMain.@new.0

De hele MMain (opstartklasse) wordt doorlopen zonder probleem (stap voor stap gecheckt met breekpunten).

Vanuit MMain wordt FMain gestart, dan treedt het probleem op. Er zijn wel een aantal variabelen zichtbaar in de foutopsporing, dus een stukje van FMain lijkt te lopen, maar met breekpunten is het niet uit te zoeken: zelfs een breekpunt op de eerste lijn geeft toch al een fout bij het uitvoeren van FMain.

Het probleem leek verdwenen na het verwijderen van de klasse die ook in de library zit.

2. Methode
Deze keer ligt het aan een methode in de gebruikte klasse; die is ooit hermaakt geweest en er moest een methode met de nieuwe naam gebruikt worden: bv “loadConnection” en “makeConnection”.
De oude bestond nog maar werkte niet correct.

3. Declaratie

In een module staat:

Private hDayReq As New CDayReq

“AS NEW” vervangen door aparte declaratie en initialisatie, waardoor je de fout ziet bij de initialisatie (bv daar moest nog een waarde aangeleverd worden als argument).

Private hDayReq As CDayReq
'
hDayReq = New CDayReq("A")

Als de initialisatie niet expliciet gebeurt, maar bij het eerste gebruik van deze module/classe, dan krijg je enkel een summiere foutverwijzing naar de module, maar niet naar de lijn in de module waar de fout vandaankomt.

De impliciete initialisatie met AS NEW gebeurt voor alle gedeclareerde objecten als één ervan gebruikt wordt, niet noodzakelijk hetgene waarvan de initialisatie een fout heeft.

Projecteigenschappen auteurs en beschrijving

Posted on by

Project “Authors” en “Description”

Bij Projecteigenschappen zie je:

Project type (normaal/bibliotheek/component)
Verkoper ("vendor")
Versie ("version)
Titel ("title")
Beschrijving ("Description")
Auteurs ("Authors")

Deze twee laatse leken me handig om te gebruiken voor, bv, het About scherm. Maar ik vond nergens een manier om ze op te roepen. Ze worden bewaard in het bestand .project, maar kunnen niet opgevraagd worden met Application.Description of Application.Authors.
Volgens Benoît Minisini komen ze alleen voor in de broncodeversie van het project, in de “project configuration file”. Ze worden niet meegenomen naar het uitvoerbare .gambas programma. (mailinglist 09-2021)

Dan lijkt het dus eerder bedoeld voor de programmeurs, niet voor de gebruikers van het afgewerkte programma. Ik vraag me nog af of het een goed idee is om hier dan programmeurs commentaren in te zetten, of moeten we rekening houden met een toekomstige update waarbij dit de standaardvelden worden voor auteurs en beschrijving?

Het mysterieuze uitroepteken in library of bibliotheek beschrijving

Posted on by

Bij Project, Eigenschappen, Bibliotheken: selecteer een bibliotheek (of voeg één toe).

Eigenschappen onder bibliotheeknaam zijn:

– Locatie: /home/loginname/.locql/share/gambas3/lib/vendorname/libname:0.0.gambas
– Voorziet in: CContract, CEmp!, CReqProc, CReqState!, ...

Vanwaar die uitroeptekens achter de naam van sommige klasse/modules?

(in de Engelstalige versie is het Project, Properties, Libraries, provides:…)

Antwoord (van gambas mailing list)

  • ! betekent dat de klasse statische symbolen heeft (“An exclamation mark means that the class
    has static symbols.”)
  • ? betekent dat (ipv Export) “Export Optional” is gebruikt. (“There is also a question mark suffix for classes declared with “Export Optional”)

Concreet: als je in een klasse het volgende zet:

STATIC sStaticString AS String = "Statische variabele"
of
PUBLIC CONST cConstString AS String = "Constante"

.. krijg je dus dat uitroepteken achter de naam van de klasse.

ps
Library versie verandert niet
Als je uittest met twee gambas IDE’s naast elkaar open, met een waar je de library maakt, en een ander waarin je die gebruikt, moet je de omgeving van die laatste afsluiten en terug openen om de juiste library gegevens te zien in oudere Gambas v. 3.7.1.
Zoniet blijf je daar altijd het library versienummer zien van toen je de IDE opende in Project, Libraries (zelfs als je de library verwijdert en terug toevoegt, houdt ze oud nummer en Provides gegevens).
De programma’s die je in de IDE start gebruiken echter wel de ondertussen ge-update library!