DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Carte
  • Propriétés spécifiques à la description des variables de type CarteImage
  • Fonctions WLangage
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Une variable de type CarteImage permet de définir les caractéristiques d'une image à dessiner sur la carte affichée dans un champ Carte. Les caractéristiques de cette image 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.
Exemple
// Ajout d'une image dans le champ Carte
i est un CarteImage
i.Position = MaPosition
i.Image = "image.png"
i.ActionClic = ProcClic
CarteAjouteImage(CARTE_MaCarte, i)
 
PROCÉDURE INTERNE ProcClic(i est un CarteImage)
ToastAffiche(ChaîneConstruit("Clic sur l'image <%1>.", i.Nom))
FIN
Remarques

Propriétés spécifiques à la description des variables de type CarteImage

Les propriétés suivantes peuvent être utilisées pour manipuler une image dans un champ Carte :
Nom de la propriétéType manipuléEffet
ActionClicNom de procédureNom de la procédure WLangage appelée lorsque l'utilisateur clique sur l'image affichée dans le champ Carte. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Image>)
où <Image> est une variable de type CarteImage correspondant à l'image sur laquelle l'utilisateur a cliqué.
Si cette propriété n'est pas renseignée (ou 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").
WEBDEV - Code ServeurWEBDEV - Code Navigateur Cette procédure peut être une procédure Navigateur ou Serveur.
AlignementConstante de type EntierAlignement de l'image par rapport à la position donnée par la propriété Position :
  • mqHaut : image au dessus de la position.
  • mqBas : image en dessous de la position.
  • mqCentre (Valeur par défaut) : image centrée sur la position.
  • mqDroite : image à droite de la position.
  • mqGauche : image à gauche de la position.
AltitudeEntierAltitude de l'image par rapport aux autres formes présentes dans le champ Carte. Permet de gérer les superpositions.
Une forme avec une altitude élevée sera dessiné par-dessus une forme avec une altitude inférieure.
Par défaut, cette propriété vaut 0.
iPhone/iPad Cette propriété n'est pas disponible.
AngleEntierAngle en degrés de rotation (compris entre 0 et 360) à appliquer à la l'image. La rotation est effectuée en utilisant la position donnée par la propriété Position comme centre de rotation.
Par défaut, cette propriété vaut 0.
DescriptionChaîne de caractèresDescription de l'image, utilisée par exemple pour stocker des informations additionnelles.
HauteurRéelHauteur (en mètres) que doit occuper l'image sur la carte.
Si cette propriété n'est pas renseignée ou vaut 0, la hauteur sera automatiquement calculée en fonction de la largeur spécifiée via la propriété Largeur en respectant le ratio de l'image.
ImageChaîne de caractères
ou variable Image
Image à afficher. Cette propriété correspond :
  • soit à une chaîne de caractères correspondant au chemin de l'image,
  • soit à une variable de type Image.
Cette image ne peut pas être une image vectorielle (SVG).
LargeurRéelLargeur (en mètres) que doit occuper l'image sur la carte.
Cette propriété est obligatoire.
NomChaîne de caractèresNom de l'image. Un nom est automatiquement attribué lors de la création de la variable. Il peut être modifié mais il doit être unique en cas d'ajout dans le champ Carte. Ce nom peut être utilisé pour supprimer l'image avec la fonction CarteSupprimeImage.
OpacitéEntierPourcentage d'opacité utilisée pour le dessin de l'image, compris entre 0 et 100. Par défaut, cette propriété vaut 100.
PositiongéoPositionPosition géographique à laquelle l'image doit être dessinée. L'alignement de l'image par rapport à cette position est donné par la propriété Alignement.

Fonctions WLangage

Les fonctions WLangage manipulant des variables de type CarteImage sont les suivantes :
CarteAjouteImageAjoute une nouvelle image sur la carte affichée dans un champ Carte.
CarteModifieImageModifie une image dessinée sur la carte affichée dans un champ Carte.
CarteSupprimeImageSupprime une image dessinée sur la carte affichée dans un champ Carte.
Version minimum requise
  • Version 26
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale