Syntax
void setUrl(String URL)
Description
Sets the URL of the map to display.
The URL may contain the following optional Autodesk MapGuide Viewer parameters: Lat, Lon,
Width, Units, and Scale.
Important Notes
- If the map you are specifying with setUrl is outside of the firewall, and
the user is attempting to view the map with the Autodesk MapGuide Viewer, Java Edition in Netscape Navigator,
Netscape will not display the authentication dialog box that allows the user
to enter a user name and password for proxy authentication. Thus, if the user
has not already viewed a page outside of the firewall and authenticated with
the proxy server, the map will not load. This does not happen when you embed
or link to a map in the HTML page; it happens only with setUrl. Therefore,
to work around this problem, make sure that the first map the user loads is
outside of the firewall so that the user can authenticate with the proxy server.
- This method overrides the autoRefresh
flag and always refreshes the map. Subsequent method calls adhere to the
original setting of the autoRefresh flag.
- This method does not work during a busy state and does not work if called
from within event-handling code for the onViewChanging
or onMapLoaded events.
Parameters
URL - The new map URL to display.
Error Codes
-1 (busy)
-3 (illegal argument)
-14 (refresh disabled)
See Also
getUrl, URL,
FullUrl
