WritePreferenceString

WritePreferenceString()

Syntaxe

WritePreferenceString(Clé$, Valeur$)

Description

Crée ou change la paire Clé-Valeur sous la forme : 'Clé$ = Valeur'.
La valeur est de type chaîne de caractères String

Arguments

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

Si la clé existe, la valeur associée est remplacée par la nouvelle valeur.

Si PreferenceGroup() a été utilisé alors l'écriture est limitée au groupe courant.

Valeur La valeur est de type chaîne de caractères à associer à la clé. Voir String

Valeur de retour

Aucune.

Exemple

  ; Création du fichier prefs.txt
  If CreatePreferences(GetTemporaryDirectory()+"Prefs.txt", #PB_Preference_GroupSeparator)
    PreferenceGroup("Window")
      WritePreferenceString("Titre", "PureNote") 
      WritePreferenceLong ("X", 100)
      WritePreferenceLong ("Y", 125)
      WritePreferenceInteger("I", 1024) 
      WritePreferenceQuad("Q", 9223372036854775807)
      WritePreferenceFloat("%", 20.10)
      WritePreferenceDouble("D", 0.0123456789 )
    ClosePreferences()   
    RunProgram(GetTemporaryDirectory()+"Prefs.txt")
    EndIf

Exemple: "Stocker des données"

  ; Créer un fichier de préférences 'ColorList.ini'
  ; Remarque : Dans ce cas, les valeurs des données doivent être uniques (pas de clés en double).
  If CreatePreferences(GetTemporaryDirectory()+"ColorList.ini", #PB_Preference_NoSpace)
    WritePreferenceString("FF0000", "")
    WritePreferenceString("00FF00", "")
    WritePreferenceString("0000FF", "")
    WritePreferenceString("FF00FF", "")
    ClosePreferences()
  Else
    Debug "Erreur : Impossible de créer le fichier 'ColorList.ini' !"
  EndIf
  
  ; Lire le fichier 'ColorList.ini' et afficher les clés (qui sont les données ici)
  If OpenPreferences(GetTemporaryDirectory()+"ColorList.ini")
    ExaminePreferenceKeys()
    While NextPreferenceKey()
      Debug PreferenceKeyName()
    Wend
    ClosePreferences()
  Else
    Debug "Erreur : Impossible de créer le fichier 'ColorList.ini' !"
  EndIf

Voir aussi

WritePreferenceFloat(), WritePreferenceDouble(), WritePreferenceInteger(), WritePreferenceQuad(), WritePreferenceQuad()

OS Supportés

Tous

<- WritePreferenceQuad() - Preference Index

Clé$	Le nom de la clé à écrire. Si la clé existe, la valeur associée est remplacée par la nouvelle valeur. Si PreferenceGroup() a été utilisé alors l'écriture est limitée au groupe courant.
Valeur	La valeur est de type chaîne de caractères à associer à la clé. Voir String