JVCL Help:IJvDataItemsManagement.Remove

From Project JEDI Wiki
Jump to navigationJump to search
JEDI Visual Component Library Help

Search in JVCL Help

 
Search in all projects
 

Summary

Delete an item given its reference.


Pascal

 procedureRemove(varItem: IJvDataItem);


Parameters

Parameters Description
var Item: IJvDataItem Reference to the item to delete.


Description

Remove deletes the item specified by the Item parameter. Upon entry the parameter will be nilled (to dereference the item). This will avoid Access Violations when the caller's reference to the item goes out of scope and reference counting is performed.
If the item list is a static list (i.e. IJvDataItems.IsDynamic returns False) there is still a chance the item being deleted is still referenced outside the provider. Using that reference might then lead to Access Violations.
If the item list is a dynamic list (i.e. IJvDataItems.IsDynamic returns True) the deletion will normally be performed (i.e. the reference is removed from the list) but the item might still be referenced and usable after this fact. This will lead to the strange situation of IJvDataItem.GetItems referring to the IJvDataItems interface, but the list no longer contains that item.


See Also

IJvDataItemsManagement.Add, IJvDataItemsManagement.Delete


About

Contribute to this help topic

This documentation wiki is based on the collaborative effort of Project JEDI users. Your edits are welcome in order to improve documentation quality: edit this page