Creates a vertical coordinate system.
Product Availability
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. |