QGeoSatelliteInfoSource Class

// Emit updates every 10 seconds if available
QGeoSatelliteInfoSource *source = QGeoSatelliteInfoSource::createDefaultSource(0);
if (source)
    source->setUpdateInterval(10000);

Dokumentation der Mitgliedsfunktionen

[virtual noexcept] QGeoSatelliteInfoSource::~QGeoSatelliteInfoSource()

Zerstört die Satellitenquelle.

[static] QStringList QGeoSatelliteInfoSource::availableSources()

Gibt eine Liste der verfügbaren Quell-Plugins zurück, einschließlich des Standard-System-Backends, falls eines vorhanden ist.

[virtual, since 6.2] QVariant QGeoSatelliteInfoSource::backendProperty(const QString &name) const

Gibt den Wert der Backend-spezifischen Eigenschaft namens name zurück, falls vorhanden. Andernfalls ist der zurückgegebene Wert ungültig.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch setBackendProperty.

[static] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createDefaultSource(QObject *parent)

Erstellt und gibt eine Quelle mit der angegebenen parent zurück, die von der Standardquelle des Systems für Satellitenaktualisierungsinformationen oder dem verfügbaren Plugin mit der höchsten Priorität liest.

Gibt nullptr zurück, wenn das System keine Standard-Satellitenquelle hat, keine gültigen Plugins gefunden werden konnten oder der Benutzer nicht über die Berechtigung zum Zugriff auf die Satellitendaten verfügt.

[static, since Qt 5.14] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createDefaultSource(const QVariantMap &parameters, QObject *parent)

Erstellt und gibt eine Satellitenquelle mit der angegebenen parent zurück, die aus den Standardquellen des Systems für Satellitendaten oder dem Plugin mit der höchsten verfügbaren Priorität liest.

Gibt nullptr zurück, wenn das System keine Standard-Satellitenquelle hat, keine gültigen Plugins gefunden werden konnten oder der Benutzer nicht die Berechtigung hat, auf die Satelliteninformationen zuzugreifen.

Diese Methode übergibt parameters an die Factory, um die Quelle zu konfigurieren.

Diese Funktion wurde in Qt 5.14 eingeführt.

[static] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createSource(const QString &sourceName, QObject *parent)

Erzeugt und liefert eine Quelle mit der angegebenen parent, indem das Plugin mit dem Namen sourceName geladen wird.

Gibt nullptr zurück, wenn das Plugin nicht gefunden wird.

[static, since Qt 5.14] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createSource(const QString &sourceName, const QVariantMap &parameters, QObject *parent)

Erzeugt eine Satellitenquelle mit der angegebenen parent und gibt sie zurück, indem das Plugin mit dem Namen sourceName geladen wird.

Gibt nullptr zurück, wenn das Plugin nicht gefunden werden kann.

Diese Methode übergibt parameters an die Fabrik, um die Quelle zu konfigurieren.

Diese Funktion wurde in Qt 5.14 eingeführt.

[pure virtual] QGeoSatelliteInfoSource::Error QGeoSatelliteInfoSource::error() const

Gibt den zuletzt aufgetretenen Fehler zurück.

[signal] void QGeoSatelliteInfoSource::errorOccurred(QGeoSatelliteInfoSource::Error satelliteError)

Dieses Signal wird ausgegeben, wenn ein Fehler aufgetreten ist. Der Parameter satelliteError beschreibt die Art des aufgetretenen Fehlers.

[pure virtual slot] void QGeoSatelliteInfoSource::requestUpdate(int timeout = 0)

Versucht, die aktuellen Satelliteninformationen zu erhalten und sendet satellitesInViewUpdated() und satellitesInUseUpdated() mit diesen Informationen. Wenn die aktuellen Satelliteninformationen nicht innerhalb der angegebenen timeout (in Millisekunden) gefunden werden können oder wenn timeout kleiner ist als der von minimumUpdateInterval() zurückgegebene Wert, wird ein errorOccurred()-Signal mit UpdateTimeoutError gesendet.

Ist die Zeitüberschreitung gleich Null, wird die Zeitüberschreitung auf eine für die Quelle angemessene Zeitspanne zurückgesetzt.

Dies hat keine Auswirkungen, wenn eine andere Aktualisierungsanforderung im Gange ist. Sie kann jedoch auch dann aufgerufen werden, wenn startUpdates() bereits aufgerufen wurde und regelmäßige Aktualisierungen im Gange sind.

[signal] void QGeoSatelliteInfoSource::satellitesInUseUpdated(const QList<QGeoSatelliteInfo> &satellites)

Wenn startUpdates() oder requestUpdate() aufgerufen wird, wird dieses Signal ausgegeben, wenn eine Aktualisierung der Anzahl der derzeit verwendeten Satelliten verfügbar ist.

Dies sind die Satelliten, die zur Bestimmung der aktuellen Position verwendet werden.

Der Parameter satellites enthält die aktuell genutzten Satelliten.

[signal] void QGeoSatelliteInfoSource::satellitesInViewUpdated(const QList<QGeoSatelliteInfo> &satellites)

Wenn startUpdates() oder requestUpdate() aufgerufen wird, wird dieses Signal ausgegeben, wenn eine Aktualisierung für die derzeit angezeigten Satelliten verfügbar ist.

Der Parameter satellites enthält die aktuell angezeigten Satelliten.

[virtual, since 6.2] bool QGeoSatelliteInfoSource::setBackendProperty(const QString &name, const QVariant &value)

Setzt die Backend-spezifische Eigenschaft namens name auf value. Gibt bei Erfolg true zurück, andernfalls false. Backend-spezifische Eigenschaften können verwendet werden, um das Verhalten des Satelliteninfo-Subsystems zur Laufzeit zu konfigurieren.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch backendProperty.

QString QGeoSatelliteInfoSource::sourceName() const

Gibt den eindeutigen Namen der verwendeten Satellitenquellen-Implementierung zurück.

Dies ist derselbe Name, der an createSource() übergeben werden kann, um eine neue Instanz einer bestimmten Satellitenquellen-Implementierung zu erstellen.

[pure virtual slot] void QGeoSatelliteInfoSource::startUpdates()

Beginnt in regelmäßigen Abständen mit der Ausgabe von Updates. Die Aktualisierungen werden immer dann bereitgestellt, wenn neue Satelliteninformationen verfügbar sind.

Wenn Satelliteninformationen nicht abgerufen werden können oder eine andere Form der Zeitüberschreitung aufgetreten ist, können die Signale satellitesInViewUpdated() und satellitesInUseUpdated() mit leeren Parameterlisten ausgegeben werden.

Siehe auch satellitesInViewUpdated() und satellitesInUseUpdated().

[pure virtual slot] void QGeoSatelliteInfoSource::stopUpdates()

Beendet die regelmäßige Ausgabe von Updates.