QML-тип ConfigurationGroup

Предоставляет доступ к группе значений конфигурации Подробнее...

Строка импорта: import Nemo.Configuration 1.0

Свойства

Сигналы

Методы

  • void clear()
  • void setValue(string key, variant value)
  • void sync()
  • variant value(string key, variant defaultValue, int typeHint)

Подробное описание

Тип ConfigurationGroup предоставляет доступ к группе ключей DConf, которая определяется путем path. Объекты ConfigurationGroup могут быть вложены друг в друга. В таком случае путь path будет задан относительно пути родительского объекта ConfigurationGroup.

Доступ к значениям ключей можно получить с помощью методов value() и setValue(). Уведомления об изменении значений транслируются посредством сигналов valueChanged и valuesChanged.

Свойства, объявленные в объекте ConfigurationGroup, будут синхронизироваться с одноименными ключами DConf. Поскольку имена свойства в QML должны начинаться со строчной буквы, данный метод не может обеспечить доступ ко всем ключам. В случае, если название ключа начинается с прописной буквы, для доступа к нему следует использовать методы value() и setValue().

Описание свойств

path : string

Содержит путь к группе ключей конфигурации. Если текущий объект ConfigurationGroup является дочерним элементом другого объекта ConfigurationGroup, то путь path следует указывать относительно пути path родительского объекта группы.

scope : ConfigurationGroup

Содержит область видимости родительского объекта группы ключей. Значение свойства path указывается относительно значения path области видимости родительского объекта.

Данное свойства задается автоматически при создании вложенных объектов ConfigurationGroup.

synchronous : bool

Определяет, используется ли синхронный доступ.

Значение по умолчанию: false.

Описание сигналов

valueChanged(key)

Испускается при изменении значения ключа key.

valuesChanged()

Испускается при изменении значений в группе ключей. При этом не важно, значение какого именно ключа изменилось.

Описание методов

void clear()

Очищает все значения ключей в группе.

void setValue(string key, variant value)

Задает значение value ключу key.

void sync()

Принудительно синхронизирует значения всех ключей.

variant value(string key, variant defaultValue, int typeHint)

Возвращает значение ключа key. Если ключ key не существует, будет возвращено значение defaultValue. Значение ключа будет преобразовано согласно значению идентификатора метатипа typeHint, если оно задано.