AcMapObjClassProperty::SetValue Method

Sets the value of this property for the specified entity. The entity and property can be classified or unclassified. If this property is classified, this function checks the property's range of valid values and, if the value is invalid, sets the value to its default value if bFixOutOfRangeIfClassified is true. Properties retrieved with AcMapClassificationManager::GetClassifiedProperties() (twoforms) are classified properties. Properties retrieved with AcMapClassificationManager::GetProperties() (twoforms) are unclassified properties, and SetValue() sets property values regardless of the value of bFixOutOfRangeIfClassified.

AcMapObjClass::EErrCode SetValue(
    const AcDbObjectId& entId, 
    const VARIANT * pvarValue, 
    bool bFixOutOfRangeIfClassified
);

Returns AcMapObjClass::EErrCode eOk if successful. Returns AcMapObjClass::EErrCode ePropertyNotFound if the entity does not have the specified property. Returns AcMapObjClass::EErrCode ePropertyReadOnly if the property is a read-only property, or if the property is classified and AcMapObjClassProperty::IsReadOnly() is true. Returns AcMapObjClass::EErrCode eOutOfRange if the property value is still out of range. This error code is returned only if bFixOutOfRangeIfClassified is true, the property is classified, and the out-of-range property value could not be reset. For example, if the range of the Layer property specifies a layer that does not exist in the current drawing, an attempt to fix this nonexistent layer will fail. Returns AcMapObjClass::EErrCode eFailed if the process failed for some other reason.