This document is archived and information here might be outdated.  Recommended version.


IProjectedCoordinateSystemEdit.Define Method (ArcObjects .NET 10.4 SDK)
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