AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Controles, páginas y ventanas / Funciones Mapa
  • Propiedades específicas de las variables Marker
  • Funciones que utilizan las variables de Marker
  • Reinicio
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
El tipo Marker permite definir las características de un marcador ubicado en un mapa que se muestra en un control Mapa.
Un marcador se define por un nombre y una posición geográfica (latitud y longitud) y puede ser llenado con una description y una acción en el click.
Las características de esta Marker pueden definirse y modificarse mediante diferentes propiedades del lenguaje WL.
Observación: Para obtener más información sobre la declaración de este tipo de variable y el uso de propiedades WLanguage, consulte Declarar una variable.
Ejemplo
// Displays a marker and runs a procedure during a click on this marker
MyLocation is geoPosition
MyLocation.Latitude = 43.613708
MyLocation.Longitude = 3.876972
MyMarker is Marker
MyMarker.Position = MyLocation
MyMarker.ActionClick = ProcMarkerClick
 
MapAddMarker("MapControl", MyMarker)
//------------------------------------------
 
PROCEDURE ProcMarkerClick(m is Marker)
ToastDisplay(StringBuild("Position: %1 N, %2 E ", ...
m.Position.Latitude, m.Position.Longitude))
Observaciones

Propiedades específicas de las variables Marker

Las siguiente propiedades se pueden utilizar para manipular una variable de tipo Marker:
Nombre de la propiedadTipo utilizadoEfecto
ActionClickNombre de ProcedureNombre del WLanguage Procedure llamado cuando el usuario hace clic en el Marker mostrado en el control Mapa.
Este procedimiento tiene el siguiente formato:
PROCEDURE <Procedure name>(<Marker>)
donde <Marcador> es una variable de tipo Marker que corresponde al marcador en el que el usuario hizo clic.
Si esta Property corresponde a una cadena vacía (""), no se realizará ninguna acción al hacer clic.
Observación: se recomienda utilizar procedimientos globales. Si la Procedure es local, su nombre debe ir precedido del nombre completo del objeto al que pertenece la Procedure (ejemplo para una ventana local Procedure: "WIN_Window1.MyProcedure").
ActionClickPopupCadena de caracteresEl nombre del WLanguage Procedure llamado cuando el usuario hace clic en el popup de Marker.
Este procedimiento tiene el siguiente formato:
PROCEDURE <Procedure name>(<Marker>)
donde <Marcador> es una variable de tipo Marker que corresponde al marcador asociado a la popup.
Si esta Property corresponde a una cadena vacía (""), no se realizará ninguna acción al hacer clic.
ActionDragCadena de caracteresNombre del lenguaje WLanguage Procedure llamado cuando el usuario mueve el marcador mostrado en el control Mapa (si la propiedad Movable está establecida en True).
Este procedimiento tiene el siguiente formato:
PROCEDURE <Procedure name>(<Marker>)
donde <Marcador> es una variable de tipo Marker que corresponde al marcador movido.
Esta Procedure se llama cuando el usuario libera la Marker.
Si esta Property corresponde a una cadena vacía (""), no se realizará ninguna acción.
AlineaciónConstante de tipo IntegerModo para alinear la Marker cuando se muestra en un mapa:
  • mkBottom: Marker mostrada en la parte inferior de la posición.
  • mkCenter: Marker se muestra en la posición.
  • mkRight: Marker se muestra a la derecha de la posición.
  • mkLeft: Marker se muestra a la izquierda de la posición.
  • mkTop: Marker mostrada en la parte superior de la posición.
Clústerbooleano
  • True si la Marker se va a agrupar en un grupo si es necesario,
  • False en caso contrario.
Observación: Una nueva Event opcional está disponible: "Agrupación de marcadores".
  • Esta Event se ejecuta cada vez que se crea o modifica un cluster de Marker en la control Mapa.
  • Toma como parámetro una array de variables Marker. Esta array corresponde a las Marker s del cluster.
  • Este Event puede devolver una imagen o un MarkerImage Variable que se utilizará para representar el cluster en el mapa. Si esta Event no devuelve un valor (o devuelve una cadena vacía), el cúmulo se mostrará en modo Default.
denominarCadena de caracteresNombre de la Marker.
Observaciones:
  • Esta propiedad es opcional: si no se especifica un nombre, se asocia un nombre al azar con la Marker.
  • Si se muestra un popup, mostrará este nombre y el marcador description.
  • Al añadir una Marker con el mismo nombre que una Marker existente, MapAddMarker falla: el Marker no se añade.
descriptionCadena de caracteresdescription de la Marker, utilizada por ejemplo para almacenar la dirección correspondiente a la posición de la Marker.
El texto de esta description se utiliza en el popup de la Marker.
Esta propiedad es opcional.
ImageCadena de caracteres o MarkerImage Variable
  • La trayectoria de la imagen correspondiente al icono asociado a la Marker.
  • MarkerImage Variable utilizado para personalizar el Marker Image.
Si no se especifica esta Property, se usará la Default Image de la control Mapa. Esta imagen se puede especificar en la pestaña "General" de la ventana de control de description.
Observación: En el mapa, el icono asociado a la Marker se mostrará sólo Above la posición especificada.
Móvilesbooleano
  • True si la Marker puede ser movida por el usuario (Drag and Drop),
  • False en caso contrario.
Observación: Si el marcador es móvil, se dispone de una nueva Event opcional: "Mover marcador". Esta Event toma como parámetro la variable Marker asociada a la Marker movida. La posición geográfica asociada a la Marker se actualiza automáticamente.
NotaCualquier tipoSe utiliza para almacenar información adicional (no visible para el usuario) sobre la Marker.
OpacidadIntegroPorcentaje de opacidad de la Marker sobre la control Mapa.
iPhone/iPad La ventana emergente de Marker tiene en cuenta este porcentaje de opacidad.
ubicaciónVariable de tipo geoPositionPosición geográfica (latitud y longitud) en la que debe mostrarse la Marker.
Si no hay ninguna posición asociada al marcador, la Position Property volverá NULL
WithPopupbooleano
  • True si se puede mostrar un popup cuando se hace clic en el Marker,
  • False en caso contrario. El popup muestra el nombre (Name Property) y el description del marcador (description Property).
La ventana emergente puede personalizarse con las propiedades InternalPagePopup o InternalWindowPopup.
ZOrderIntegroZ-orden de la Marker en relación con las otras Marker s en la control Mapa. Le permite manejar las superposiciones.
Un Marker con un orden Z alto se dibujará sobre un Marker con un orden Z más bajo.
Este Property es set a 0 por Default.
iPhone/iPadIOS WidgetMac Catalyst Esta propiedad no está disponible.

Funciones que utilizan las variables de Marker

MapAddMarkerAñade una nueva Marker a un mapa mostrado en una control Mapa.
MapDeleteMarkerElimina una Marker de un mapa mostrado por una control Mapa.
MapModifyMarkerModifica un marcador mostrado en un control Map568

Reinicio

Puede utilizar la función VariableReset para reiniciar el contenido de una variable de tipo Marker.
Versión mínima requerida
  • Versión 17
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/01/2023

Señalar un error o enviar una sugerencia | Ayuda local