|
|
|
|
|
|
|
|
|
|
- Propriétés spécifiques à la description des variables de type Marqueur
- Fonctions utilisant les variables de type Marqueur
- Réinitialisation
Marqueur (Type de variable) En anglais : Marker
Le type Marqueur permet de définir les caractéristiques d'un marqueur à placer sur une carte affichée dans un champ Carte. Un marqueur est défini par un nom et une position géographique (latitude et longitude) et peut être complété par une description et une action sur le clic. Les caractéristiques de ce marqueur peuvent être définies et modifiées à l'aide de différentes propriétés WLangage. Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
// Affiche un marqueur avec exécution d'une procédure lors du clic sur ce marqueur
MaPosition est une géoPosition
MaPosition.Latitude = 43.613708
MaPosition.Longitude = 3.876972
MonMarqueur est un Marqueur
MonMarqueur.Position = MaPosition
MonMarqueur.ActionClic = ProcClicMarqueur
CarteAjouteMarqueur("ChampCarte", MonMarqueur) //------------------------------------------
PROCÉDURE ProcClicMarqueur(m est un Marqueur)
ToastAffiche(ChaîneConstruit("Position : %1 N, %2 E ", m.Position.Latitude, m.Position.Longitude)) Remarques Propriétés spécifiques à la description des variables de type Marqueur Les propriétés suivantes peuvent être utilisées pour manipuler une variable de type Marqueur : | | | | Nom de la propriété | Type manipulé | Effet |
|---|
| ActionClic | Nom de procédure | Nom de la procédure WLangage appelée lorsque l'utilisateur clique sur le marqueur affiché dans le champ Carte. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Marqueur>) où <Marqueur> est une variable de type Marqueur correspondant au marqueur sur lequel l'utilisateur a cliqué. Si cette propriété correspond à une chaîne vide (""), aucune action ne sera effectuée lors du clic. Remarque : il est conseillé d'utiliser des procédures globales. Si la procédure est une procédure locale, il est nécessaire de préfixer le nom de cette procédure par le nom complet de l'objet auquel appartient la procédure (exemple pour une procédure locale de fenêtre : "FEN_Fenêtre1.MaProcedure"). | | ActionClicPopup | Chaîne de caractères | Nom de la procédure WLangage appelée lorsque l'utilisateur clique sur la popup du marqueur. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Marqueur>) où <Marqueur> est une variable de type Marqueur correspondant au marqueur associé à la popup. Si cette propriété correspond à une chaîne vide (""), aucune action ne sera effectuée lors du clic. | | ActionDéplacement | Chaîne de caractères | Nom de la procédure WLangage appelée lorsque l'utilisateur déplace le marqueur affiché dans le champ Carte (si la propriété Déplaçable est à Vrai). Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Marqueur>) où <Marqueur> est une variable de type Marqueur correspondant au marqueur déplacé. Cette procédure est appelée au moment où l'utilisateur relâche le marqueur. Si cette propriété correspond à une chaîne vide (""), aucune action ne sera effectuée. | | Alignement | Constante de type Entier | Mode d'alignement du marqueur lorsqu'il est affiché sur une carte : - mqBas : Marqueur affiché en bas de la position.
- mqCentre : Marqueur affiché sur la position.
- mqDroite : Marqueur affiché à droite de la position.
- mqGauche : Marqueur affiché à gauche de la position.
- mqHaut : Marqueur affiché en haut de la position.
| | Altitude | Entier | Altitude du marqueur par rapport aux autres marqueurs présents dans le champ Carte. Permet de gérer les superpositions. Un marqueur avec une altitude élevée sera dessiné par-dessus un marqueur avec une altitude inférieure. Par défaut, cette propriété vaut 0. | | AvecPopup | Booléen | - Vrai si une popup peut être affichée lors du clic sur le marqueur,
- Faux dans le cas contraire.
La popup affiche le nom (propriété Nom) et la description du marqueur (propriété Description).
Il est possible de personnaliser la popup avec la propriété PageInternePopup ou FenêtreInternePopup. | | Cluster | Booléen | - Vrai si le marqueur doit être regroupé en cluster si nécessaire,
- Faux dans le cas contraire.
Remarque : Un nouvel événement optionnel est disponible : "Regroupement de marqueurs". - Cet événement est exécuté à chaque fois qu'un cluster de marqueurs est créé ou modifié sur le champ Carte.
- Il reçoit en paramètre un tableau de variables de type Marqueur correspondant aux marqueurs présents dans le cluster.
- Cet événement peut renvoyer une image ou une variable de type MarqueurImage qui sera utilisée pour représenter le cluster sur la carte. Si cet événement ne renvoie pas de valeur (ou renvoie une chaîne vide), l'affichage par défaut des clusters sera utilisé.
| | Déplaçable | Booléen | - Vrai si le marqueur peut être déplacé par l'utilisateur (via Drag and Drop),
- Faux dans le cas contraire.
Remarque : Si le marqueur est déplaçable, un nouvel événement optionnel est disponible : "Déplacement d'un marqueur". Cet événement reçoit en paramètre la variable Marqueur associée au marqueur déplacé. La position géographique associée au marqueur est automatiquement mise à jour. | | Description | Chaîne de caractères | Description du marqueur, utilisée par exemple pour stocker l'adresse correspondant à la position du marqueur. Le texte de cette description est utilisée dans la popup du marqueur. Cette propriété est optionnelle. | | Image | Chaîne de caractères ou variable de type MarqueurImage | - Chemin de l'image correspondant à l'icône associée au marqueur.
- Variable de type MarqueurImage permettant de personnaliser l'image du marqueur.
Si cette propriété n'est pas spécifiée, l'image par défaut du champ Carte sera utilisée. Cette image est spécifiée dans l'onglet "Général" de la fenêtre de description du champ. Remarque : Sur la carte, l'icône associée au marqueur sera affichée juste au-dessus de la position spécifiée. | | Nom | Chaîne de caractères | Nom du marqueur. Remarques : - Cette propriété n'est pas obligatoire : si aucun nom n'est précisé, un nom aléatoire est associé au marqueur.
- Si une popup est affichée, cette popup affiche ce nom et la description du marqueur.
- Lors de l'ajout sur une carte d'un marqueur portant le même nom qu'un marqueur existant, la fonction CarteAjouteMarqueur échoue : le marqueur n'est pas ajouté.
| | Note | Tout type | Permet de mémoriser des informations additionnelles sur le marqueur qui ne seront pas visibles par l'utilisateur. | | Opacité | Entier | Pourcentage d'opacité de l'affichage du marqueur sur le champ Carte. | | Position | Variable de type géoPosition | Position géographique (latitude et longitude) à laquelle doit être affiché le marqueur. Si aucune position n'est associée au marqueur, la propriété Position retournera NULL. |
Fonctions utilisant les variables de type Marqueur Réinitialisation Pour réinitialiser le contenu d'une variable de type Marqueur, il est possible d'utiliser la fonction VariableRAZ.
Liste des exemples associés :
|
Exemples multiplateforme (WINDEV Mobile) : WM Geolocalisation
[ + ] Cet exemple présente comment gérer des recherches de proximité avec géolocalisation : - recherche autour de moi - recherche dans une ville, à une adresse donnée, proche d'une adresse. Les résultats apparaissent dans une zone répétée et dans une carte avec des marqueurs.
|
|
Exemples multiplateforme (WINDEV Mobile) : WM Sports
[ + ] Cet exemple est une application de sport vous permettant d'enregistrer vos performances. L'application calcule la distance parcourue, le temps, la vitesse moyenne et le nombre de calories dépensées en fonction du sport pratiqué. Le parcours réalisé est affiché sur un champ carte grâce à des marqueurs et un tracé d'itinéraire. Si vous disposez d'une montre Apple Watch, vous pourrez piloter WM Sports avec votre montre ! L'exemple dispose aussi d'une partie serveur qui sert à la synchronisation des données des utilisateurs. Ce webservice est disponible dans l'exemple WEBDEV "WW_Sports".
|
|
Exemples didactiques (WINDEV) : WD Carte Etendue
[ + ] Cet exemple montre de manière didactique les différentes fonctionnalités du champ Carte en version desktop (Windows) et mobile (Android, IOS) avec notamment l'utilisation des clusters, marqueurs et fonctions de dessin sur carte.
|
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|