ImportFromView()

Creates a geographic file of point features from coordinates in a view.

ImportFromView(string view_set_name, array fields, string new_db_name, array options)

Argument	Contents
view_set_name	The view or selection set to import
fields	An array of three field names (strings) for the ID, the X-value, and the Y-value
new_db_name	The name of the new geographic file

Option	Type	Contents
Label	String	A descriptive label for the geographic file
Layer Name	String	The name of the layer in the geographic file
NAD Conversion	3 strings	Input datum, output datum, and conversion file (if needed); the input and output datums should be different
Optimize	Boolean	Whether to optimize the geographic file automatically after the import (defaults to "True")
Projection	String, array	The projection name and the array of options
Transform	Array	Array indicating the transformation to apply to coordinates in the file. This can have three forms: 1. An array of two or more four-element arrays containing local and world coordinates for control points, for example, {{real localX1, real localY1, real longitude1, real latitude1}, ...} 2. An array of four elements - {real X_multiplier, real Y_multiplier, real X_offset, real Y_offset} 3. Center and Extent transform {c1_x, c1_y, width_1, c2_x, c2_y, width_2}where center is shifted from (c1_x,c1_y) to (c2_x,c2_y), and vector of length width_1 out of c_1 becomes a vector of length width_2 out of c_2.

ImportFromView() is the GISDK function that is used to implement the Tools>Locate>Locate By Coordinate command.
For more details on the NAD Conversion option, see Datum Conversions.
For more details on the Projection option, see Using Projections and Coordinate Systems.
If no transformation is applied, longitude and latitude coordinates can be integers with six implied decimal places (millionths of a degree). For more details, see Transformations.
ImportFromView() displays a progress bar. To add a Cancel button to the progress bar, precede the function call with an "on escape" clause. For more information, see Error Handling.

ImportFromView("Customers|", {"ID", "X", "Y"}, "customer.dbd", {

{"Label", "Customer Database"},

{"Layer Name", "Customers"},

{"Optimize", "True"},

{"Projection", "utm", {"zone=12", "units=m"}},

{"NAD Conversion", "NAD27", "NAD83",}

})

Error Type	Meaning
Error	The coordinates are of the wrong type or invalid
NotFound	There is no view with the specified name, or one or more of the fields does not exist in the view
Escape	The user clicked Cancel