Класс QNetworkInformation

Класс QNetworkInformation предоставляет различные сведения о сети через родные бэкэнды. Подробнее...

Заголовок:	#include <QNetworkInformation>
CMake:	find_package(Qt6 COMPONENTS Network REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake:	QT += network
С тех пор:	Qt 6.1
Наследует:	QObject

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

Общие типы

перечисление	Feature { Доступность }
флаги	Features
перечисление	Доступность { Неизвестно, Отключено, Локально, Сайт, Онлайн }

Свойства

доступность : const Доступность

Общедоступные функции

QString	имяБэкэнда() const
QNetworkInformation::Доступность	доступность() const
bool	поддерживает(QNetworkInformation::Features features) const

Сигналы

void	измениласьДоступность(QNetworkInformation::Доступность newReachability)

Статические общедоступные члены

QStringList	доступныеБэкэнды()
QNetworkInformation *	экземпляр()
bool	загрузить(QStringView backend)
bool	загрузить(QNetworkInformation::Features features)

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

QNetworkInformation предоставляет кроссплатформенный интерфейс к информации о сети через плагины.

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

QNetworkInformation является синглтоном и существует с первого успешного загрузки() до уничтожения объекта QCoreApplication. Если вы уничтожаете и создаете заново объект QCoreApplication, вы должны снова вызвать загрузить().

См. также QNetworkInformation::Feature.

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

перечисление QNetworkInformation::Featureфлаги QNetworkInformation::Features

Перечисляет все функции, которые может в настоящее время поддерживать плагин. Это можно использовать в QNetworkInformation::load().

Константа	Значение	Описание
`QNetworkInformation::Feature::Reachability`	`0x1`	Если плагин поддерживает эту функцию, то свойство `reachability` будет доступно. См. также QNetworkInformation::Reachability.

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

перечисление QNetworkInformation::Доступность

Константа	Значение	Описание
`QNetworkInformation::Reachability::Unknown`	`0`	Если возвращается это значение, значит, мы можем быть подключены, но ОС все еще не подтвердила полное подключение, или эта функция не поддерживается.
`QNetworkInformation::Reachability::Disconnected`	`1`	Указывает, что система, возможно, вообще не подключена к сети.
`QNetworkInformation::Reachability::Local`	`2`	Указывает, что система подключена к сети, но она может иметь доступ только к устройствам в локальной сети.
`QNetworkInformation::Reachability::Site`	`3`	Указывает, что система подключена к сети, но она может иметь доступ только к устройствам в локальном подсети или в интрасети.
`QNetworkInformation::Reachability::Online`	`4`	Указывает, что система подключена к сети и имеет доступ к Интернету.

См. также QNetworkInformation::доступность.

Документация по свойствам

`[read-only]` доступность : const Доступность

Это свойство содержит текущее состояние сетевого подключения системы.

Указывает уровень ожидаемой подключенности. Обратите внимание, что это основано только на том, что сообщает плагин/операционная система. В некоторых сценариях это известно как неправильное. Например, в Windows проверка «Онлайн» по умолчанию выполняется путем подключения Windows к серверу Microsoft. Если по какой-либо причине этот сервер заблокирован, система предположит, что нет доступности Онлайн. Поэтому не используйте это как предварительную проверку перед попыткой подключения.

Функции доступа:

QNetworkInformation::Доступность доступность() const

Сигналы уведомлений:

void	измениласьДоступность(QNetworkInformation::Доступность newReachability)

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

`[static]` QStringList QNetworkInformation::доступныеБэкэнды()

Возвращает список имен всех доступных в настоящее время бэкэндов.

QString QNetworkInformation::имяБэкэнда() const

Возвращает имя текущего загруженного бэкэнда.

`[static]` QNetworkInformation *QNetworkInformation::экземпляр()

Возвращает указатель на экземпляр QNetworkInformation, если таковой имеется.

См. также загрузить().

`[static]` bool QNetworkInformation::загрузить(QStringView backend)

Пытается загрузить бэкэнд, имя которого соответствует backend (регистронезависимо).

Возвращает true если удалось загрузить запрошенный бэкэнд или если он уже был загружен. Возвращает false в противном случае

См. также экземпляр.

`[static]` bool QNetworkInformation::загрузить(QNetworkInformation::Features features)

Загружает бэкэнд, который поддерживает features.