The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....



AddTown


Unit:SDL_geodb
Class:TGeoDB
Declaration:function AddTown (Name: TgdbName; Date: TDateTime; StateFlag: longint; Location: TSCoords; Altitude: single; ClassNumber: byte; UserTag: longint): integer;

The method AddTown adds the coordinates of a town to the database. The parameter Name contains the name of the town. Date holds the date and time associated with the town. The parameter StateFlag reflects the state of the database entry. The position of the town is defined by the parameter Location. The parameter Altitude defines the altitude of the town. ClassNumber contains the number of the class the new database entry should belong to, and the UserTag parameter may hold a user-defined number. UserTag is not used by the database system, it can be used to store additional information.

The function AddTown returns the database entry number of the newly created entry, or a value of -1 if an error occurred.

Hint: Please note the difference between a city and a town: while a city is large enough to be represented by an outline polygon, a town is represented by a single point.

Example: This method is used in the following example program (see http://www.lohninger.com/examples.html for downloading the code): geodata



Last Update: 2012-Oct-20