ReadPreferenceString()

Syntaxe

Resultat$ = ReadPreferenceString(Clé$, ValeurParDefaut)
Description
Lit et renvoie la chaîne de caractères String associé à une clé.

Arguments

Clé$ Le nom de la clé à lire.

Si la commande PreferenceGroup() a été utilisée alors la recherche est limitée au groupe courant.
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

<- ReadPreferenceQuad() - Preference Index - RemovePreferenceGroup() ->