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'adresse 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 existe.

[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 est présente. Sinon, la valeur renvoyée sera invalide.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi setBackendProperty.

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

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

Retourne nullptr si le système n'a pas de source satellite par défaut, si aucun plugin valide n'a pu être trouvé ou si l'utilisateur n'a pas la permission d'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'adresse parent qui lit les sources de données satellite par défaut du système, ou le plugin avec la plus haute priorité disponible.

Elle renvoie nullptr si le système n'a pas de source satellite par défaut, si aucun plugin valide n'a pu être trouvé ou si l'utilisateur n'a pas la permission d'accéder aux informations satellite.

Cette méthode transmet 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'adresse parent, 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'adresse parent, en chargeant le plugin nommé sourceName.

Elle 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 satellites actuelles et d'émettre satellitesInViewUpdated() et satellitesInUseUpdated() avec ces informations. Si l'information satellite actuelle ne peut être trouvée dans le délai donné 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'attente est égal à zéro, il est fixé par défaut à une durée raisonnable correspondant à la source.

Cela ne fait rien si une autre demande de mise à jour est en cours. Cependant, elle peut être appelée même si startUpdates() a déjà été appelé et que des mises à jour régulières sont en cours.

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

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

Il s'agit des satellites utilisés pour obtenir un "point", c'est-à-dire pour déterminer la position actuelle.

Le paramètre satellites contient les satellites actuellement utilisés.

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

Si startUpdates() ou requestUpdate() est appelé, ce signal est émis lorsqu'une mise à jour des satellites actuellement en vue est disponible.

Le paramètre satellites contient les satellites actuellement en vue.

[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 à value. Retourne 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'information satellite au moment de l'exécution.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi backendProperty.

QString QGeoSatelliteInfoSource::sourceName() const

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

C'est ce même nom qui peut être transmis à createSource() afin de créer une nouvelle instance d'une implémentation particulière de source satellite.

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

Commence à émettre des mises à jour à intervalles réguliers. Les mises à jour seront fournies chaque fois que de nouvelles informations satellitaires seront disponibles.

Si les informations satellitaires ne peuvent être récupérées ou si une autre forme de dépassement de délai s'est produite, 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()

Arrête d'émettre des mises à jour à intervalles réguliers.