Classe C++ : FileDialog¶
Description¶
Dialogue de fichiers intégré à la fenêtre parente.
Nom complet : gaspardos::desktop::FileDialog.
En-tête : bindings/cpp/desktop_gui.hpp. C++98.
Dans quel cas l’utiliser¶
Choisir un chemin sans bloquer les autres travaux de l’application.
Exemple de programme simple¶
#include "desktop_gui.hpp"
#include <cstdio>
#include <cstring>
int main()
{
gaspardos::desktop::NativeFileAccess access;
gaspardos::desktop::FileDialog dialog(access);
dialog.begin(gaspardos::desktop::FileExplorer::OpenFile, "/AHCIDISK0");
GO64_Event event = {};
event.type = 8;
event.key = 27;
dialog.event(event, 0);
return !dialog.active() && !dialog.accepted() ? 0 : 1;
}
Compilation depuis Windows¶
Enregistrer le programme ci-dessus dans build/api-examples/FileDialog.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-gcc.exe -std=gnu1x -O2 -mno-red-zone -c bindings/native/gaspardos_x64_syscall.c -o build/api-examples/syscall.o
if ($LASTEXITCODE -ne 0) { throw "C compilation failed" }
& .\build-x64-install\bin\x86_64-gaspardos-g++.exe -std=c++98 -O2 -Ibindings/cpp build/api-examples/FileDialog.cpp build/api-examples/syscall.o bindings/cpp/file_explorer.cpp bindings/cpp/desktop_native.cpp bindings/cpp/desktop_gui.cpp -o build/api-examples/FileDialog-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¶
explicit FileDialog(FileAccess& access)¶
Backend conservé par référence ; doit vivre plus longtemps.
void begin(FileExplorer::Mode mode, const std::string& initial, const std::string& suggested = "", bool allowOverwrite = false)¶
Mode, dossier, nom suggéré, autorisation de remplacement ; surface parente 1000 × 700.
void event(const GO64_Event& event, uint64_t ticks)¶
Transmet événement et ticks monotones ; saisie réservée au dialogue tant qu’actif.
void tick()¶
Avance la lecture progressive ; appeler à chaque tour.
int64_t paint(gui::Painter& painter)¶
Dessine via Painter après READY ; -11 demande une reprise ultérieure.
bool active() const¶
Interaction toujours active.
bool accepted() const¶
Vrai seulement après fermeture avec validation ; ne sauvegarde pas le fichier.
const std::string& result() const¶
Chemin UTF-8 sélectionné, à utiliser si accepted.
Contrat natif¶
ABI LP64, wchar_t 32 bits, aucun packing. Les résultats négatifs natifs ne sont pas errno. Traiter -11 avec yield et une limite applicative. Les objets référencés doivent survivre à leurs utilisateurs ; ne pas copier les propriétaires de handles. File utilise stdio/errno et invalide son flux sur close, même sur erreur.