Description: Adds or creates a new Item, adds it to a C{collection} and displays it properly. If the event's arguments dictionary contains an item with the key "item", that will be used as the item to display. Otherwise if the NewItemEvent implements the C{onNewItem} method it will be called to create the item. This is handy if you want to use a dialog to get some information to create the item. If C{onNewItem} returns None, no Item will be created. If you didn't implement C{onNewItem} the C{classParameter} attribute is used to determine what item to create. The attribute has a default value of C{MissingClass}; in this case in Item matching the ApplicationBar is created; e.g. if you're in Calendar View you'll get an Item that has been stamped as an Event; if you're in All you'll get a Note. To create a specific item, you can either: 1. Specify a Kind's class as the C{classParameter} e.g. C{osaf.pim.Note} will force creation of a Note, no matter what's selected in the ApplicationBar. 2. Specify a subclass of C{osaf.pim.Stamp} to create a Note with the appropriate stamp. E.g. C{osaf.pim.Task} will get you a Task Item (i.e. a Note stamped as a Task). The view in the sidebar is switched to match the kind, e.g. if you create an Event, you'll switch to the Calendar View. If there isn't a kind specific view, you'll switch to All view. If the C{collection} is None or it's not a UserCollection, the Item will be added to the all collection. If you specify a C{collectionAddEvent} that references an AddToSidebarEvent and your C{collection} is not in the Sidebar, it will be used to add your C{collection} if it's not in the sidebar.