QML-тип VpnPlatformEditDialog
Базовый компонент для создания диалога редактирования свойств VPN-профиля. Подробнее…
| Строка импорта: | import Sailfish.Settings.Networking.VPN 1.0 |
| Наследуется от: | VpnEditDialog |
Свойства
- newTitle : string
- editTitle : string
- importTitle : string
- subtitle : string
- importPath : string
- vpnType : string
- firstAdditionalItem : Item
- vpnName : string
- validSettings : bool
Методы
- init()
- getProviderProperty(name)
- mergeProviderProperties(newProperties)
- saveConnection()
- updateProvider(name, value)
Подробное описание
Данный компонент должен быть корневым элементом компонента по редактированию свойств VPN-профиля, edit.qml. Данный компонент построен на базе диалога Silica и обладает соответствующим жизненным циклом.
При создании компонента необходимо вызвать метод init(). Затем необходимо считать значения свойств из VPN-профиля с помощью метода getProviderProperty() и настроить соответствующие графические элементы, созданные на диалоге редактирования.
При обработке сигнала accepted необходимо записать свойства из графических элементов в свойства VPN-профиля. Для записи одного значения можно использовать метод updateProvider и mergeProviderProperties. После обновления всех свойств VPN-профиля необходимо вызвать метод saveConnection для записи свойств.
На странице содержатся поля для ввода названия VPN-профиля и сетевого адреса VPN-сервера. По умолчанию VPN-профиль может быть сохранён, если оба этих поля заполнены. Можно сформировать новое условие, переопределив вычисляемое свойство validSettings.
Описание свойств
newTitle : string
Содержит название диалога, которое будет показано пользователю в случае добавления нового VPN-профиля.
В ранних версиях ОС следует использовать свойство title и newConnection.
editTitle : string
Содержит название диалога, которое будет показано пользователю в случае редактирования существующего VPN-профиля.
В ранних версиях ОС следует использовать свойство title и newConnection.
importTitle : string
Содержит название диалога, которое будет показано пользователю в случае показа диалога в режиме импортирования внешнего конфигурационного файла.
subtitle : string
Содержит подзаголовок диалога.
importPath : string
Путь к документу с внешним конфигурационным файлом, из которого необходимо импортировать конфигурацию.
vpnType : string
Название VPN-провайдера, для которого формируется VPN-профиль. Должно совпадать с названием провайдера, указанного в при определении Connman-плагина.
firstAdditonalItem : Item
Содержит ссылку на первое поле ввода, определённое внутри данного диалога. Это поле получит фокус в случае успешного завершения редактирования последнего обязательного поля на диалоге редактирования.
vpnName : string
Название VPN-профиля. Обычно заполняется пользователем через соответствующее поле ввода.
validSettings : bool
Значение данного свойства определяет: может ли пользователь завершить редактирование VPN-профиля, т.е. заполнены ли все обязательные поля. По умолчанию обязательными являются название VPN-профиля и адрес VPN-сервера.
Описание методов
init()
Данный метод инициализирует внутренние структуры диалога, которые необходимы ему для успешного выполнения своих обязанностей. При использовании данного компонента необходимо вызвать данный метод в момент создания компонента, в обработчике сигнала onCompleted.
getProviderProperty(name)
Метод позволяет получить значение свойства VPN-профиля. Обычно используется при инициализации компонента для заполнения значениями соответствующих графических элементов.
В качестве аргумента ему передаётся название интересующего свойства VPN-профиля.
mergeProviderProperties(newProperties)
Метод позволяет обновить набор свойств внутри VPN-профиля. Данному методу в качестве аргумента передаётся объект, содержащий пары название свойства и его значений.
saveConnection()
Метод сохраняет все текущие значения VPN-профиля в файл. Данный метод рекомендуется вызвать один раз в конце обработчика закрытия диалога.
updateProvider(name, value)
Метод позволяет записать в одно свойство VPN-профиля, name, новое значение, value. Данный метод обычно вызывается для сохранения значений, введённых пользователем, в VPN-профиль.