This method opens a high-level dialog that allows the user to select, view, edit, and create a coordinate system. The values of the group, system, datum, and units, that are used when opening the dialog, sets the initial dialog coordinate system. When the dialog is closed, if the chosen parameter is TRUE, the user pressed the OK button, and the selected keys from the dialog are set to the keys parameters. If the chosen is FALSE the keys values remain the same.
HRESULT ChooseCSDialog(
[out] VARIANT* boolChosen,
[in, out] VARIANT* bstrGroupKey,
[in, out] VARIANT* bstrSystemKey,
[in, out] VARIANT* bstrDatumKey,
[in, out] VARIANT* bstrUnitKey,
[in, out] VARIANT* longEPSG,
[in] long PARENT,
[in] BSTR Title)
Parameters:
boolChosen – Returns TRUE if OK was selected in the high-level dialog, FALSE if Cancel was selected.
bstrGroupKey – The unique string of the coordinate system group.
bstrSystemKey – The unique string of the coordinate system.
bstrDatumKey – The unique string of the coordinate system datum.
bstrUnitKey – The unique string of the coordinate system units.
longEPSG – Reserved.
PARENT – Handle to parent window, pass 0 for the desktop.
Title – The title of the dialog.
Return Values:
The return value obtained from the returned HRESULT can be one of the following:
|
Return value |
Meaning |
|
S_OK |
Success. |
|
E_FAIL |
Catastrophic failure. |
|
TE_E_MPTNOTLOADED |
An MPT file must be loaded in TerraExplorer for this method to work. |
|
TE_E_COORDSYS_NOT_INIT |
Reprojection error. The key component geocalc.dat may be missing |
|
TE_E_NOLICENSE |
You are running TerraExplorer Viewer and therefore do not have permission to work with this interface. |