4.03 Generator Items (R7)

Skip to end of metadata
Go to start of metadata

So you’ve seen those fancy menu items in the Generate menu (Alt+Insert) and you want to write your own? Okay, we’ll tell you how. But first, you have to realize that, really, those generator items are not specific to the Generate menu per se. For example, the Generate Missing Members item is mirrored as a Quick Fix. Still, we’ll be talking about generator items here.

Provider

Right, let’s get started with the GenerateProvider – a provider class that determines which generator workflows are provided to the user. This may sound confusing so let’s go through it all one step at a time.

First, we create the generate provider body and appropriate attribute:

The above method yield s all the necessary workflows, even if they are unavailable or not enabled. The classes it yields are expected to implement IGenerateActionWorkflow, but typically inherit from StandardGenerateItemWorkflow.

The workflow typically defines its own characteristic. However, we can pass an icon from the point where it is created:

We have a generate provider, but what about the items it provides? That’s coming next.

Workflow

A workflow is simply a process defining how the action looks. Most of the StandardGenerateActionWorkflow that we’ll be using is actually a call to its base class that configures the various properties that subsequently affect the way the menu item is displayed.

In the above declaration, we specify that we have a menu item with a kind of “Dispose”. Note that this parameter is the glue which connects it to the generator element provider (more on this later), so it’s important to get it right.

Another thing you need to define is the order in which the item appears in the Generate menu. It is recommended that you put in a suitably large value so that your menu item doesn’t get mixed with existing ones.

Now, all is good but the above won’t work. The problem is that we’ve defined our own item kind, which goes against ReSharper’s policy of only enabling items of a well-known kind. As a result, we also redefine the IsAvailable() method, taking ReSharper’s own implementation and removing the kind check: