Provides functions that handle input layers (also called themes).
After you call the AcMapIEImporterclass's LoadIPF(), InvokeDriverOptionsDialog(), or SetDriverOptions()function on the importer, a new AcMapIEInputLayerIteratorobject is created if the function's bSchemaHasChanged output parameter is true and any previously obtained input-layer iterator becomes invalid. Calling AcMapIEImporter::Init()will also invalidate the AcMapIEInputLayerIterator because AutoCAD Map assumes you are opening a new dataset or changing format.
If you set a table name and table type by using SetDataMapping(), default mappings are created depending on the existence of an object data table or a link template with that table name. The valid table types, set by the input AcMapIE::ImportDataMappingtableType parameter, are kNewObjectDataOnly, kExistingObjectDataOnly, kLinkTemplate, and kLinkOnly.
If the table type is kNewObjectDataOnly and the table name is an existing object data table, then SetDataMapping()generates an error and makes no changes. If no object data table with the specified name exists, then all incoming columns are mapped by default to valid object data column names. During import, when the first entity arrives in this input layer, the table is created. If no entities exist for this input layer, no object data table is created.
If the table type is kExistingObjectDataOnly and the table name is an existing object data table, then SetDataMapping()generates an error and makes no changes. If the object data table exists, then incoming columns are mapped to object data columns that have the same (case-insensitive) names.
If the table type is kLinkTemplate or kLinkOnly and the table name is not an existing link template, then SetDataMapping()generates an error and makes no changes. If the link template exists, then incoming columns are mapped to link template or link columns that have the same (case-insensitive) names. All link templates contain link columns which are the equivalent of unique key columns. If not all link columns are mapped to incoming columns, the mapping is invalid and no data will be imported (and a warning is generated when setting the data mapping). It is your responsibility to ensure that all link columns are mapped. The database that you are importing data into may itself have constraints. If a key-column uniqueness constraint is violated, data may disappear silently.
class AcMapIEInputLayer;
AcMapIEInputLayer.h
Methods|
Destroys an instance of this class. | |
|
Retrieves an iterator over a collection of AcMapIEColumninstances. | |
|
Retrieves the table type and table name of the data mapping. | |
|
Retrieves the name of the feature class of this input layer. | |
|
Determines whether this import layer is on (and will be imported). | |
|
Retrieves the name of the target layer to which entities are imported. | |
|
Retrieves the name of this input layer. | |
|
Retrieves AutoCAD Map's best guess for the coordinate system that the data to be imported uses. | |
|
Determines how points are imported. | |
|
Sets the table type and table name of the data mapping. | |
|
Sets the name of the feature class of this input layer. | |
|
Turns this input layer on (to be imported) or off (not to be imported). | |
|
Sets the name of the target layer to which entities are imported. | |
|
Sets how points are imported. | |
|
Sets the coordinate system that incoming data is transformed from. | |
|
Sets whether block attribute values are brought in from incoming attribute data. | |
|
Sets whether a unique key value is created for each incoming entity. This setting is ignored unless an existing or new object data table already has been set with SetDataMapping(). The key column has type integer. In the AutoCAD Map user interface, this setting corresponds to the Add Unique Key Field check box in the Attribute Data dialog box. | |
|
Retrieves the coordinate system that incoming data is transformed from. | |
|
Determines whether block attribute values are brought in from incoming attribute data. | |
|
Determines whether a unique value is created for each incoming entity. This setting is ignored unless an existing or new object data table already has been set with SetDataMapping(). The key column has type integer. In the AutoCAD Map user interface, this setting corresponds to the Add Unique Key Field check box in the Attribute Data dialog box. |
