PreferenceGroup()

Синтаксис

Result = PreferenceGroup(Name$)

Описание

Создает новую группу (в виде: [Name$]) или изменяет текущую группу в файле настроек. Все последующие операции чтения или записи будут ограничиваться этой группой. Чтобы покинуть текущую группу, можно вызвать данную функцию с использованием пустого имени 'Name$', в виде ("").

Параметры

Name$

Имя новой группы.

Возвращаемое значение

Возвращает не нулевое значение, если группа уже существует, в противном случае 0.

Комментарии

Если группа не существует, она будет создана при записи первого ключа. Это позволяет использовать функцию PreferenceGroup() для проверки существования группы без создания множества пустых групп.

Пример

; Открывает файл настроек
OpenPreferences(#PB_Compiler_Home +"Examples\Sources\Data\test.pref")

; Выбор текущей группы
PreferenceGroup("window")

; Исследует ключи в группе 'window'
ExaminePreferenceKeys()
While  NextPreferenceKey() ; Пока находит ключи
    MessageRequester("Ключи группы 'window' ", PreferenceKeyName() + " = " + PreferenceKeyValue()) ; Отобразит ключ с его данными
Wend

; Закрывает файл настроек
ClosePreferences()

Поддерживаемые OS

Все