Модуль community.general.xfconf — изменение конфигураций XFCE4

channel

string / обязательный

Канал настроек Xfconf — это ключ дерева верхнего уровня в хранилище Xfconf, соответствующий расположению, в котором хранятся все свойства/ключи приложений. См. man xfconf-query(1).

force_array

псевдонимы: array

boolean

добавлено в community.general 1.0.0

Принудительно использовать массив, даже если в нём только один элемент.

Варианты:

• false ← (по умолчанию)
• true

property

string / обязательный

Ключ настроек Xfce — это элемент в хранилище Xfconf, соответствующий настройке приложения. См. man xfconf-query(1).

state

string

Действие, выполняемое над свойством/значением.

Состояние get удалено в community.general 5.0.0. Вместо него используйте модуль community.general.xfconf_info.

Xfce4 может иметь и обычно имеет значения по умолчанию, поставляемые с системными пакетами. Для этих свойств по умолчанию можно задать новые значения и переопределить их. Однако при использовании state=absent модуль выполняет команду xfconf-query reset для указанного свойства, которая удаляет только свойства, настроенные пользователем. Поэтому такие свойства не удаляются, а возвращаются к значениям по умолчанию.

Варианты:

• "present" ← (по умолчанию)
• "absent"

value

list / элементы=any

Значения свойств настроек обычно имеют простой тип: строки, целые числа или списки строк и целых чисел. См. man xfconf-query(1).

value_type

list / элементы=string

Тип задаваемого значения.

При указании нескольких value_type длина списка должна совпадать с длиной value.

Если указан только один value_type, но value содержит более одного элемента, этот value_type применяется ко всем элементам value.

Если задаваемое property является массивом и в нём может быть только один элемент, необходимо использовать force_array=true, чтобы xfconf-query интерпретировал значение как массив, а не как скаляр.

Поддержка uchar, char, uint64 и int64 добавлена в community.general 4.8.0.

Варианты:

• "string"
• "int"
• "double"
• "bool"
• "uint"
• "uchar"
• "char"
• "uint64"
• "int64"
• "float"

check_mode

Поддержка: полная

Может работать в режиме check_mode и возвращать прогноз статуса изменений, не изменяя целевой объект.

diff_mode

Поддержка: полная

В режиме сравнения возвращает сведения об изменениях (или возможных изменениях в check_mode).

channel

string

Канал, указанный в параметрах модуля.

Возвращается: при успехе

Пример: "xsettings"

cmd

list / элементы=string

добавлено в community.general 5.4.0

Список команд xfconf-query, выполненных модулем.

Возвращается: при успехе

Пример: ["/usr/bin/xfconf-query", "--channel", "xfce4-panel", "--property", "/plugins/plugin-19/timezone", "--create", "--type", "string", "--set", "Pacific/Auckland"]

previous_value

any

Значение ключа настройки до выполнения модуля. Для массивов это отдельная строка или список строк.

Это строка или список строк.

Возвращается: при успехе

Пример: "\"96\" or [\"red\", \"blue\", \"green\"]"

property

string

Свойство, указанное в параметрах модуля.

Возвращается: при успехе

Пример: "/Xft/DPI"

value

any

Значение ключа настройки после выполнения модуля. Для массивов это отдельная строка или список строк.

Это строка или список строк.

Возвращается: при успехе

Пример: "'192' or ['orange', 'yellow', 'violet']"

value_type

any

Тип изменённого значения (none для state=reset). Для массивов это отдельная строка или список строк.

Это строка или список строк.

Возвращается: при успехе

Пример: "\"int\" or [\"str\", \"str\", \"str\"]"

version

string

добавлено в community.general 10.2.0

Версия команды xfconf-query.

Возвращается: при успехе

Пример: "4.18.1"