MGMap.preferencesDlg

Syntax

void preferencesDlg()

Description

Displays the Preferences dialog box, where the user can specify the map units, selection mode, and options for the status bar.

This method is the equivalent of the Help > Preferences menu command in the user interface.

Note that this method does not work during a busy state. For additional information about the busy state, refer to "Handling Busy State and Map Refresh" chapter in the Autodesk MapGuide Developer's Guide.

Error Codes

-1 (busy)

Example

This example is designed to work with the Tutorial.mwf file that is included with Autodesk MapGuide Author. It displays the Preferences dialog box:

function showPreferences()
{
    getMap().preferencesDlg();
}