CJB 2.0.0.9043

jtcw.c2pc.bindings.convert
Interface IMgrs

All Superinterfaces:
IDispatch, IUnknown
All Known Implementing Classes:
IMgrs.Jni

public interface IMgrs
extends IDispatch

The IMgrs interface specifies the properties and methods for MGRS positional values.

The Zone property specifies the zone. The zones range from 1 to 60.

The LatitudeBand property specifies the latitude band. MGRS values range from 80 degrees south to 84 degrees north. This range is broken up into 20 bands (C..X, except I and O), each band is 8 degrees wide, except the X band which is 12 degrees.

The GridEast property specifies the column of the one hundred thousand meter grid. The characters that can make up a valid column of the one hundred thousand meter grid include A..Z except I and O.

The GridNorth property specifies the row of the one hundred thousand meter grid. The characters that can make up a valid row of the one hundred thousand meter grid include A..V except I and O.

The Easting property specifies the easting.

The Northing property specifies the northing.

The InputDatum property specifies the datum all input values are from. The input values include Zone, LatitudeBand, GridEast, GridNorth, Easting and Northing.

The OutputDatum property specifies the datum all output values will be converted to. The output values include Zone, LatitudeBand, GridEast, GridNorth, Easting and Northing.


The InputDatum and OutputDatum values can be specified in three ways:

       If bstrDatum is empty, the system datum is read from the registry and used.

       bstrDatum can contain the datum id, which is defined in Table 1 in Appendix B.

       bstrDatum can contain the data in the form datum:ellipsoid where datum is defined in Table 2 in Appendix B and ellipsoid is defined in Table 3 in Appendix B.

The Text property returns a BSTR formatted in MGRS according to the input precision and InputDatum/OutputDatum. This property should only be used by applications that need the string formatted in MGRS units to be useful (i.e. a coordinate conversion application.). All other applications should use the Text property from the ISystemText or ISystemTextHiPrec interfaces. The Text property from ISystemText and ISystemTextHiPrec will always return a BSTR formatted using the system wide precision, delimiter values, and Datum. The system wide settings can be set in the C2PC Settings dialog, which can be started, from the C2PC Tools:Options Menu.


Nested Class Summary
static class IMgrs.Disp
          Implementation, COM to Java.
static class IMgrs.Jni
          Implementation, Java to COM.
 
Field Summary
static GUID IID
          IDL: [uuid(630AFE42-B773-11D0-801C-0060975855C5)]
static Class TYPELIB
           
 
Fields inherited from interface com.moesol.bindings.platform_sdk.component_services.IDispatch
DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF
 
Method Summary
 double getEasting()
          Get the easting property.
 String getGridEast()
          Get the grid east property.
 String getGridNorth()
          Set the grid north property.
 String getInputDatum()
          Get the input datum property.
 String getLatitudeBand()
          Get the latitude band property.
 double getNorthing()
          Get the northing property.
 String getOutputDatum()
          Get the output datum property.
 String getText(int precision)
          Get the text property.
 int getZone()
          Get the zone property.
 void setEasting(double pdblEasting)
          Set the easting property.
 void setGridEast(String pbstrGridEast)
          Set the grid east property.
 void setGridNorth(String pbstrGridNorth)
          Set the grid north property.
 void setInputDatum(String pbstrDatum)
          Set the input datum property.
 void setLatitudeBand(String pbstrLatitudeBand)
          Set the latitude band property.
 void setNorthing(double pdblNorthing)
          Set the northing property.
 void setOutputDatum(String pbstrDatum)
          Get the output datum property.
 void setZone(int piZone)
          Set the zone property.
 
Methods inherited from interface com.moesol.bindings.platform_sdk.component_services.IUnknown
QueryInterface, QueryInterface, Release
 

Field Detail

TYPELIB

static final Class TYPELIB

IID

static final GUID IID
IDL: [uuid(630AFE42-B773-11D0-801C-0060975855C5)]

Method Detail

setZone

void setZone(int piZone)
Set the zone property.

Parameters:
piZone - IDL: [in] INT

getZone

int getZone()
Get the zone property.

Returns:
IDL: [out] [retval] INT*

setLatitudeBand

void setLatitudeBand(String pbstrLatitudeBand)
Set the latitude band property.

Parameters:
pbstrLatitudeBand - IDL: [in] BSTR

getLatitudeBand

String getLatitudeBand()
Get the latitude band property.

Returns:
IDL: [out] [retval] BSTR*

setGridEast

void setGridEast(String pbstrGridEast)
Set the grid east property.

Parameters:
pbstrGridEast - IDL: [in] BSTR

getGridEast

String getGridEast()
Get the grid east property.

Returns:
IDL: [out] [retval] BSTR*

setGridNorth

void setGridNorth(String pbstrGridNorth)
Set the grid north property.

Parameters:
pbstrGridNorth - IDL: [in] BSTR

getGridNorth

String getGridNorth()
Set the grid north property.

Returns:
IDL: [out] [retval] BSTR*

setEasting

void setEasting(double pdblEasting)
Set the easting property.

Parameters:
pdblEasting - IDL: [in] DOUBLE

getEasting

double getEasting()
Get the easting property.

Returns:
IDL: [out] [retval] DOUBLE*

setNorthing

void setNorthing(double pdblNorthing)
Set the northing property.

Parameters:
pdblNorthing - IDL: [in] DOUBLE

getNorthing

double getNorthing()
Get the northing property.

Returns:
IDL: [out] [retval] DOUBLE*

setInputDatum

void setInputDatum(String pbstrDatum)
Set the input datum property.

Parameters:
pbstrDatum - IDL: [in] BSTR

getInputDatum

String getInputDatum()
Get the input datum property.

Returns:
IDL: [out] [retval] BSTR*

setOutputDatum

void setOutputDatum(String pbstrDatum)
Get the output datum property.

Parameters:
pbstrDatum - IDL: [in] BSTR

getOutputDatum

String getOutputDatum()
Get the output datum property.

Returns:
IDL: [out] [retval] BSTR*

getText

String getText(int precision)
Get the text property.

Parameters:
precision - The precision __MIDL_ILatitudeLongitude_0001
Returns:
The textual representation of this IMgrs

CJB 2.0.0.9043

Copyright © 2007 Moebius Solutions, Inc. All Rights Reserved.