MapDisplayPosition (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

MapDisplayPosition (Function)

In french: CarteAffichePosition

Centers the map displayed in a Map control on a geographical position or on a specific location. An animation is automatically performed.

At the end of the animation, the event "Whenever changing position" of the Map control will be run. This event will not be run if the positioning on the map is canceled by the user before the end of the animation.

Versions 20 and later

This function is now available for the WINDEV applications in Windows.

This function is now available in Browser code.

This function is now available for the WEBDEV sites in Windows and in Linux.

This function is now available for PHP sites.

New in version 20

This function is now available for the WINDEV applications in Windows.

This function is now available in Browser code.

This function is now available for the WEBDEV sites in Windows and in Linux.

This function is now available for PHP sites.

This function is now available for the WINDEV applications in Windows.

This function is now available in Browser code.

This function is now available for the WEBDEV sites in Windows and in Linux.

This function is now available for PHP sites.

Example

See additional examples

// Centers the map displayed by the "MAP_Position" control on a geographical position
MyPosition is geoPosition
MapDisplayPosition(MAP_Position, MyPosition)

// equivalent syntax (without animation): MAP_Position = MyPosition

// Centers the map displayed by the "MAP_Position" control on a city identified by its name
MapDisplayPosition(MAP_Position, "Montpellier, France")

// Centers the map displayed by the "MAP_Position" control on a monument identified by its name
MapDisplayPosition(MAP_Position, "Eiffel Tower")

Syntax

Versions 20 and later

Displaying a geographical location with check procedure Hide the details

MapDisplayPosition(<Map control> , <Position> [, <WLanguage procedure>])

<Map control>: Control name

Name of Map control to use. If this parameter corresponds to an empty string (""), the Map control to which the current event belongs will be used.

<Position>: geoPosition variable or character string

Description of the location on which the map will be centered. This description can correspond to:
the name of the geoPosition variable describing the geographical position on which the map will be centered.
a character string containing an address, a city, the name of a monument, ...
an Address variable.

<WLanguage procedure>: Optional character string (with quotes)

Name of the WLanguage procedure ("callback" procedure) called once the new geographical position is displayed. This procedure has the following format:

PROCEDURE <Procedure name> (<Change performed>)

where <Change performed> is a boolean:
True if the position was modified,
False otherwise.
This parameter is not available.

New in version 20

Displaying a geographical location with check procedure Hide the details

MapDisplayPosition(<Map control> , <Position> [, <WLanguage procedure>])

<Map control>: Control name

Name of Map control to use. If this parameter corresponds to an empty string (""), the Map control to which the current event belongs will be used.

<Position>: geoPosition variable or character string

Description of the location on which the map will be centered. This description can correspond to:
the name of the geoPosition variable describing the geographical position on which the map will be centered.
a character string containing an address, a city, the name of a monument, ...
an Address variable.

<WLanguage procedure>: Optional character string (with quotes)

Name of the WLanguage procedure ("callback" procedure) called once the new geographical position is displayed. This procedure has the following format:

PROCEDURE <Procedure name> (<Change performed>)

where <Change performed> is a boolean:
True if the position was modified,
False otherwise.
This parameter is not available.

Displaying a geographical location with check procedure Hide the details

MapDisplayPosition(<Map control> , <Position> [, <WLanguage procedure>])

<Map control>: Control name

Name of Map control to use. If this parameter corresponds to an empty string (""), the Map control to which the current event belongs will be used.

<Position>: geoPosition variable or character string

Description of the location on which the map will be centered. This description can correspond to:
the name of the geoPosition variable describing the geographical position on which the map will be centered.
a character string containing an address, a city, the name of a monument, ...
an Address variable.

<WLanguage procedure>: Optional character string (with quotes)

Name of the WLanguage procedure ("callback" procedure) called once the new geographical position is displayed. This procedure has the following format:

PROCEDURE <Procedure name> (<Change performed>)

where <Change performed> is a boolean:
True if the position was modified,
False otherwise.
This parameter is not available.

Remarks

The zoom level of the map is not modified when changing position.
To center the map on a specific position without performing the animation, you have the ability to assign a geoPosition variable to the ..Value property of a Map control.
To find out the position currently displayed in the center of the Map control, use MapGetPosition.

Related Examples:

Unit examples (WEBDEV): The Map control

[ + ] This example explains how to use the Map control of WEBDEV.
It can be used to display a map that includes markers as well as an itinerary.

Unit examples (WINDEV): The Map control

[ + ] Using the Map control of WINDEV.
It is used to display a map that includes markers as well as an itinerary.

Component : wd240obj.dll