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


IGeographicCoordinateSystemEdit.Define Method (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Geometry > ESRI.ArcGIS.Geometry > Interfaces > IG > IGeographicCoordinateSystemEdit Interface > IGeographicCoordinateSystemEdit.Define Method
ArcGIS Developer Help

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