where the receiver is a file. Returns
to accept responsibility for implementing this operation as per the API contract.
In broad terms, a full re-implementation should delete the file in the local file system and then call
tree.deletedFile to complete the updating of the workspace resource tree to reflect this fact. If unsuccessful in deleting the file from the local file system, it should instead call
tree.failed to report the reason for the failure. In either case, it should return
true to indicate that the operation was attempted. The
FORCE update flag needs to be honored: unless
FORCE is specified, the implementation must use
tree.isSynchronized to determine whether the file is in sync before attempting to delete it. The
KEEP_HISTORY update flag needs to be honored as well; use
tree.addToLocalHistory to capture the contents of the file before deleting it from the local file system.
An extending implementation should perform whatever pre-processing it needs to do and then call
tree.standardDeleteFile to explicitly invoke the standard file deletion behavior, which deletes both the file from the local file system and updates the workspace resource tree. It should return
true to indicate that the operation was attempted.
false is the easy way for the implementation to say "pass". It is equivalent to calling
tree.standardDeleteFile and returning
The implementation of this method runs "below" the resources API and is therefore very restricted in what resource API method it can call. The list of useable methods includes most resource operations that read but do not update the resource tree; resource operations that modify resources and trigger deltas must not be called from within the dynamic scope of the invocation of this method.
@param tree the workspace resource tree; this object is only valid for the duration of the invocation of this method, and must not be used after this method has completed
@param file the handle of the file to delete; the receiver of
@param updateFlags bit-wise or of update flag constants as per
@param monitor the progress monitor, or
if this method declined to assume responsibility for this operation, and
if this method attempted to carry out the operation
@exception OperationCanceledException if the operation is canceled. Cancelation can occur even if no progress monitor is provided.