Documentation de Gambas - /comp/gb.settings

/comp/gb.settings
Le page anglaise est plus récente.

# gb.settings

Ce composant permet à votre projet de traiter les fichiers de configuration d’application.

Classe | Description
--- | ---
Settings | Cette classe gère les fichiers de configuration globale.

### Fichiers de configuration

Ces fichiers, nommés typiquement "xyzzy.conf" (où "xyzzy" est le nom de votre application), peuvent être interrogés pour obtenir les réglages spécifiques locaux et peuvent être employés pour enregistrer de tels réglages entre deux lancement de l’application.

#### Syntaxe des Fichiers de Configuration

Un fichier de configuration est un fichier texte, dont chaque ligne est soit :

- Une ligne vide, qui est ignorée.

- Une ligne de commentaire, commençant par un caractère '`#`' ou '`;`', qui est ignorée.

- Une ligne de valeur ; c’est un couple `"Key=Value"`.

- Une ligne de branchement commençant par un caractère '`[`', et terminée par '`]`', qui regroupe des lignes `"Key=Value"` dans un chapitre.

Une valeur est accédée par sa clé complète, qui est le nom du chapitre suivi d’une barre de fraction et de la clé.

Le nom du chapitre peut également contenir des barres de fraction.

### Exemples

    [Editor]
    Font="Bitstream Vera Sans Mono"
    Toolbar=1
    CleanOnSave=0
    ShowProc=1
    ShowChange=1
    ShowCurrent=1
    UseRelief=1
    Color[0]="&FFFFFF&"
    Color[1]="&000000&"
    Color[2]="&00C0A0&"
    Color[3]="&00C000&"

    [ExistingFile]
    ExplorerType=0
    Splitter="249,249"
    TreeSequence="0"
    PreviewImg=0
    ShowHidden=0

    [ExistingImage]
    Path="/usr/share/icons/crystalsvg/64x64/devices"
    Key="1"
    ExplorerType=1
    Splitter="212,434"
    TreeSequence="1"
    PreviewImg=1
    ShowHidden=0

    [...]