views:

1827

answers:

6

I'm working on a WinForm .Net application with the basic UI that includes toolbar buttons, menu items and keystrokes that all initiate the same underlying code. Right now the event handlers for each of these call a common method to perform the function.

From what I've read this type of action could be handled by the Command design pattern with the additional benefit of automatically enabling/disabling or checking/unchecking the UI elements.

I've been searching the net for a good example project, but really haven't found one. Does anyone have a good example that can be shared?

A: 

Try open source, .NET editors like SharpDevelop or Notepad++.

There is (naturally) some discussion of the Command Pattern at http://c2.com/cgi/wiki?CommandPattern that might be helpful.

ESV
A: 

@ESV I'ved tried looking through existing products, like SharpDevelop and StoryTeller. The difficulty is extracting the pattern from the actual product.

Notepad++ is written C++ and my C++ is very rusty. :-)

Rick
+7  A: 

Let's first make sure we know what the Command pattern is:

Command pattern encapsulates a request as an object and gives it a known public interface. Command Pattern ensures that every object receives its own commands and provides a decoupling between sender and receiver. A sender is an object that invokes an operation, and a receiver is an object that receives the request and acts on it.

Here's an example for you. There are many ways you can do this, but I am going to take an interface base approach to make the code more testable for you. I am not sure what language you prefer, but I am writing this in C#.

First, create an interface that describes a Command.

public interface ICommand
{
    void Execute();
}

Second, create command objects that will implement the command interface.

public class CutCommand : ICommand
{
    public void Execute()
    {
        // Put code you like to execute when the CutCommand.Execute method is called.
    }
}

Third, we need to setup our invoker or sender object.

public class TextOperations
{
    public void Invoke(ICommand command)
    {
        command.Execute();
    }
}

Fourth, create the client object that will use the invoker/sender object.

public class Client
{
    static void Main()
    {
        TextOperations textOperations = new TextOperations();
        textOperation.Invoke(new CutCommand());
    }
}

I hope you can take this example and put it into use for the application you are working on. If you would like more clarification, just let me know.

Dale Ragan
+1  A: 

@Dale: If we could extend your example a little more... Assuming we're working on a text editor and the cut command to extract text from document to the clipboard. I'm thinking we'd need a "Document" class to hold the text. So, an instance of the Document class is what the cutcommand needs work against. Where does that get integrated?

Also how does the command object get parameters, in the cut command example it would need to know what portion of the text to cut.

Rick
+1  A: 

Your on the right track. Basically you will have a model that represents the document. You will use this model in the CutCommand. You will want to change the CutCommand's constructor to accept the information you want to cut. Then everytime, say the Cut Button is clicked, you invoke a new CutCommand and passing the arguments in the constructor. Then use those arguments in the class when the Execute method is called.

Dale Ragan
A: 

Qt uses Command Pattern for Menubar/Toolbar items.

QActions are created seperately from QMenuItem and QToolbar, and the Actions can be assigned to QMenuItem and QToolbar with setAction() and addAction() method respectively.

http://cartan.cas.suffolk.edu/oopdocbook/html/menus.html

http://cartan.cas.suffolk.edu/oopdocbook/html/actions.html

Imran