Overriding OperationBase Class Methods

The only methods of the OperationBase class that an external operation must override are OnInitialize and OnExecuteOperationInProjectItem. However, the external operation can be interested in performing some action in the following events:

• Before the operation starts: it can override the OnBeforeExecuteOperation method.
• After the operation ends: it can override the OnAfterExecuteOperation method.
• Before the operation processes a solution: it can override the OnBeforeExecuteOperationInSolution method.
• After the operation processes a solution: it can override the OnAfterExecuteOperationInSolution method.
• Before the operation processes a project: it can override the OnBeforeExecuteOperationInProject method.
• After the operation processes a project: it can override the OnAfterExecuteOperationInProject method.
• Before the operation processes a folder: it can override the OnExecuteOperationInFolderProjectItem method.
• After the operation has been cancelled: it can override the OnCancelOperation method.

If the operation uses a result window, it can override the OnAfterLocateXXX methods to be notified when the user has located a result in the result window. For example, the ControlTextSpellingReviewOperation overrides the OnAfterLocateComponentResult method to show a window with spelling corrections after the user has selected a control with spelling errors in the result window. See Adding Output to the Result Window.

Finally, the external operation must override other methods in the following cases:

• If it provides Admin options, it must override the OnCreateAdminOptions method. See Providing Admin Options.
• If it provides User options, it must override the OnCreateUserOptionsForExecution method. See Providing User Options.
• If it must be executed before a build, it must override the OnCreateUserOptionsForExecutionBeforeBuild method. See Executing the Operation Before Build.
• If it offers the current procedure and the selected text as valid scopes, it must override the OnExecuteOperationInTextRange method.

The external operations provided as examples show the usage of all these cases.