Method addDynamicProperty

src/App/DynamicProperty.cpp:215–296

}

Property* DynamicProperty::addDynamicProperty(
    PropertyContainer& pc,
    std::string_view type,
    const char* cstrName,
    const char* group,
    const char* doc,
    short attr,
    bool ro,
    bool hidden
)
{
    if (type.empty()) {
        type = "<null>";
    }

    std::string name {(cstrName && cstrName[0] != '\0') ? cstrName : ""};

    static ParameterGrp::handle hGrp =
        GetApplication().GetParameterGroupByPath("User parameter:BaseApp/Preferences/Document");
    if (hGrp->GetBool("AutoNameDynamicProperty", false)) {
        if (name.empty()) {
            name = type;
        }
        std::string uniqueName = getUniquePropertyName(pc, name.c_str());
        if (uniqueName != name) {
            FC_WARN(
                pc.getFullName() << " rename dynamic property from '" << name << "' to '"
                                 << uniqueName << "'"
            );
            name = uniqueName;
        }
    }
    else if (name.empty()) {
        name = "<null>";  // setting a bad name to trigger exception
    }

    auto prop = pc.getPropertyByName(name.c_str());
    if (prop && prop->getContainer() == &pc) {
        FC_THROWM(Base::NameError,
                  "Property " << pc.getFullName() << '.' << name << " already exists");
    }

    if (Base::Tools::getIdentifier(name) != name) {
        FC_THROWM(Base::NameError, "Invalid property name '" << name << "'");
    }

    Base::Type propType =
        Base::Type::getTypeIfDerivedFrom(type, App::Property::getClassTypeId(), true);
    if (propType.isBad()) {
        FC_THROWM(Base::TypeError,
                  "Invalid type " << type << " for property " << pc.getFullName() << '.' << name);
    }

    void* propInstance = propType.createInstance();
    if (!propInstance) {
        FC_THROWM(Base::RuntimeError,
                  "Failed to create property " << pc.getFullName() << '.' << name << " of type "
                                               << type);