Sets the name of the column in the AutoCAD Map table that this incoming column is mapped to. The mapped column name is set by default when you call AcMapIEInputLayer::SetDataMapping()or reset every time you call SetColumnDataMapping() with different data. The default behavior maps the incoming column name to an existing column in an existing object data table, or an existing link or link template, where the case-insensitive names match. If no such target column exists then the incoming column is not mapped by default. When you create a new object data table as the default mapping, curly brace and dot characters are changed to underscores. Object data table column names must be 31 or fewer characters long. Object data table names must be 25 or fewer characters long.
virtual AcMapIE::ErrCode SetColumnDataMapping(
const ACHAR* pszMappedFieldName
) = 0;|
Parameters |
Description |
|
pszMappedFieldName |
Input column name. To reset the column to no mapping, use NULL or an empty string. |
Returns AcMapIE::ErrCode kErr_OK if successful. Returns AcMapIE::ErrCode kErr_TableNotSet if the table name and table type was not first set with AcMapIEInputLayer::SetDataMapping(). Returns AcMapIE::ErrCode kErr_BadFieldName if the column name does not exist in the specified table. Returns AcMapIE::ErrCode kErr_Conflict if a conflict with a previously set feature class column exists.