QML-тип ConfigurationGroup

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

Строка импорта:

import Nemo.Configuration 1.0

• Список всех членов класса, включая унаследованные

Свойства

• path : string
• scope : ConfigurationGroup
• synchronous : bool

Сигналы

• valueChanged(key)
• valuesChanged()

Методы

• 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, если оно задано.