PropertyHandle :: CanRename - Can selected instance be renamed
The function checks, whether an instance has been selected in the property handle and whether the selected instance can be updated or not.The function returns true, when renaming the instance (changing key value for current index) is possible and false otherwise.
Returning true always implies canUpdateCollection(), but not necessarily reverse. There are several reasons for denying renaming the instance:
- The property handle is opened for read, only
- The instance is persistent write protected
- The instance is locked by another property handle
- Key cannot be updated into base extent (super set.canUpdateCollection())
- The collection has not got an order key
- The current application does not have rights for updating the instance (disabled by context)
- The instance is an embedded part of another instance which cannot be renamed
- The property handle is invalid.
- Updating is denied by context handler (client or server) TypeContext::canRename()
Return value: Return value ( logical )
The function returns YES when the question was answered positively. Otherwise it returns NO.