The tool seems to be perfect, but it lacks examples

I am trying to use itmill toolkit 5, so far so good, bad not in an easy way, your tool is good but the examples are meant for experienced programmers.

Example: Young programmers who want to create a small module of single application with single functionality, has to break down your example to have fugured out that one part wants to emplement.

I want to create a notification function, just an error notification. And i am reading the manual and i found this example

package com.itmill.toolkit.demo.featurebrowser;

import java.util.Date;

import com.itmill.toolkit.ui.AbstractSelect;
import com.itmill.toolkit.ui.Button;
import com.itmill.toolkit.ui.CustomComponent;
import com.itmill.toolkit.ui.NativeSelect;
import com.itmill.toolkit.ui.OrderedLayout;
import com.itmill.toolkit.ui.RichTextArea;
import com.itmill.toolkit.ui.TextField;
import com.itmill.toolkit.ui.Window;
import com.itmill.toolkit.ui.Button.ClickEvent;
import com.itmill.toolkit.ui.Button.ClickListener;

 * Demonstrates the use of Notifications.
 * @author IT Mill Ltd.
 * @see com.itmill.toolkit.ui.Window
public class NotificationExample extends CustomComponent {

    // Dropdown select for notification type, using the native dropdown
    NativeSelect type;
    // Textfield for the notification caption
    TextField caption;
    // Textfield for the notification content
    TextField message;

     * Default constructor; We're subclassing CustomComponent, so we need to
     * choose a root component and set it as composition root.
    public NotificationExample() {
        // Main layout
        final OrderedLayout main = new OrderedLayout();
        main.setMargin(true); // use theme-specific margin

        // Create the 'type' dropdown select.
        type = new NativeSelect("Notification type");
        // no empty selection allowed
        // we want a different caption than the value
        type.addContainerProperty("caption", String.class, null);
        // add some content (items) using the Container API
        Item i = type.addItem(new Integer(
        i.getItemProperty("caption").setValue("Humanized message");
        i = type.addItem(new Integer(Window.Notification.TYPE_WARNING_MESSAGE));
        i.getItemProperty("caption").setValue("Warning message");
        i = type.addItem(new Integer(Window.Notification.TYPE_ERROR_MESSAGE));
        i.getItemProperty("caption").setValue("Error message");
        i = type
                .addItem(new Integer(Window.Notification.TYPE_TRAY_NOTIFICATION));
        i.getItemProperty("caption").setValue("Tray notification");
        // set the initially selected item
        type.setValue(new Integer(Window.Notification.TYPE_HUMANIZED_MESSAGE));

        // Notification caption
        caption = new TextField("Caption");
        caption.setValue("Brown Fox!");

        // Notification message
        message = new RichTextArea();
        message.setValue("A quick one jumped over the lazy dog.");

        // Button to show the notification
        final Button b = new Button("Show notification", new ClickListener() 
            // this is an inline ClickListener
            public void buttonClick(ClickEvent event) 
                // show the notification
                getWindow().showNotification((String) caption.getValue(),
                        (String) message.getValue(),
                        ((Integer) type.getValue()).intValue());
                getWindow().setCaption(new Date().toString());
        main.setComponentAlignment(b, OrderedLayout.ALIGNMENT_RIGHT,

Now I am looking just for error notification not the whole bunch of complex example.

so can someone please think about us, and make simple example of:

warning Notification example
error notification example
humanized notification example etc.

Please…we also need to learn to become like you guys.

Hope we will be considered so that we enjoy using the new tool which seem to be nice.

Its me,


I agree, there should be more simple examples. The goal is to give a short example in the manual for each functionality. For some of the more complex functionalities, it is sometimes easiest to give an entire source code file and explain details in code comments.

I want to create a notification function, just an error notification. And i am reading the manual and i found this example
[/quote]Actually, the example is not from the manual but from the demos. The manual does not yet have a section about notifications. It’s yet to be written, but I’ll add it high in my queue.

Anyhow, below is an example for displaying a warning:

// show a warning
mainwindow.showNotification("This is the caption",
                            "This is the notification message",

To display an error, humanized, or tray message, just use TYPE_ERROR_MESSAGE, TYPE_HUMANIZED_MESSAGE, or TYPE_TRAY_MESSAGE, respectively.