QNetworkInformation Class
QNetworkInformation stellt verschiedene Netzwerkinformationen über native Backends zur Verfügung. Mehr...
| Kopfzeile: | #include <QNetworkInformation> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Network)target_link_libraries(mytarget PRIVATE Qt6::Network) |
| qmake: | QT += network |
| Seit: | Qt 6.1 |
| Vererbt: | QObject |
Öffentliche Typen
| enum class | Feature { Reachability, CaptivePortal, TransportMedium, Metered } |
| flags | Features |
| enum class | Reachability { Unknown, Disconnected, Local, Site, Online } |
(since 6.3) enum class | TransportMedium { Unknown, Ethernet, Cellular, WiFi, Bluetooth } |
Eigenschaften
(since 6.2)isBehindCaptivePortal : const bool(since 6.3)isMetered : const bool- reachability : const Reachability
(since 6.3)transportMedium : const TransportMedium
Öffentliche Funktionen
| QString | backendName() const |
| bool | isBehindCaptivePortal() const |
| bool | isMetered() const |
| QNetworkInformation::Reachability | reachability() const |
(since 6.3) QNetworkInformation::Features | supportedFeatures() const |
| bool | supports(QNetworkInformation::Features features) const |
| QNetworkInformation::TransportMedium | transportMedium() const |
Signale
| void | isBehindCaptivePortalChanged(bool state) |
| void | isMeteredChanged(bool isMetered) |
| void | reachabilityChanged(QNetworkInformation::Reachability newReachability) |
| void | transportMediumChanged(QNetworkInformation::TransportMedium current) |
Statische öffentliche Mitglieder
| QStringList | availableBackends() |
| QNetworkInformation * | instance() |
(since 6.4) bool | loadBackendByFeatures(QNetworkInformation::Features features) |
(since 6.4) bool | loadBackendByName(QStringView backend) |
(since 6.3) bool | loadDefaultBackend() |
Detaillierte Beschreibung
QNetworkInformation bietet eine plattformübergreifende Schnittstelle zu netzwerkbezogenen Informationen über Plugins.
Verschiedene Plugins können verschiedene Funktionalitäten unterstützen, und so können Sie Plugins laden(), je nachdem, welche Funktionen benötigt werden.
QNetworkInformation ist ein Singleton und bleibt vom ersten erfolgreichen load() bis zur Zerstörung des QCoreApplication Objekts erhalten. Wenn Sie das QCoreApplication Objekt zerstören und neu erstellen, müssen Sie load() erneut aufrufen.
Siehe auch QNetworkInformation::Feature.
Dokumentation der Mitgliedstypen
enum class QNetworkInformation::Feature
flags QNetworkInformation::Features
Listet alle Features auf, die ein Plugin derzeit unterstützen kann. Dies kann in QNetworkInformation::load() verwendet werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
QNetworkInformation::Feature::Reachability | 0x1 | Wenn das Plugin diese Funktion unterstützt, liefert die Eigenschaft reachability nützliche Ergebnisse. Andernfalls wird immer Reachability::Unknown zurückgegeben. Siehe auch QNetworkInformation::Reachability. |
QNetworkInformation::Feature::CaptivePortal | 0x2 | Wenn das Plugin diese Funktion unterstützt, wird die Eigenschaft isBehindCaptivePortal nützliche Ergebnisse liefern. Andernfalls wird sie immer false zurückgeben. |
QNetworkInformation::Feature::TransportMedium | 0x4 | Wenn das Plugin diese Funktion unterstützt, wird die Eigenschaft transportMedium nützliche Ergebnisse liefern. Andernfalls wird sie immer TransportMedium::Unknown zurückgeben. Siehe auch QNetworkInformation::TransportMedium. |
QNetworkInformation::Feature::Metered | 0x8 | Wenn das Plugin diese Funktion unterstützt, wird die Eigenschaft isMetered nützliche Ergebnisse liefern. Andernfalls wird sie immer false zurückgeben. |
Der Typ Features ist ein Typedef für QFlags<Feature>. Er speichert eine ODER-Kombination von Feature-Werten.
enum class QNetworkInformation::Reachability
| Konstante | Wert | Beschreibung |
|---|---|---|
QNetworkInformation::Reachability::Unknown | 0 | Wenn dieser Wert zurückgegeben wird, kann es sein, dass wir verbunden sind, aber das Betriebssystem noch nicht die volle Konnektivität bestätigt hat, oder diese Funktion nicht unterstützt wird. |
QNetworkInformation::Reachability::Disconnected | 1 | Zeigt an, dass das System möglicherweise überhaupt keine Verbindung hat. |
QNetworkInformation::Reachability::Local | 2 | Zeigt an, dass das System mit einem Netzwerk verbunden ist, aber möglicherweise nur auf Geräte im lokalen Netzwerk zugreifen kann. |
QNetworkInformation::Reachability::Site | 3 | Zeigt an, dass das System mit einem Netzwerk verbunden ist, aber möglicherweise nur auf Geräte im lokalen Subnetz oder einem Intranet zugreifen kann. |
QNetworkInformation::Reachability::Online | 4 | Zeigt an, dass das System mit einem Netzwerk verbunden ist und auf das Internet zugreifen kann. |
Siehe auch QNetworkInformation::reachability.
[since 6.3] enum class QNetworkInformation::TransportMedium
Listet die derzeit anerkannten Medien auf, mit denen man sich mit dem Internet verbinden kann.
| Konstante | Wert | Beschreibung |
|---|---|---|
QNetworkInformation::TransportMedium::Unknown | 0 | Wird zurückgegeben, wenn entweder das Betriebssystem kein aktives Medium meldet, das aktive Medium von Qt nicht erkannt wird oder die TransportMedium-Funktion nicht unterstützt wird. |
QNetworkInformation::TransportMedium::Ethernet | 1 | Zeigt an, dass die derzeit aktive Verbindung über Ethernet besteht. Hinweis: Dieser Wert kann auch zurückgegeben werden, wenn Windows mit einem Bluetooth Personal Area Network verbunden ist. |
QNetworkInformation::TransportMedium::Cellular | 2 | Zeigt an, dass die derzeit aktive Verbindung ein Mobilfunknetz verwendet. |
QNetworkInformation::TransportMedium::WiFi | 3 | Zeigt an, dass die derzeit aktive Verbindung Wi-Fi verwendet. |
QNetworkInformation::TransportMedium::Bluetooth | 4 | Zeigt an, dass die derzeit aktive Verbindung über Bluetooth hergestellt wird. |
Dieses Enum wurde in Qt 6.3 eingeführt.
Siehe auch QNetworkInformation::transportMedium.
Dokumentation der Eigenschaft
[read-only, since 6.2] isBehindCaptivePortal : const bool
Zeigt an, ob sich das Gerät des Benutzers hinter einem firmeneigenen Portal befindet.
Diese Eigenschaft zeigt an, ob das Gerät des Benutzers derzeit bekannt ist, dass es sich hinter einem firmeneigenen Portal befindet. Diese Funktionalität beruht auf der Erkennung von Captive Portals durch das Betriebssystem und wird auf Systemen, die dies nicht melden, nicht unterstützt. Auf Systemen, auf denen dies nicht unterstützt wird, wird immer false zurückgegeben.
Diese Eigenschaft wurde in Qt 6.2 eingeführt.
Zugriffsfunktionen:
| bool | isBehindCaptivePortal() const |
Benachrichtigungssignal:
| void | isBehindCaptivePortalChanged(bool state) |
[read-only, since 6.3] isMetered : const bool
Prüfen, ob die aktuelle Verbindung gebührenpflichtig ist
Diese Eigenschaft gibt zurück, ob die aktuelle Verbindung (bekanntermaßen) gebührenpflichtig ist oder nicht. Sie können dies als Richtwert verwenden, um zu entscheiden, ob Ihre Anwendung bestimmte Netzwerkanforderungen oder Uploads durchführen soll. Zum Beispiel möchten Sie vielleicht keine Protokolle oder Diagnosen hochladen, während diese Eigenschaft true lautet.
Diese Eigenschaft wurde in Qt 6.3 eingeführt.
Zugriffsfunktionen:
| bool | isMetered() const |
Notifier-Signal:
| void | isMeteredChanged(bool isMetered) |
[read-only] reachability : const Reachability
Diese Eigenschaft enthält den aktuellen Zustand der Netzkonnektivität des Systems.
Sie gibt den Grad der Konnektivität an, der erwartet werden kann. Bitte beachten Sie, dass dies nur auf dem basiert, was das Plugin/Betriebssystem meldet. In bestimmten Szenarien ist dies bekanntermaßen falsch. Unter Windows zum Beispiel wird die Online-Prüfung standardmäßig von Windows durchgeführt, das sich mit einem Microsoft-eigenen Server verbindet. Wenn dieser Server aus irgendeinem Grund blockiert ist, wird angenommen, dass er nicht online erreichbar ist. Aus diesem Grund sollten Sie dies nicht als Vorabprüfung verwenden, bevor Sie versuchen, eine Verbindung herzustellen.
Zugriffsfunktionen:
| QNetworkInformation::Reachability | reachability() const |
Benachrichtigungssignal:
| void | reachabilityChanged(QNetworkInformation::Reachability newReachability) |
[read-only, since 6.3] transportMedium : const TransportMedium
Diese Eigenschaft enthält das derzeit aktive Transportmedium für die Anwendung
Diese Eigenschaft gibt das derzeit aktive Transportmedium für die Anwendung auf Betriebssystemen zurück, auf denen diese Information verfügbar ist.
Wenn sich das aktuelle Transportmedium ändert, wird ein Signal ausgegeben. Dies kann beispielsweise der Fall sein, wenn ein Benutzer die Reichweite eines WiFi Netzwerks verlässt, sein Ethernetkabel abzieht oder den Flugzeugmodus aktiviert.
Diese Eigenschaft wurde in Qt 6.3 eingeführt.
Zugriffsfunktionen:
| QNetworkInformation::TransportMedium | transportMedium() const |
Notifier Signal:
| void | transportMediumChanged(QNetworkInformation::TransportMedium current) |
Member Function Dokumentation
[static] QStringList QNetworkInformation::availableBackends()
Gibt eine Liste mit den Namen aller derzeit verfügbaren Backends zurück.
QString QNetworkInformation::backendName() const
Gibt den Namen des aktuell geladenen Backends zurück.
[static] QNetworkInformation *QNetworkInformation::instance()
Liefert einen Zeiger auf die Instanz von QNetworkInformation, falls vorhanden.
Siehe auch load().
[static, since 6.4] bool QNetworkInformation::loadBackendByFeatures(QNetworkInformation::Features features)
Lädt ein Backend, das features unterstützt.
Gibt true zurück, wenn es gelungen ist, das angeforderte Backend zu laden oder wenn es bereits geladen wurde. Gibt andernfalls false zurück.
Diese Funktion wurde in Qt 6.4 eingeführt.
Siehe auch instance.
[static, since 6.4] bool QNetworkInformation::loadBackendByName(QStringView backend)
Versucht, ein Backend zu laden, dessen Name mit backend übereinstimmt (Groß- und Kleinschreibung wird nicht beachtet).
Gibt true zurück, wenn es gelungen ist, das angeforderte Backend zu laden oder wenn es bereits geladen wurde. Gibt andernfalls false zurück.
Diese Funktion wurde in Qt 6.4 eingeführt.
Siehe auch instance.
[static, since 6.3] bool QNetworkInformation::loadDefaultBackend()
Versucht, das Standard-Backend der Plattform zu laden.
Hinweis: Ab 6.7 wird versucht, ein beliebiges Backend zu laden, das Reachability unterstützt, wenn das Plattform-Standard-Backend nicht verfügbar ist oder nicht geladen werden kann. Wenn auch dies fehlschlägt, wird auf ein Backend zurückgegriffen, das nur die Standardwerte für alle Eigenschaften zurückgibt.
Diese Plattform-Plugin-Zuordnung ist wie folgt:
| Plattform | Plugin-Name |
|---|---|
| Windows | Netzwerklisten-Manager |
| Apple (macOS/iOS) | scnetworkreachability |
| Android | android |
| Linux | Netzwerkmanager |
Diese Funktion dient der Bequemlichkeit, wenn die vorherige Logik ausreichend ist. Wenn Sie ein bestimmtes Plugin benötigen, sollten Sie stattdessen loadBackendByName() oder loadBackendByFeatures() direkt aufrufen.
Ermittelt ein geeignetes Backend zum Laden und gibt true zurück, wenn dieses Backend bereits geladen ist oder wenn es erfolgreich geladen wurde. Gibt false zurück, wenn ein anderes Backend bereits geladen wurde, oder wenn das Laden des ausgewählten Backends fehlschlägt.
Diese Funktion wurde in Qt 6.3 eingeführt.
Siehe auch instance() und load().
[since 6.3] QNetworkInformation::Features QNetworkInformation::supportedFeatures() const
Gibt alle unterstützten Features des aktuellen Backends zurück.
Diese Funktion wurde in Qt 6.3 eingeführt.
bool QNetworkInformation::supports(QNetworkInformation::Features features) const
Gibt true zurück, wenn das aktuell geladene Backend features unterstützt.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
