Address QML Type

Le type QML « Address » représente un lieu précis sous la forme d'une adresse postale. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

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 la recherche de lieux ; bon nombre 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 partout dans le monde et dans toutes les configurations régionales. Les propriétés district, state et county sont particulièrement spécifiques à certaines zones pour de nombreuses sources de données, et souvent, seules une ou deux d’entre elles sont disponibles ou utiles.

L’objet Address dispose d’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 ; elle reprend généralement le format d’une adresse telle qu’elle figure 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, etc., 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 Address.

Address {
    id: address
    street: "53 Brandl St"
    city: "Eight Mile Plains"
    country: "Australia"
    countryCode: "AUS"
}

Celui-ci peut ensuite être utilisé, par exemple, comme valeur d’une requête de géocodage, afin d’obtenir la longitude et la latitude exactes de l’adresse.

Voir également QGeoAddress.

Documentation sur les propriétés

address : QGeoAddress

Pour plus de détails sur la manière d'utiliser cette propriété afin d'assurer l'interfaçage entre le C++ et le QML, consultez la section «Interfaces entre le code C++ et le code QML ».

city : string

Cette propriété contient le nom de la ville correspondant à l'adresse sous la forme d'une chaîne de caractères formatée.

country : string

Cette propriété contient le pays correspondant à l'adresse sous la forme d'une chaîne de caractères formatée unique.

countryCode : string

Cette propriété contient le code pays de l'adresse sous la forme d'une chaîne de caractères formatée unique.

county : string

Cette propriété contient le nom du département correspondant à l'adresse sous la forme d'une chaîne de caractères formatée.

district : string

Cette propriété contient le nom du quartier correspondant à l'adresse sous la forme d'une chaîne de caractères formatée unique.

isTextGenerated : bool

Cette propriété contient une valeur booléenne qui, si elle est vraie, indique que l'text est générée automatiquement à partir des propriétés d'adresse. Si elle est fausse, cela signifie que l'text a été explicitement attribuée.

postalCode : string

Cette propriété contient le code postal de l'adresse sous la forme d'une chaîne de caractères formatée unique.

state : string

Cette propriété contient l'état de l'adresse sous la forme d'une chaîne de caractères formatée unique.

street : string

Cette propriété contient le nom de la rue correspondant à l'adresse.

streetNumber : string [since QtPositioning 6.2]

Cette propriété contient le numéro de rue de l'adresse, tel qu'un numéro d'appartement, le nom d'un immeuble 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 chaîne de caractères formatée. Il s'agit de la chaîne recommandée pour afficher l'adresse à l'utilisateur. Elle reprend généralement le format d'une adresse telle qu'elle figure 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 ; pour le savoir, il suffit de vérifier la valeur de isTextGenerated.

Si une chaîne vide est attribuée à ` text`, alors ` isTextGenerated ` sera défini sur `true` et ` text ` renverra une chaîne formatée localement selon ` countryCode ` et en fonction des propriétés de l'adresse. La modification des propriétés de l'adresse telles que ` street`, ` city `, etc. peut entraîner une modification du contenu de ` text `.

Si une chaîne non vide est attribuée à text, alors isTextGenerated sera défini sur false et text renverra toujours la chaîne explicitement attribuée. La modification des propriétés de l'adresse n'affectera pas la propriété text.