Interface IAdvancedUndoableOperation2
- All Known Implementing Classes:
AbstractWorkspaceOperation,CopyProjectOperation,CopyResourcesOperation,CreateFileOperation,CreateFolderOperation,CreateMarkersOperation,CreateProjectOperation,DeleteMarkersOperation,DeleteResourcesOperation,MoveProjectOperation,MoveResourcesOperation,TriggeredOperations,UpdateMarkersOperation
IAdvancedUndoableOperation2 defines a method for computing the validity of
executing an operation before attempting to execute it. It also defines a way
for clients to specify that computing status should be done quietly, without
consulting the user. This interface is useful when implementing
IOperationApprover2, or any other object that performs validation of
the undo history. It also allows operations to specify whether they should be
run in the UI thread.
- Since:
- 3.3
-
Method Summary
Modifier and TypeMethodDescriptioncomputeExecutionStatus(IProgressMonitor monitor) Return a status indicating the projected outcome of executing the receiver.booleanReturn a boolean that instructs whether the operation should be executed, undone, or redone in a background thread.voidsetQuietCompute(boolean quiet) Set a boolean that instructs whether the computation of the receiver's execution, undo, or redo status should quietly compute status without consulting or prompting the user.
-
Method Details
-
computeExecutionStatus
Return a status indicating the projected outcome of executing the receiver. This method should be used to report the possible outcome of executing an operation when computing the validity of an execute is too expensive to perform inIUndoableOperation.canExecute(). It is not called by the operation history, but instead is used by clients (such as implementers ofIOperationApprover2) who wish to perform advanced validation of an operation before attempting to execute it. If the result of this method is the discovery that an operation can in fact not be executed, then the operation is expected to correctly answerfalseon subsequent calls toIUndoableOperation.canExecute().- Parameters:
monitor- the progress monitor (ornull) to use for reporting progress to the user while computing the validity.- Returns:
- the IStatus indicating the validity of the execute. The status
severity should be set to
OKif the execute can successfully be performed, andERRORif it cannot. Any other severity is assumed to represent an ambiguous state. - Throws:
ExecutionException- if an exception occurs while computing the validity.
-
setQuietCompute
void setQuietCompute(boolean quiet) Set a boolean that instructs whether the computation of the receiver's execution, undo, or redo status should quietly compute status without consulting or prompting the user. The default value isfalse. This flag should only be set totruewhile the execution, undo, or redo status computations are being performed in the background, and should be restored tofalsewhen complete.If the status computation methods typically need to consult the user in order to determine the severity of a particular situation, the least severe status that could be chosen by the user should be returned when this flag is
true. This can help to prevent overzealous disposal of the operation history when an operation is in an ambiguous state. Typically, the status computation methods are invoked with this flag set tofalsejust before the actual execution, undo, or redo occurs, so the user can be consulted for the final outcome.- Parameters:
quiet-trueif it is inappropriate to consult or otherwise prompt the user while computing status, andfalseif the user may be prompted.- See Also:
-
runInBackground
boolean runInBackground()Return a boolean that instructs whether the operation should be executed, undone, or redone in a background thread.- Returns:
trueif the operation should be run in the background,falseif it should not.
-