ArcObjects Library Reference (Geometry)

VerticalCoordinateSystem CoClass

Creates a vertical coordinate system.

Product Availability

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

Description

A vertical coordinate system has two types. It can either be gravity-related, which requires a VerticalDatum; or ellipsoid/spheroid-based which requires a horizontal Datum. A horizontal Datum is the same as one used for a geographic coordinate system. It has a linear unit of measure. A VCS has two parameters. The positiveDirection value defines whether the vertical coordinate system has positive values 'up', for heights, or 'down', for depths. Use -1 for positive depths. The verticalShift parameter is a way to identify this VCS as offset from some other known surface. For example, you might know that a dataset's depths are referenced to mean lower low water (a tidal level). You might also know that for this dataset, mean lower low water is 1.23 meters 'down' from local mean sea level. The VCS could be defined for mean sea level but with a verticalShift of -1.23 to shift the 'zero' level to mean lower low water.

Extended Error Information

Use the ISupportErrorInfo method InterfaceSupportsErrorInfo to determine if the object supports extended error information. If the object supports extended error info, VC++ developers should use the OLE/COM IErrorInfo interface to access the ErrorInfo object. Visual Basic developers should use the global error object Err to retrieve this extended error information.

Interfaces

Interfaces	Description
IClone (esriSystem)	Provides access to members that control cloning of objects.
IESRISpatialReference	Provides access to members that control the import/export operations components of a spatial reference system. This interface has been deprecated and IESRISpatialReferenceGEN should be used.
IESRISpatialReferenceGEN	Provides access to members that generate well known string (WKS) representations of spatial reference objects. IESRISpatialReference has been deprecated and IESRISpatialReferenceGEN should be used.
IESRISpatialReferenceGEN2	Provides access to members that generate well known string representations for spatial reference objects. The strings include authority metadata.
IPersist	Defines the single method GetClassID, which is designed to supply the CLSID of an object that can be stored persistently in the system. IPersist is the base interface for three other interfaces: IPersistStorage, IPersistStream, and IPersistFile.
IPersistStream (esriSystem)
ISpatialReferenceAuthority	Provides access to the authority-related metadata for a spatial reference object.
ISpatialReferenceInfo	Provides access to members that control the properties common to all components of a spatial reference system.
ISupportErrorInfo	Indicates whether a specific interface can return Automation error objects.
IVerticalCoordinateSystem	Provides access to properties of a vertical coordinate system.
IVerticalCoordinateSystemEdit	Provides access to members that control the properties of a vertical coordinate system.
IVerticalCoordinateSystemGEN	Provides access to properties of a vertical coordinate system.