company logo

Property :: modified - Modified property

The modified state marks an instance selected in the property handle as being modified. This is usually done automatically when assigning a value to a property handle. The property can be set to true, but not reset.

Return value:  Success ( bool  )

The value is true when the function was executed successfully. Otherwise the value is set to false.

Implementation overview

Implementation details

  1. Has property been updated internally?
    bool Property  :: modified (  )

    The property returns whether the instance in the property handle or any subordinated instance has been modified (and is not yet saved) or not.

    When the instance contains unsaved modifications, the property returns true, false otherwise.The property throws an exception, when no instance is accessible for the property handle.

  2. to list
  3. Mark property or instance as being modified
    bool Property  :: modified ( bool bState )

    The function marks the instance selected in the property handle as modified. This is usually done automatically when assigning a value to a property handle. In order to force, however, storing the instance, the property value can be set explicitly before calling save(). Otherwise the instance will not be stored to the database when not being updated.

    The modified state cannot be reset, i.e. passing false in bState will not change the modify state.

    The function throws an exception, when no instance is selected in the property handle or when the instance is write protected (readOnly()).

    • bState - Success

      The value is true when the function was executed successfully. Otherwise the value is set to false.

  4. to list