PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | French EN
  • Properties specific to the description of Marker variables
  • Functions that use the Marker variables
  • Reinitialization
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
The Marker type is used to define the characteristics of a marker that must be positioned on a map displayed in a Map control.
A marker is defined by a name and a geographical position (latitude and longitude) and it can be filled with a description and an action on the click.
The characteristics of this marker can be defined and modified using different WLanguage properties.
Remark: See Declaring a variable for more details on the declaration of this type of variable and the use of WLanguage properties.
Versions 18 and later
iPhone/iPad This type of variable is now available for iPhone/iPad applications.
New in version 18
iPhone/iPad This type of variable is now available for iPhone/iPad applications.
iPhone/iPad This type of variable is now available for iPhone/iPad applications.
Versions 20 and later
WINDEVWindows This type of variable is now available for the WINDEV applications in Windows.
WEBDEV - Browser code This type of variable is now available in Browser code.
WEBDEV - Server codeWindowsLinuxAjax This type of variable is now available for WEBDEV sites in Windows and in Linux.
PHP This type of variable is now available for PHP WEBDEV sites.
New in version 20
WINDEVWindows This type of variable is now available for the WINDEV applications in Windows.
WEBDEV - Browser code This type of variable is now available in Browser code.
WEBDEV - Server codeWindowsLinuxAjax This type of variable is now available for WEBDEV sites in Windows and in Linux.
PHP This type of variable is now available for PHP WEBDEV sites.
WINDEVWindows This type of variable is now available for the WINDEV applications in Windows.
WEBDEV - Browser code This type of variable is now available in Browser code.
WEBDEV - Server codeWindowsLinuxAjax This type of variable is now available for WEBDEV sites in Windows and in Linux.
PHP This type of variable is now available for PHP WEBDEV sites.
Versions 21 and later
Universal Windows 10 App This type of variable is now available for applications in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This type of variable is now available for applications in Universal Windows 10 App mode.
Universal Windows 10 App This type of variable is now available for applications in Universal Windows 10 App mode.
Example
// Displays a marker and runs a procedure during a click on this marker
MyPosition is geoPosition
MyPosition.Latitude = 43.613708
MyPosition.Longitude = 3.876972
MyMarker is Marker
MyMarker.Position = MyPosition
MyMarker.ActionClick = ProcMarkerClick
 
MapAddMarker("MapControl", MyMarker)
//------------------------------------------
 
PROCEDURE ProcMarkerClick(m is Marker)
ToastDisplay(StringBuild("Position: %1 N, %2 E ", ...
m.Position.Latitude, m.Position.Longitude))
Remarks

Properties specific to the description of Marker variables

The following properties can be used to handle a Marker variable:
Property nameType usedEffect
ActionClickProcedure nameName of the WLanguage procedure called when the user clicks the marker displayed in the Map control.
This procedure has the following format:
PROCEDURE <Procedure name>(<Marker>)
where <Marker> is a Marker variable corresponding to the marker that was clicked by the user.
If this property corresponds to an empty string (""), no action will be performed on click.
Remark: it is recommended to use global procedures. If the procedure is local, its name must be prefixed by the full name of the object to which the procedure belongs (example for a local window procedure: "WIN_Window1.MyProcedure").
Versions 20 and later
WEBDEV - Server codeWEBDEV - Browser code This procedure can be a Browser or Server procedure.
New in version 20
WEBDEV - Server codeWEBDEV - Browser code This procedure can be a Browser or Server procedure.
WEBDEV - Server codeWEBDEV - Browser code This procedure can be a Browser or Server procedure.
Versions 26 and later
ActionClickPopup
New in version 26
ActionClickPopup
ActionClickPopup
Character stringName of the WLanguage procedure called when the user clicks the marker popup.
This procedure has the following format:
PROCEDURE <Procedure name>(<Marker>)
where <Marker> is a Marker variable corresponding to the marker associated with the popup.
If this property corresponds to an empty string (""), no action will be performed on click.
WEBDEV - Server codeWEBDEV - Browser code This procedure can be a Browser or Server procedure.
Versions 26 and later
ActionDrag
New in version 26
ActionDrag
ActionDrag
Character stringName of the WLanguage procedure called when the user moves the marker displayed in the Map control (if the Movable property is set to True).
This procedure has the following format:
PROCEDURE <Procedure name>(<Marker>)
where <Marker> is a Marker variable corresponding to the moved marker.
This procedure is called when the user releases the marker.
If this property corresponds to an empty string (""), no action will be performed.
WEBDEV - Server codeWEBDEV - Browser code This procedure can be a Browser or Server procedure.
Versions 21 and later
Alignment
New in version 21
Alignment
Alignment
Integer constantMode for aligning the marker when it is displayed on a map:
  • mkBottom: Marker displayed at the bottom of the position.
  • mkCenter: Marker displayed on the position.
  • mkRight: Marker displayed on the right of the position.
  • mkLeft: Marker displayed on the left of the position.
  • mkTop: Marker displayed at the top of the position.
Versions 26 and later
ZOrder
New in version 26
ZOrder
ZOrder
IntegerZ-order of the marker in relation to the other markers in the Map control. Allows you to manage overlays.
A marker with a high z-order will be drawn over a marker with a lower z-order.
This property is set to 0 by default.
iPhone/iPad This property is not available.
Versions 26 and later
WithPopup
New in version 26
WithPopup
WithPopup
Boolean
  • True if a popup can be displayed when the marker is clicked on,
  • False otherwise.
The popup displays the name (Name property) and the description of the marker (Description property).
Versions 26 and later
Cluster
New in version 26
Cluster
Cluster
Boolean
  • True if the marker is to be grouped in a cluster if necessary,
  • False otherwise.
Remark: A new optional event is available: "Grouping of markers".
  • This event is run each time a marker cluster is created or modified on the Map control.
  • It takes an array of Marker variables as parameter. This array corresponds to the markers in the cluster.
  • This event can return an image or a MarkerImage variable that will be used to represent the cluster on the map. If this event does not return a value (or returns an empty string), the cluster will be displayed in default mode.
Versions 26 and later
Moveable
New in version 26
Moveable
Moveable
Boolean
  • True if the marker can be moved by the user (Drag and Drop),
  • False otherwise.
Remark: If the marker is moveable, a new optional event is available: "Move marker". This event takes as parameter the Marker variable associated with the moved marker. The geographic position associated with the marker is automatically updated.
DescriptionCharacter stringDescription of the marker, used for example to store the address corresponding to the position of the marker.
Versions 26 and later
The text of this description is used in the marker popup.
New in version 26
The text of this description is used in the marker popup.
The text of this description is used in the marker popup.
This property is optional.
ImageCharacter string or MarkerImage variable
  • Path of the image corresponding to the icon associated with the marker.
  • Versions 26 and later
    MarkerImage variable used to customize the marker image.
    New in version 26
    MarkerImage variable used to customize the marker image.
    MarkerImage variable used to customize the marker image.
If this property is not specified, the default image of the Map control will be used. This image can be specified in the "General" tab of the control description window.
Remark: On the map, the icon associated with the marker will be displayed just above the specified position.
NameCharacter stringName of the marker.
Remarks:
  • This property is optional: if no name is specified, a random name is associated with the marker.
  • Versions 26 and later
    If a popup is displayed, it will display this name and the marker description.
    New in version 26
    If a popup is displayed, it will display this name and the marker description.
    If a popup is displayed, it will display this name and the marker description.
  • When adding a marker named like an existing marker, MapAddMarker fails: the marker is not added.
Versions 26 and later
Remark
New in version 26
Remark
Remark
Any typeUsed to store additional information (not be visible to the user) about the marker.
Versions 26 and later
Opacity
New in version 26
Opacity
Opacity
IntegerPercentage of opacity of the marker on the Map control.
PositiongeoPosition variableGeographical position (latitude and longitude) at which the marker must be displayed.
If no position is associated with the marker, the Position property will return NULL

Functions that use the Marker variables

Versions 17 and later
MapAddMarker
New in version 17
MapAddMarker
MapAddMarker
Adds a new marker onto a map displayed in a Map control.
Versions 17 and later
MapDeleteMarker
New in version 17
MapDeleteMarker
MapDeleteMarker
Deletes a marker from a map displayed by a Map control
Versions 17 and later
MapModifyMarker
New in version 17
MapModifyMarker
MapModifyMarker
Modifies a marker displayed in a Map control.

Reinitialization

You can use VariableReset to reinitialize the content of a Marker variable.
Related Examples:
WM Geolocation Cross-platform examples (WINDEV Mobile): WM Geolocation
[ + ] This example explains how to perform proximity searches with geolocation :
- search around me
- search in a city, at a given address, or close to a specific address.
The results are displayed in a looper and in a map with markers.
WM Sports Cross-platform examples (WINDEV Mobile): WM Sports
[ + ] This example is a sport application used to save your performances.
The application calculates the distance, the time, the average speed and the number of calories spent according to the sport.
The run is displayed on a map control via markers and an itinerary.

The example also includes a server part used to synchronize the user data.
This webservice is available in the WEBDEV "WW_Sports" example.
Minimum version required
  • Version 17
This page is also available for…
Comments
Click [Add] to post a comment