ReadPreferenceString()

Syntaxe

Resultat$ = ReadPreferenceString(Clé$, ValeurParDefaut)

Lit et renvoie la chaîne de caractères String associé à une clé.

Arguments

Clé$	Le nom de la clé à lire. Si la clé se trouve dans un groupe, PreferenceGroup() doit être utilisé pour changer le groupe actuel.
ValeurParDefaut	La valeur par défaut à renvoyer si la clé n'existe pas ou si le fichier de préférences n'a pas été ouvert correctement (fichier absent par exemple).

Valeur de retour

Renvoie la chaîne de caractères String associée à la clé. Si ce nombre n'existe pas alors la valeur par défaut 'ValeurParDefaut' est renvoyée.

Exemple

  ; Ouvrir un fichier préférence
  OpenPreferences(#PB_Compiler_Home +"Examples/Sources/Data/test.pref")
  
  ; Ouvrir le Groupe 'window'
  PreferenceGroup("window")
  
  ; Parcourir les clés jusqu'à la clé: w = 800
  NextPreferenceKey() ; x = 0
  NextPreferenceKey() ; y = 0
  NextPreferenceKey() ; w = 800
  
  ; Lecture de la clé
  cle$= PreferenceKeyName()
  
  ; Affichage de la valeur de la clé sous différents formats
    MessageRequester("Clé Integer", Str(ReadPreferenceInteger(cle$,0)))
    MessageRequester("Clé Float", StrF(ReadPreferenceFloat(cle$,0),6))
    MessageRequester("Clé Double", StrD(ReadPreferenceDouble(cle$,0),15))
    MessageRequester("Clé Long", Str(ReadPreferenceLong(cle$,0)))
    MessageRequester("Clé Quad", Str(ReadPreferenceQuad(cle$,0)))
    MessageRequester("Clé String", ReadPreferenceString(cle$,"0"))
    
  ; Fermer le fichier préférence
  ClosePreferences() 

Voir aussi

ReadPreferenceDouble(), ReadPreferenceFloat(), ReadPreferenceInteger(), ReadPreferenceLong(), ReadPreferenceQuad()

OS Supportés

Tous