Classifies multiple entities with a feature class name.
AcMapObjClass::EErrCode Classify( AcDbObjectIdArray* paFailedEntIds, AcArray<AcMapObjClass::EErrCode>* paFailedErrCodes, AcDbObjectIdArray& aEntIds, const ACHAR* pszClassName, bool bIncludeNonConforming, bool bClassifyEvenIfAlreadyClassified );
|
Parameters |
Description |
|
paFailedEntIds |
Output IDs of failed entities, or NULL if not needed by the caller. The operation traverses aEntIds from beginning to the end, reporting failures. |
|
paFailedErrCodes |
Output error code of each failed entity, or NULL if not needed by the caller. The array index of each error code matches the index of each corresponding failed entity in paFailedEntIds. |
|
aEntIds |
Input IDs of the entities to classify. |
|
pszClassName |
Input name of the feature class. |
|
bIncludeNonConforming |
Input true to include entities with missing or out-of-range properties, or false to include only conforming properties. |
|
bClassifyEvenIfAlreadyClassified |
Input true to replace the current classification if the entity is already classified, or false to prevent reclassification. |
Returns AcMapObjClass::EErrCode eOk if all entities are classified successfully. Returns AcMapObjClass::EErrCode eNoSchemaFileAttached if no feature-definition file is attached to the current drawing. Returns AcMapObjClass::EErrCode eClassNameInvalid if the class name is invalid. Returns AcMapObjClass::EErrCode eClassNameTooLong if the class name is too long. Returns AcMapObjClass::EErrCode eClassNotFound if the class is not in the feature-definition file. Returns AcMapObjClass::EErrCode eBaseClassOnly if the class is a strict base class that cannot be used for classification. Returns AcMapObjClass::EErrCode eFailed if the process failed for at least one entity.
Classifying entities does not trigger internal transactions.