MapPolygon (Type of variable)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Properties specific to the description of MapPolygon variables
WLanguage functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

MapPolygon (Type of variable)

In french: CartePolygone

The MapPolygon type is used to define the characteristics of a polygon to be drawn on the map displayed in a Map control. The characteristics of this polygon can be defined and changed using different WLanguage properties.

Remark: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.

Example

// Add a polygon to the Map control
MyPolygon is MapPolygon
FOR EACH PointPosition OF arrPositions
Add(MyPolygon.Point, PointPosition)
END
MyPolygon.LineColor = LightRed
MyPolygon.ActionClick = ClickProc
MapAddShape(MAP_MyMap, MyPolygon)

INTERNAL PROCÉDURE ClickProc(p is MapPolygon)
ToastDisplay(StringBuild("Click on the <%1> polygon.", p.Name))
END

Remarks

Properties specific to the description of MapPolygon variables

The following properties can be used to handle a polygon:

Property name	Type used	Effect

ActionClick	Procedure name	Name of the WLanguage procedure called when the user clicks the polygon displayed in the Map control. This procedure has the following format: PROCEDURE <Procedure name>(<Polygon>) where <Polygon> is a MapPolygon variable corresponding to the polygon that the user clicked on. If this property is not specified (or 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"). This procedure can be a Browser or Server procedure.
BackgroundColor	Color, integer, Integer constant	Polygon background color. This color can correspond to: an RGB color (returned by RGB), a WLanguage preset color, a variable of type Color. Remark: To change the opacity of the fill, you can write: MyMapPolygon.BackgroundColor.Opacity = 50
Description	Character string	Description of the shape, used to store additional information, for example.
Geodesic	Boolean	True to indicate that the drawing of the polygon must take into account the curvature of the Earth, False (default value) to draw a straight line. Not available.
Line	Integer constant	Line style used between the vertices of the polygon: LineSolid (default value): Solid line. LineDotted: Dots. LineDash: Dashes. LineDotAndDash: Dots and dashes. Not available.
LineColor	Color, integer, Integer constant	Polygon outline color. This color can correspond to: an RGB color (returned by RGB), a WLanguage preset color, a variable of type Color.
Name	Character string	Name of the shape (here, name of the polygon). A name is automatically assigned when the variable is created. It can be modified, but it has to be unique if the shape is added to the Map control. This name can be used to delete the polygon with MapDeleteShape.
Point	Array of geoPosition	Points corresponding to the vertices of the polygon. The polygon will be automatically closed, so the start and end points can be different.
Thickness	Integer	Line thickness used for the polygon outline. The thickness is set to 2 by default.
ZOrder	Integer	Z-order of the circle in relation to the other shapes in the Map control. Allows you to manage overlays. A shape with a high Z-order will be drawn over a shape with a lower Z-order. This property is set to 0 by default. This property is not available.

WLanguage functions

The following WLanguage functions are used to handle MapPolygon variables:


Versions 26 and later MapAddShape New in version 26 MapAddShape MapAddShape	Adds a new shape (polygon, line, circle) to the map displayed in a Map control.
Versions 26 and later MapModifyShape New in version 26 MapModifyShape MapModifyShape	Modifies a shape drawn on the map displayed in a Map control.
Versions 26 and later MapDeleteShape New in version 26 MapDeleteShape MapDeleteShape	Deletes a shape drawn on the map displayed in an Map control.