Класс QNetworkConfigurationManager

Класс QNetworkConfigurationManager управляет сетевыми конфигурациями, предоставляемыми системой. Подробнее...

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

Типы public

Функции public

• 34 функций public, унаследованных от QObject

Свойства public

• 1 свойство public, унаследованное от QObject

Сигналы

• 2 сигнала, унаследованных от QObject

Дополнительные унаследованные члены

• 1 свойство, унаследованное от QObject
• 1 переменная public, унаследованная от QObject
• 10 статических членов public, унаследованных от QObject
• 9 защищенных функций, унаследованных от QObject
• 2 защищенных переменных, унаследованных от QObject

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

Класс QNetworkConfigurationManager управляет сетевыми конфигурациями, предоставляемыми системой.

QNetworkConfigurationManager предоставляет доступ к сетевым конфигурациям, известным системе, и позволяет приложениям определять возможности системы (в отношении сетевых сессий) во время выполнения.

Класс QNetworkConfiguration абстрагирует набор параметров конфигурации, описывающих, как сетевой интерфейс должен быть настроен для подключения к конкретной целевой сети. QNetworkConfigurationManager сохраняет и обновляет глобальный список QNetworkConfigurations. Приложения могут получить доступ и отфильтровать этот список через всеКонфигурации(). Если новая конфигурация добавлена или существующая удалена или изменена, соответственно, испускаются сигналы конфигурацияДобавлена(), конфигурацияУдалена() и конфигурацияИзменена().

Метод по умолчаниюКонфигурация() может быть использован для немедленного создания новой сетевой сессии, не заботясь о конкретной конфигурации. Он возвращает конфигурацию типа QNetworkConfiguration::Discovered. Если нет обнаруженных конфигураций, возвращается недействительная конфигурация.

Некоторые обновления конфигураций могут потребовать некоторого времени для выполнения обновлений. Например, сканирование WLAN. Если платформа не выполняет внутренних обновлений, может потребоваться вручную запустить обновления конфигураций через обновитьКонфигурации(). Завершение процесса обновления указывается путем испускания сигнала обновлениеЗавершено(). Процесс обновления гарантирует, что каждый существующий экземпляр QNetworkConfiguration обновлен. Нет необходимости запрашивать обновленный список конфигураций через всеКонфигурации().

См. также QNetworkConfiguration.

Документация по типу члена

перечисление QNetworkConfigurationManager::Возможность QNetworkConfigurationManager::Возможности

Указывает возможности системы API носителя. Возможные значения:

Тип Возможности является псевдонимом для QFlags<Возможность>. Он хранит логическое ИЛИ сочетание значений Возможности.

Документация по функциям члена

QNetworkConfigurationManager::QNetworkConfigurationManager(QObject *parent = nullptr)

Создаёт объект QNetworkConfigurationManager с заданным parent.

Обратите внимание, что для обеспечения немедленной доступности списка текущих конфигураций обновление выполняется во время создания, что вызывает некоторую задержку.

[virtual] QNetworkConfigurationManager::~QNetworkConfigurationManager()

Освобождает ресурсы, связанные с объектом QNetworkConfigurationManager.

QList<QNetworkConfiguration> QNetworkConfigurationManager::allConfigurations(QNetworkConfiguration::StateFlags filter = ...) const

Возвращает список конфигураций, соответствующих заданному filter.

По умолчанию эта функция возвращает все (определённые и неопределённые) конфигурации.

Беспроводная сеть с определённым SSID может быть доступна только в определённой области, несмотря на то, что система имеет для неё допустимую конфигурацию. Поэтому флаг фильтра может использоваться для ограничения списка только обнаруженными и, возможно, подключёнными конфигурациями.

Если filter равен нулю, эта функция возвращает все возможные конфигурации.

Обратите внимание, что эта функция возвращает состояния всех конфигураций на момент вызова этой функции. Если, например, определена конфигурация типа WLAN, системе может потребоваться выполнить сканирование WLAN, чтобы определить, действительно ли она доступна. Для получения наиболее точного состояния следует использовать updateConfigurations() для обновления состояния каждой конфигурации. Обратите внимание, что такое обновление может потребовать некоторого времени. О его завершении сигнализируется сигналом updateCompleted(). В отсутствие обновления конфигурации эта функция возвращает наилучшую оценку на момент вызова. Поэтому, если конфигурации WLAN представляют интерес, рекомендуется вызвать updateConfigurations() один раз после создания экземпляра QNetworkConfigurationManager (сканирование WLAN занимает слишком много времени, чтобы выполнять его в конструкторе). После этого данные автоматически обновляются по мере получения системой любых изменений.

QNetworkConfigurationManager::Capabilities QNetworkConfigurationManager::capabilities() const

Возвращает возможности, поддерживаемые текущей платформой.

[signal] void QNetworkConfigurationManager::configurationAdded(const QNetworkConfiguration &config)

Этот сигнал испускается всякий раз, когда к системе добавляется новая сетевая конфигурация. Новая конфигурация задаётся параметром config.

[signal] void QNetworkConfigurationManager::configurationChanged(const QNetworkConfiguration &config)

Этот сигнал испускается при изменении состояния состояния config.

QNetworkConfiguration QNetworkConfigurationManager::configurationFromIdentifier(const QString &identifier) const

Возвращает QNetworkConfiguration для identifier; в противном случае возвращает недопустимую QNetworkConfiguration.

См. также QNetworkConfiguration::identifier().

[signal] void QNetworkConfigurationManager::configurationRemoved(const QNetworkConfiguration &config)

Этот сигнал испускается, когда конфигурация собирается быть удалена из системы. Удаляемая конфигурация, заданная параметром config, недействительна, но сохраняет имя и идентификатор.

QNetworkConfiguration QNetworkConfigurationManager::defaultConfiguration() const

Возвращает используемую по умолчанию конфигурацию. Эта функция всегда возвращает обнаруженную конфигурацию; в противном случае — недействительную конфигурацию.

В некоторых случаях может потребоваться вызвать updateConfigurations() и дождаться сигнала updateCompleted() перед вызовом этой функции.

См. также allConfigurations().

bool QNetworkConfigurationManager::isOnline() const

Возвращает true, если система считается подключённой к другому устройству через активный сетевой интерфейс; в противном случае возвращает false.

Это эквивалентно следующему фрагменту кода:

QNetworkConfigurationManager mgr;
QList<QNetworkConfiguration> activeConfigs = mgr.allConfigurations(QNetworkConfiguration::Active);
if (activeConfigs.count() > 0)
    Q_ASSERT(mgr.isOnline());
else
    Q_ASSERT(!mgr.isOnline());

См. также onlineStateChanged().

[signal] void QNetworkConfigurationManager::onlineStateChanged(bool isOnline)

Этот сигнал испускается при изменении состояния устройства с онлайн на офлайн или наоборот. isOnline представляет новое состояние устройства.

Состояние считается онлайн, пока allConfigurations(QNetworkConfiguration::Active) возвращает список с хотя бы одним элементом.

[signal] void QNetworkConfigurationManager::updateCompleted()

Этот сигнал испускается при завершении обновления конфигурации. Такое обновление может быть инициировано с помощью updateConfigurations().

[slot] void QNetworkConfigurationManager::updateConfigurations()

Инициализирует обновление всех конфигураций. Это может использоваться для инициализации сканирования WLAN или других длительных обновлений, которые могут потребоваться для получения правильного состояния конфигураций.

Этот вызов асинхронный. По завершении этого обновления испускается сигнал updateCompleted(). Если обнаружены новые конфигурации или старые были удалены или изменены, процесс обновления может вызвать испускание одного или нескольких сигналов configurationAdded(), configurationRemoved() и configurationChanged().

Если состояние конфигурации изменяется в результате этого обновления, все существующие экземпляры QNetworkConfiguration обновляются автоматически.

См. также allConfigurations().