Share

acdbConvertFieldsToText

C++

ACDBCORE2D_PORT Acad::ErrorStatus acdbConvertFieldsToText(
    AcDbDatabase* pDb, 
    const AcStringArray* pEvalIds, 
    AcFd::ConvertFieldToText nOption
);

File

DbField.h

Description

Converts fields in a database into dumb text using the evaluated values. After conversion the fields are deleted and the text will no longer update.

nOption can be one or more of the following AcFd::ConvertFieldToText enum values:

kConvertFieldToTextNone - No option

kEvaluateBeforeConversion - Evaluate the field before converting it to text.

kExcludeEvaluatorsInList - Treat the list of evaluator IDs in pEvalIds as exclusion list; that is, skip the fields with evaluator IDs found in this list and convert the rest. This flag is used only if pEvalIds is not null.

kIgnoreEvaluatorVersion - Ignore the evaluator version while comparing the evaluator id in pEvalIds array. This flag is used only if pEvalIds is not null.

Returns Acad::eOk if successful.

Parameters

Parameters Description
pDb Input pointer to database in which the fields are to be converted to text
pEvalIds Input array of evaluator IDs to convert. If this is not null only the fields whose evaluator ID matches one of IDs in this list will be converted. If this is null all the fields will be converted.
nOption Input one or more conversion options

Was this information helpful?