Address QML Type
Le type QML Adresse représente un lieu spécifique sous la forme d'une adresse de rue. Plus d'informations...
| Import Statement: | import QtPositioning |
Propriétés
- address : QGeoAddress
- city : string
- country : string
- countryCode : string
- county : string
- district : string
- isTextGenerated : bool
- postalCode : string
- state : string
- street : string
- streetNumber : string
(since QtPositioning 6.2) - text : string
Description détaillée
Une adresse est utilisée comme unité de données pour des requêtes telles que le géocodage (inversé) ou les recherches de lieux - beaucoup de ces opérations acceptent une adresse ou en renvoient une.
Toutes les propriétés d'une adresse ne sont pas nécessairement disponibles ou pertinentes dans toutes les parties du monde et dans tous les lieux. Les propriétés district, state et county sont particulièrement spécifiques à une région pour de nombreuses sources de données, et souvent seulement une ou deux d'entre elles sont disponibles ou utiles.
L'adresse possède une propriété text qui contient une chaîne formatée. Il s'agit de la méthode recommandée pour afficher une adresse à l'utilisateur et elle prend généralement le format d'une adresse figurant sur une enveloppe, mais ce n'est pas toujours le cas. La propriété text peut être générée automatiquement à partir de propriétés d'adresse constitutives telles que street, city et ainsi de suite, mais elle peut également être attribuée explicitement. Voir text pour plus de détails.
Exemple d'utilisation
L'extrait de code suivant montre la déclaration d'un objet Adresse.
Address { id: address street: "53 Brandl St" city: "Eight Mile Plains" country: "Australia" countryCode: "AUS" }
Cet objet peut ensuite être utilisé, par exemple, comme valeur d'une requête de géocodage, pour obtenir la longitude et la latitude exactes de l'adresse.
Voir également QGeoAddress.
Documentation sur la propriété
address : QGeoAddress |
Pour plus de détails sur la manière d'utiliser cette propriété pour établir une interface entre C++ et QML, voir"Interfaces entre le code C++ et QML".
city : string |
Cette propriété contient la ville de l'adresse sous la forme d'une chaîne formatée unique.
country : string |
Cette propriété contient le pays de l'adresse sous la forme d'une seule chaîne formatée.
countryCode : string |
Cette propriété contient le code pays de l'adresse sous la forme d'une seule chaîne formatée.
county : string |
Cette propriété contient le comté de l'adresse sous la forme d'une seule chaîne formatée.
district : string |
Cette propriété contient le district de l'adresse sous la forme d'une seule chaîne formatée.
isTextGenerated : bool |
postalCode : string |
Cette propriété contient le code postal de l'adresse sous la forme d'une seule chaîne formatée.
state : string |
Cette propriété contient l'état de l'adresse sous la forme d'une seule chaîne formatée.
street : string |
Cette propriété contient la rue de l'adresse.
Remarque : avant Qt6, cette propriété pouvait également contenir des éléments tels qu'un numéro d'unité, un nom de bâtiment ou tout autre élément permettant de distinguer une adresse d'une autre. Depuis Qt6, la propriété streetNumber est utilisée pour ce type d'informations.
streetNumber : string |
Cette propriété contient le numéro de rue de l'adresse, ainsi qu'un numéro d'unité, un nom de bâtiment ou tout autre élément permettant de distinguer une adresse d'une autre.
Cette propriété a été introduite dans QtPositioning 6.2.
text : string |
Cette propriété contient l'adresse sous la forme d'une seule chaîne formatée. C'est la chaîne recommandée pour afficher l'adresse à l'utilisateur. Elle prend généralement le format d'une adresse telle qu'on la trouve sur une enveloppe, mais ce n'est pas toujours le cas.
L'adresse text est soit générée automatiquement, soit attribuée explicitement, ce qui peut être déterminé en vérifiant isTextGenerated.
Si une chaîne vide est attribuée à text, alors isTextGenerated sera mis à vrai et text renverra une chaîne formatée localement selon countryCode et basée sur les propriétés de l'adresse. La modification des propriétés de l'adresse, telles que street, city et ainsi de suite, peut entraîner une modification du contenu de text.
Si une chaîne non vide est attribuée à text, isTextGenerated sera défini comme faux et text renverra toujours la chaîne explicitement attribuée. La modification des propriétés d'adresse n'affecte pas la propriété text.
© 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.