QGeoSatelliteInfoSource Class

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

Dokumentation zu Mitgliedsfunktionen

[explicit] QGeoSatelliteInfoSource::QGeoSatelliteInfoSource(QObject *parent)

Erstellt eine Satellitenquelle mit der angegebenen „ parent “.

[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 standardmäßigen System-Backends, sofern eines verfügbar ist.

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

Gibt den Wert der backend-spezifischen Eigenschaft „ name “ zurück, sofern diese vorhanden ist. 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 dem angegebenen „ parent “ zurück, die aus der Standardquelle des Systems für Satellitenaktualisierungen oder aus dem 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 keine Berechtigung zum Zugriff auf die Satellitendaten hat.

[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 aus 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 keine Berechtigung zum Zugriff auf die Satelliteninformationen hat.

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)

Erstellt und gibt eine Quelle mit der angegebenen „ parent “ zurück, indem das Plugin mit dem Namen „ sourceName “ geladen wird.

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

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

Erstellt und gibt eine Satellitenquelle mit dem angegebenen „ parent “ 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 Factory, 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, nachdem 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 Satellitendaten abzurufen, und sendet mit diesen Daten die Signale „ satellitesInViewUpdated “ () und „ satellitesInUseUpdated “ () aus. Wenn die aktuellen Satellitendaten nicht innerhalb der angegebenen Zeit „ timeout “ (in Millisekunden) gefunden werden können oder wenn „ timeout “ kleiner ist als der von „ minimumUpdateInterval “ () zurückgegebene Wert, wird ein Signal „ errorOccurred “ () mit „ UpdateTimeoutError “ ausgegeben.

Wenn die Zeitüberschreitung Null ist, wird standardmäßig eine für die Quelle angemessene Zeitüberschreitungsdauer verwendet.

Dies hat keine Auswirkungen, wenn gerade eine andere Aktualisierungsanforderung läuft. Die Methode kann jedoch auch aufgerufen werden, wenn startUpdates() bereits aufgerufen wurde und reguläre Aktualisierungen laufen.

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

Wenn „ startUpdates()“ oder „ requestUpdate()“ aufgerufen wird, wird dieses Signal ausgegeben, sobald eine Aktualisierung der Anzahl der derzeit genutzten Satelliten vorliegt.

Dies sind die Satelliten, die zur Positionsbestimmung verwendet werden – also diejenigen, mit denen die aktuelle Position ermittelt wird.

Der Parameter ` satellites ` enthält die derzeit verwendeten Satelliten.

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

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

Der Parameter ` satellites ` enthält die derzeit sichtbaren Satelliten.

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

Setzt die backend-spezifische Eigenschaft „ 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 derzeit 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()

Es werden in regelmäßigen Abständen Aktualisierungen gesendet. Die Aktualisierungen werden bereitgestellt, sobald neue Satellitendaten verfügbar sind.

Wenn keine Satellitendaten abgerufen werden können oder eine andere Art von Zeitüberschreitung aufgetreten ist, können die Signale „ satellitesInViewUpdated()“ und „ satellitesInUseUpdated()“ mit leeren Parameterlisten ausgelöst werden.

Siehe auch „ satellitesInViewUpdated()“ und „ satellitesInUseUpdated()“.

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

Beendet die Ausgabe von Aktualisierungen in regelmäßigen Abständen.