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


IGeographicCoordinateSystemEdit.Define Method (ArcObjects .NET 10.6 SDK)
ArcObjects Library Reference (Geometry)  

IGeographicCoordinateSystemEdit.Define Method

Defines the properties for a geographic 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 Datum As Object], _
    [ByRef PrimeMeridian As Object], _
    [ByRef geographicUnit As Object] _
)
[C#]
public void Define (
    ref object Name,
    ref object Alias,
    ref object Abbreviation,
    ref object Remarks,
    ref object useage,
    ref object Datum,
    ref object PrimeMeridian,
    ref object geographicUnit
);
[C++]
HRESULT Define(
  Variant* Name,
  Variant* Alias,
  Variant* Abbreviation,
  Variant* Remarks,
  Variant* useage,
  Variant* Datum,
  Variant* PrimeMeridian,
  Variant* geographicUnit
);
[C++]

Parameters Name [optional]
Name is a parameter of type VARIANT* Alias [optional]
Alias is a parameter of type VARIANT* Abbreviation [optional]
Abbreviation is a parameter of type VARIANT* Remarks [optional]
Remarks is a parameter of type VARIANT* useage [optional]
useage is a parameter of type VARIANT* Datum [optional]
Datum is a parameter of type VARIANT* PrimeMeridian [optional]
PrimeMeridian is a parameter of type VARIANT* geographicUnit [optional]
geographicUnit is a parameter of type VARIANT*

Product Availability

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

Description

Use the Define method of IGeographicCoordinateSystemEdit to set the properties of a geographic coordinate system. A geographic coordinate system is defined (at minimum) by a name, an angular unit of measure, a horizontal datum, and a prime meridian.

[C#]

    private void DefineCoordinateSystem()
    {
        // use activator class with SpatialReferenceEnvironment singleton
        Type factoryType=Type.GetTypeFromProgID("esriGeometry.SpatialReferenceEnvironment");
        System.Object obj=Activator.CreateInstance(factoryType);
        ISpatialReferenceFactory spatialReferenceFactory=obj as ISpatialReferenceFactory;

        IDatum datum=spatialReferenceFactory.CreateDatum((int)esriSRDatumType.esriSRDatum_OSGB1936);
        IPrimeMeridian primeMeridian=spatialReferenceFactory.CreatePrimeMeridian((int)esriSRPrimeMType.esriSRPrimeM_Greenwich);
        IUnit unit=spatialReferenceFactory.CreateUnit((int)esriSRUnitType.esriSRUnit_Degree);

        IGeographicCoordinateSystemEdit geographicCoordinateSystemEdit=new GeographicCoordinateSystemClass();
        object name="UserDefined Geographic Coordinate System";
        object alias="UserDefined GCS";
        object abbreviation="UserDefined";
        object remarks="User Defined Geographic Coordinate System based on OSGB1936";
        object usage="Suitable for the UK";
        object datumObject=datum as object;
        object primeMeridianObject=primeMeridian as object;
        object unitObject=unit as object;
        geographicCoordinateSystemEdit.Define(ref name,
                                              ref alias,
                                              ref abbreviation,
                                              ref remarks,
                                              ref usage,
                                              ref datumObject,
                                              ref primeMeridianObject,
                                              ref unitObject);

        IGeographicCoordinateSystem userDefinedGGeographicCoordinateSystem=geographicCoordinateSystemEdit as IGeographicCoordinateSystem;
        System.Windows.Forms.MessageBox.Show(userDefinedGGeographicCoordinateSystem.Name);
    }

See Also

IGeographicCoordinateSystemEdit Interface

.NET Related Topics

Creating a custom geographic coordinate system