PreferenceGroup()

Syntaxe

Resultat = PreferenceGroup(Nom$)
Description
Crée un nouveau groupe sous la forme: [Nom$] ou modifie le groupe courant dans le fichier de préférences.

Arguments

Nom$ Le nouveau nom du groupe.

Valeur de retour

Renvoie une valeur non nulle en cas de succès, zéro sinon.

Remarques

Toutes les opérations de lecture ou d'écriture qui suivent ne concernent que ce groupe.

Si le groupe n'existe pas, il ne sera pas immédiatement créé. Il sera créé uniquement lorsqu'au moins une clé sera écrite dans ce groupe. Ceci permet d'utiliser PreferenceGroup() pour tester si un groupe existe sans créer plein de groupes vides.

Pour quitter un groupe, un "Nom$" vide peut être utilisé.

La recherche de groupe est insensible à la casse.

Exemple

  ; Ouvrir un fichier préférence
  OpenPreferences(#PB_Compiler_Home +"Examples/Sources/Data/test.pref")
  
  ; Groupe à examiner
  PreferenceGroup("Window")
  
  ; Recherche des clés dans le groupe 'Window'  
  ExaminePreferenceKeys()
  While  NextPreferenceKey() ; Tant qu'il existe une clé à afficher
    MessageRequester("Clés du groupe 'Window'", PreferenceKeyName() + " = " + PreferenceKeyValue())  ; Afficher la clé et sa valeur
  Wend
  
  ; Fermer le fichier préférence
  ClosePreferences()  

Voir aussi

PreferenceGroupName()()

OS Supportés

Tous

<- PreferenceComment() - Preference Index - PreferenceGroupName() ->