Classe C++ : Widgets¶
Description¶
Gestionnaire de 32 widgets maximum, non copiable.
Nom complet : gaspardos::gui::Widgets.
En-tête : bindings/cpp/widgets.hpp. C++98.
Dans quel cas l’utiliser¶
Créer boutons, menus, champs ASCII et labels avec une boucle événementielle.
Exemple de programme simple¶
#include "widgets.hpp"
#include <cstdio>
#include <cstring>
class ConsolePainter : public gaspardos::gui::Painter
{
public:
int64_t fill(int, int, int, int, uint32_t)
{
return 0;
}
int64_t text(int, int, uint32_t, const char* value)
{
std::puts(value);
return 0;
}
};
int main()
{
gaspardos::gui::Widgets widgets(320, 200);
if (widgets.add(gaspardos::gui::Button(1, 10, 10, 120, 26, "OK")) < 0)
return 1;
gaspardos::gui::Event ready = { gaspardos::gui::Ready, 0, 0, 0, 0 };
widgets.event(ready);
ConsolePainter painter;
return widgets.paint(painter) == 0 ? 0 : 1;
}
Compilation depuis Windows¶
Enregistrer le programme ci-dessus dans build/api-examples/Widgets.cpp, depuis la racine du dépôt. Créer le dossier si nécessaire.
PowerShell — depuis la racine du dépôt :
New-Item -ItemType Directory -Force build/api-examples | Out-Null
& .\build-x64-install\bin\x86_64-gaspardos-g++.exe -std=c++98 -O2 -Ibindings/cpp build/api-examples/Widgets.cpp -o build/api-examples/Widgets-x64.elf
if ($LASTEXITCODE -ne 0) { throw "C++ compilation/link failed" }
Le binaire ELF s’exécute sous GaspardOS, pas sous Windows. Le pilote fournit CRT et bibliothèques. Préparer les volumes/services requis ; les exemples bornent leurs attentes et peuvent sortir sur saturation au lieu de réessayer. Une compilation réussie ne valide pas l’exécution noyau.
Les fichiers nécessaires à cet exemple sont disponibles dans la section Source files (en anglais).
Méthodes de la classe¶
Widgets(int width, int height)¶
Dimensions de la surface, vide et non prêt.
int add(const Widget& w)¶
Copie Widget ; 0 succès, -24 capacité, -22 géométrie/type/parent, -17 identifiant dupliqué. Parent menu déjà ajouté.
const char* value(int id) const¶
Pointeur texte interne pour id ; null si absent ; ne pas le libérer.
int setText(int id, const char* text)¶
Copie au plus 63 octets ; 0 ou -9 si absent ; déclenche un nouveau dessin.
int event(const Event& e)¶
ID >0 action, 0 aucune, -1 fermeture, -2 erreur UI ; envoyer Ready avant interaction.
bool dirty() const¶
Un dessin est nécessaire.
int64_t paint(Painter& painter)¶
-11 avant Ready ; reprend à la commande échouée ; 0 une fois dessin terminé ou déjà propre.