Property :: instanceUpdated - Check for external instance modifications
The function checks, whether the instance has been updated by another property handle. In this case, instance data needs to be refreshed (instanceRefresh()). In contrast to modified(), the function does not provide information about changes made by the current property handle or one of its copies.
The function may be called in order to detect changes before modifying data within the instance.
When no instance is selected in the property handle, the function throws an exception.
.... fragment ( Property &ph ) {
if ( ph.instanceUpdated() )
if ( ph.modified() )
printf("instance modified by other data source, changes get lost");
ph.instanceRefresh();
]
The value is true when the function was executed successfully. Otherwise the value is set to false.