ConvertToAreaDatabase()

Summary

Creates an area geographic file from a set of line or area features.

 

Syntax

ConvertToAreaDatabase(string layer_set, string new_db_name, array options)

 

Argument	Contents
layer_set	The name of the layer or selection set
new_db_name	The path and file 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

 

Notes

• The new geographic file:

• • Has one feature for each closed polygon created by the lines or boundary edges in the input layer or selection set.

  • Is always a standard format file with a .DBD extension.

  • Is automatically optimized.

• ConvertToAreaDatabase() requires substantial amounts of memory. If the available memory is insufficient, the system is often left unstable.

• ConvertToAreaDatabase() 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.

Example

ConvertToAreaDatabase("Highways|Interstates", "zones.dbd", {

     {"Label", "Zones Bordered by Highways"},

     {"Layer Name", "Zones"}

     })

 

Error Codes

Error Type	Meaning
Error	The layer or set name or one of the options is invalid
Escape	The user clicked Cancel

 

See Also

Function	Summary
ConvertToLineDatabase()	Creates a line geographic file from a set of line or area features
ExportGeography()	Converts a geographic file between standard and compact format, or creates a new geographic file from a selection set