Skip to content

Classe C++ : FileExplorer

Index · English

Description

Modèle de navigation et de validation de chemin, non copiable.

Nom complet : gaspardos::desktop::FileExplorer.

En-tête : bindings/cpp/file_explorer.hpp. C++98.

Dans quel cas l’utiliser

Choisir un fichier, une destination ou un dossier sans imposer de rendu.

Exemple de programme simple

#include "desktop_native.hpp"
#include <cstdio>
#include <cstring>

int main()
{
    gaspardos::desktop::NativeFileAccess access;
    gaspardos::desktop::FileExplorer     explorer(access);
    explorer.begin(gaspardos::desktop::FileExplorer::SelectFolder, "/AHCIDISK0");
    for (unsigned i = 0; i < 10000 && explorer.loading(); ++i)
    {
        explorer.tick();
        GO64_yield();
    }
    if (explorer.loading() || !explorer.accept(""))
        return 1;
    return explorer.accepted() ? 0 : 1;
}

Compilation depuis Windows

Enregistrer le programme ci-dessus dans build/api-examples/FileExplorer.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/FileExplorer.cpp build/api-examples/syscall.o bindings/cpp/file_explorer.cpp bindings/cpp/desktop_native.cpp -o build/api-examples/FileExplorer-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 FileExplorer(FileAccess& access)

Garde une référence au backend.

void begin(Mode mode, const std::string& initial, bool overwrite = false)

Mode OpenFile/SaveFile/SelectFolder, chemin initial, écrasement désactivé par défaut.

bool navigate(const std::string& directory)

Demande le chargement du dossier ; false si refus.

bool tick()

Avance le chargement ; à appeler depuis la boucle parente.

void select(int index)

Sélectionne un index de la liste.

void activate(int index)

Ouvre le dossier ou active le fichier sélectionné.

bool accept(const std::string& name)

Valide le nom selon le mode ; SaveFile peut demander une seconde confirmation.

bool createFolder(const std::string& name)

Valide le nom puis crée un dossier.

void cancel()

Termine sans acceptation.

const std::vector<FileEntry>& entries() const

Référence aux entrées courantes ; invalidable par navigation/tick.

const std::string& directory() const

Chemin courant.

const std::string& result() const

Chemin retenu ; vérifier accepted avant usage.

bool loading() const

Chargement en cours.

bool finished() const

Dialogue modèle terminé.

bool accepted() const

Résultat validé.

bool confirming() const

Confirmation de remplacement en attente.

int selected() const

Index sélectionné ou sentinelle négative.

Mode mode() const

Mode actif.

Données publiques

volumes : vector ; message : string. Mode = OpenFile, SaveFile, SelectFolder.

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.