long create(string ck, string fc, string x, string y)
This method creates a new point feature with CARIS Key and Feature Code given by ck and fc, respectively, at the coordinates (x, y). The coordinates must be in the current Exchange Coordinate System, unless the map type is NRMR (See Map Types).
The Point feature is created with the current defaults for symbol size, orientation, and color, as well as the current default restriction. These defaults can be modified by the PointAPI methods:
respectivley, by calling one or more of them prior to create.
The method returns 0 upon success, and returns error codes for the following conditions:
The given coordinates are invalid
Placement is restricted (the default) and the given location lies outside the mapís cover
Placement is restricted and the map has no cover (this occurs if the map has no features)
A CSF error occurred when trying to create the feature. (This should normally not occur, and would most likely indicate a corrupted map dataset.)
note for v2.5 developers: create
corresponds to createNewPointFeature and createNewPointFeatureEx, where the
size, color, and restrict property are determined by the current default
setting. Use overrideDefaultSize,
overrideDefaultColor, and overrideDefaultRestrictProperty as needed.