ArcObjects Library Reference (Geometry)  

IProjectedCoordinateSystemEdit.Define Method

Defines the properties of a projected coordinate system.

[Visual Basic .NET]
Public Sub Define ( _
    [ByRef Name As Object], _
    [ByRef Alias As Object], _
    [ByRef Abbreviation As Object], _
    [ByRef Remarks As Object], _
    [ByRef useage As Object], _
    [ByRef gcs As Object], _
    [ByRef projectedUnit As Object], _
    [ByRef Projection As Object], _
    [ByRef parameters As Object] _
)
[C#]
public void Define (
    ref object Name,
    ref object Alias,
    ref object Abbreviation,
    ref object Remarks,
    ref object useage,
    ref object gcs,
    ref object projectedUnit,
    ref object Projection,
    ref object parameters
);
[C#]

Optional Values

Name   To indicate that this parameter is undefined, first define a variable object Missing = Type.Missing; then pass this in as ref Missing.
Alias   To indicate that this parameter is undefined, first define a variable object Missing = Type.Missing; then pass this in as ref Missing.
Abbreviation   To indicate that this parameter is undefined, first define a variable object Missing = Type.Missing; then pass this in as ref Missing.
Remarks   To indicate that this parameter is undefined, first define a variable object Missing = Type.Missing; then pass this in as ref Missing.
useage   To indicate that this parameter is undefined, first define a variable object Missing = Type.Missing; then pass this in as ref Missing.
gcs   To indicate that this parameter is undefined, first define a variable object Missing = Type.Missing; then pass this in as ref Missing.
projectedUnit   To indicate that this parameter is undefined, first define a variable object Missing = Type.Missing; then pass this in as ref Missing.
Projection   To indicate that this parameter is undefined, first define a variable object Missing = Type.Missing; then pass this in as ref Missing.
parameters   To indicate that this parameter is undefined, first define a variable object Missing = Type.Missing; then pass this in as ref Missing.
[C++]
HRESULT Define(
  VARIANT* Name,
  VARIANT* Alias,
  VARIANT* Abbreviation,
  VARIANT* Remarks,
  VARIANT* useage,
  VARIANT* gcs,
  VARIANT* projectedUnit,
  VARIANT* Projection,
  VARIANT* parameters
);
[C++]

Parameters

Name [optional]   Name is a parameter of type VARIANT

  To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

Alias [optional]   Alias is a parameter of type VARIANT

  To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

Abbreviation [optional]   Abbreviation is a parameter of type VARIANT

  To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

Remarks [optional]   Remarks is a parameter of type VARIANT

  To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

useage [optional]   useage is a parameter of type VARIANT

  To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

gcs [optional]   gcs is a parameter of type VARIANT

  To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

projectedUnit [optional]   projectedUnit is a parameter of type VARIANT

  To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

Projection [optional]   Projection is a parameter of type VARIANT

  To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

parameters [optional]   parameters is a parameter of type VARIANT

  To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Description

One of the difficult parts of defining a projected coordinate system is determining which parameters a map projection supports. All map projection supports the FalseEasting and FalseNorthing parameters. The other parameters for each projection are listed below.

Aitoff
CentralMeridian

Albers
CentralMeridian
StandardParallel1
StandardParallel2
LatitudeOfOrigin

Azimuthal_Equidistant
CentralMeridian
LatitudeOfOrigin

Behrmann
CentralMeridian

Bonne
CentralMeridian
StandardParallel1

Cassini
CentralMeridian
ScaleFactor
LatitudeOfOrigin

Craster_Parabolic
CentralMeridian

Cylindrical_Equal_Area
CentralMeridian
StandardParallel1

Double_Stereographic
CentralMeridian
ScaleFactor
LatitudeOfOrigin

Eckert_I
CentralMeridian

Eckert_II
CentralMeridian

Eckert_III
CentralMeridian

Eckert_IV
CentralMeridian

Eckert_V
CentralMeridian

Eckert_VI
CentralMeridian

Equidistant_Conic
CentralMeridian
StandardParallel1
StandardParallel2
LatitudeOfOrigin

Equidistant_Cylindrical
CentralMeridian
StandardParallel1

Flat_Polar_Quartic
CentralMeridian

Gall_Stereographic
CentralMeridian

Gauss_Kruger
CentralMeridian
ScaleFactor
LatitudeOfOrigin

Gnomonic
LongitudeOfCenter
LatitudeOfCenter

Hammer_Aitoff
CentralMeridian

Hotine_Oblique_Mercator_Azimuth_Center
ScaleFactor
Azimuth
LongitudeOfCenter
LatitudeOfCenter

Hotine_Oblique_Mercator_Azimuth_Natural_Origin
ScaleFactor
Azimuth
LongitudeOfCenter
LatitudeOfCenter

Hotine_Oblique_Mercator_Two_Point_Center
LatitudeOf1st
LatitudeOf2nd
ScaleFactor
LongitudeOf1st
LongitudeOf2nd
LatitudeOfCenter

Hotine_Oblique_Mercator_Two_Point_Natural_Origin
LatitudeOf1st
LatitudeOf2nd
ScaleFactor
LongitudeOf1st
LongitudeOf2nd
LatitudeOfCenter

Krovak
PseudoStandardParallel1
ScaleFactor
Azimuth
LongitudeOfCenter
LatitudeOfCenter
XScaleFactor
YScaleFactor
Rotation

Lambert_Azimuthal_Equal_Area
CentralMeridian
LatitudeOfOrigin

Lambert_Conformal_Conic
CentralMeridian
StandardParallel1
StandardParallel2
ScaleFactor
LatitudeOfOrigin

Local
ScaleFactor
Azimuth
LongitudeOfCenter
LatitudeOfCenter

Loximuthal
CentralMeridian
CentralParallel

Mercator
CentralMeridian
StandardParallel1

Miller_Cylindrical
CentralMeridian

Mollweide
CentralMeridian

New_Zealand_Map_Grid
LongitudeOfOrigin
LatitudeOfOrigin

Orthographic
LongitudeOfCenter
LatitudeOfCenter

Plate_Carree
CentralMeridian

Polyconic
CentralMeridian
LatitudeOfOrigin

Quartic_Authalic
CentralMeridian

Rectified_Skew_Orthomorphic_Center
ScaleFactor
Azimuth
LongitudeOfCenter
LatitudeOfCenter
Rotation

Rectified_Skew_Orthomorphic_Natural_Origin
ScaleFactor
Azimuth
LongitudeOfCenter
LatitudeOfCenter
Rotation

Robinson
CentralMeridian

Robinson_ARC_INFO
CentralMeridian

Sinusoidal
CentralMeridian

Stereographic
CentralMeridian
ScaleFactor
LatitudeOfOrigin

Stereographic_North_Pole
CentralMeridian
StandardParallel1

Stereographic_South_Pole
CentralMeridian
StandardParallel1

Times
CentralMeridian

Transverse_Mercator
CentralMeridian
ScaleFactor
LatitudeOfOrigin

Transverse_Mercator_Complex
CentralMeridian
ScaleFactor
LatitudeOfOrigin

Two_Point_Equidistant
LatitudeOf1st
LatitudeOf2nd
LongitudeOf1st
LongitudeOf2nd

Van_der_Grinten_I
CentralMeridian

Vertical_Near_Side_Perspective
LongitudeOfCenter
LatitudeOfCenter
Height

Winkel_I
CentralMeridian
StandardParallel1

Winkel_II
CentralMeridian
StandardParallel1

Winkel_Tripel
CentralMeridian
StandardParallel1

[C#]

    private IProjectedCoordinateSystem DefineProjectedCoordinateSystem(IGeographicCoordinateSystem geographicCoordinateSystem, ILinearUnit linearUnit, IProjection projection, IParameter[] parameters)
    {
        IProjectedCoordinateSystemEdit projectedCoordinateSystemEdit = new ProjectedCoordinateSystemClass();
        //Define the properties of the Projected Coordinate System.

        object name = "Transverse_Mercator";
        object alias = "UTM";
        object abbreviation = "Trans_Merc";
        object remarks = "Transverse Mercator is the projection";
        object usage = "";
        object geographicCoordinateSystemObject = geographicCoordinateSystem;
        object projectedUnitObject = linearUnit;
        object projectionObject = projection;
        object parametersObject = parameters;

        projectedCoordinateSystemEdit.Define(ref name,
                                             ref alias,
                                             ref abbreviation,
                                             ref remarks,
                                             ref usage,
                                             ref geographicCoordinateSystemObject,
                                             ref projectedUnitObject,
                                             ref projectionObject,
                                             ref parametersObject
                                             );
        return projectedCoordinateSystemEdit as IProjectedCoordinateSystem;
    }

See Also

IProjectedCoordinateSystemEdit Interface

.NET Related Topics

Creating a custom projected coordinate system