QGeoSatelliteInfoSource Class

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

Documentation des fonctions membres

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

Crée une source satellite avec l'parent spécifiée.

[virtual noexcept] QGeoSatelliteInfoSource::~QGeoSatelliteInfoSource()

Détruit la source satellite.

[static] QStringList QGeoSatelliteInfoSource::availableSources()

Renvoie une liste des plugins source disponibles, y compris le backend système par défaut s'il en existe un.

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

Renvoie la valeur de la propriété spécifique au backend nommée « name », si elle existe. Sinon, la valeur renvoyée sera invalide.

Cette fonction a été introduite dans Qt 6.2.

Voir également setBackendProperty.

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

Crée et renvoie une source avec l'parent spécifiée, qui lit les informations de mise à jour par satellite à partir de la source par défaut du système ou du plugin disponible ayant la priorité la plus élevée.

Renvoie « nullptr » si le système ne dispose pas de source Satellite par défaut, si aucun plugin valide n'a pu être trouvé ou si l'utilisateur ne dispose pas des autorisations nécessaires pour accéder aux données Satellite.

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

Crée et renvoie une source satellite avec l’ parent spécifiée, qui s’alimente à partir des sources de données satellite par défaut du système ou du plugin ayant la priorité la plus élevée parmi ceux disponibles.

Renvoie ` nullptr ` si le système ne dispose d'aucune source satellite par défaut, si aucun plugin valide n'a pu être trouvé ou si l'utilisateur ne dispose pas des autorisations nécessaires pour accéder aux informations satellites.

Cette méthode transmet l'parameters à l'usine pour configurer la source.

Cette fonction a été introduite dans Qt 5.14.

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

Crée et renvoie une source avec l'parent spécifiée, en chargeant le plugin nommé sourceName.

Renvoie nullptr si le plugin est introuvable.

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

Crée et renvoie une source satellite avec l'parent fournie, en chargeant le plugin nommé sourceName.

Renvoie ` nullptr ` si le plugin est introuvable.

Cette méthode transmet parameters à la fabrique pour configurer la source.

Cette fonction a été introduite dans Qt 5.14.

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

Renvoie la dernière erreur survenue.

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

Ce signal est émis lorsqu'une erreur s'est produite. Le paramètre « satelliteError » décrit le type d'erreur qui s'est produite.

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

Tente d'obtenir les informations actuelles sur le satellite et émet les signaux satellitesInViewUpdated() et satellitesInUseUpdated() avec ces informations. Si les informations actuelles sur le satellite ne peuvent pas être trouvées dans le délai timeout (en millisecondes) ou si timeout est inférieur à la valeur renvoyée par minimumUpdateInterval(), un signal errorOccurred() avec UpdateTimeoutError est émis.

Si le délai d’expiration est égal à zéro, il prend par défaut une valeur raisonnable adaptée à la source.

Cette méthode n’a aucun effet si une autre requête de mise à jour est en cours. Elle peut toutefois être appelée même si la méthode startUpdates() a déjà été appelée et que des mises à jour régulières sont en cours.

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

Si la fonction startUpdates() ou requestUpdate() est appelée, ce signal est émis lorsqu'une mise à jour est disponible concernant le nombre de satellites actuellement utilisés.

Il s'agit des satellites utilisés pour obtenir un « positionnement », c'est-à-dire ceux qui servent à déterminer la position actuelle.

Le paramètre satellites contient la liste des satellites actuellement utilisés.

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

Si la fonction ` startUpdates()` ou ` requestUpdate()` est appelée, ce signal est émis lorsqu'une mise à jour est disponible pour les satellites actuellement visibles.

Le paramètre satellites contient la liste des satellites actuellement visibles.

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

Définit la propriété spécifique au backend nommée « name » sur la valeur « value ». Renvoie « true » en cas de succès, « false » dans le cas contraire. Les propriétés spécifiques au backend peuvent être utilisées pour configurer le comportement du sous-système d'informations satellite lors de l'exécution.

Cette fonction a été introduite dans Qt 6.2.

Voir également backendProperty.

QString QGeoSatelliteInfoSource::sourceName() const

Renvoie le nom unique de l'implémentation de source satellite actuellement utilisée.

Il s’agit du même nom que celui qui peut être transmis à la méthode createSource() afin de créer une nouvelle instance d’une implémentation de source satellite particulière.

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

Commence à diffuser des mises à jour à intervalles réguliers. Les mises à jour seront fournies dès que de nouvelles informations satellitaires seront disponibles.

Si les informations satellite ne peuvent pas être récupérées ou si un délai d'attente a expiré, les signaux ` satellitesInViewUpdated()` et ` satellitesInUseUpdated()` peuvent être émis avec des listes de paramètres vides.

Voir également satellitesInViewUpdated() et satellitesInUseUpdated().

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

Cesse d'émettre des mises à jour à intervalles réguliers.