Understanding Gui and Listeners

Question

I'd like to ask you couple of question about Gui.

I saw the following example:

public class ShellWithButton {
    public static void main(String[] args) {
    Display display = Display.getDefault();
    Shell shell = newShell (display);
    Button ok = newButton (shell, SWT.PUSH);
    ok.setText ("Push Me!");
    ok.addSelectionListener(new ButtonHandler());
    ok.setLocation(0,0);
    ok.setSize(100,30);
    shell.pack ();
    shell.open ();
    while(!shell.isDisposed ()) {
     if(!display.readAndDispatch())
         display.sleep ();
          }
       display.dispose ();
        }
    }    

public class ButtonHandler 
 implements SelectionListener {
   public void widgetSelected(SelectionEvent e) {
       if(e.getSource() instanceofButton) {
          Button b = (Button) e.getSource();
          b.setText("Thanks!");
      }
   }
public voidwidgetDefaultSelected(SelectionEvent e){
 // TODO Auto-generated method stub
   }
 }

(i)- Someone pushes the button- How does the program know to activate widgetSelected? I can see that the button added the ButtonHandler listener to itself, but why that the pushing the button and not just clicking the box will send the event to ButtonHandler? I can't see where only the pushing was sent to this listener.

(ii)-why do I send an instance of the ButtonHandler to the listeners? what does that mean?

(iii)- what's happeing when I push the button? what is this event? event is an instance of the button itself?

(iv)- Button b = (Button) e.getSource(); why do I need this casting of the source? the event, as was written, can come only from ok, which is instance of button.

(v)- why that the original button will change its title? we change B.

Thank you very much!

Answer 1

1. When someone pushes the button, the button calls widgetSelected() because that's how the library was designed; it needs to call some method so you can do something and they settled on that method. The reason it calls YOUR widgetSelected() is because you gave it your class for it to call. The button knows your class has a widgetSelected() method because you implemented SelectionListener, and that requires you to implement the widgetSelected() method. That is the very reason for interfaces, and I suggest you read up on them. Only clicking the button will get the button to call your method because the button only knows when it is clicked. When there is a click on the screen, only the widgets that need to know about it are told.

2. As I mentioned above, you send your handler to the button so it knows what to do when it's pushed.

3. When the button is pushed, it has to tell your handler what happened, and so all the relevant information is given to you as a SelectionEvent. The event itself isn't the button, but the event tells you which button is pushed, in case you want the same handler to handle more than one button.

4. You need the cast because your widgetSelected() method can be called when something happens to all sorts of GUI objects, not just buttons. Therefore, the source is given as some superclass common to all the widgets that can call your method, and you need to cast it back to a button when you're sure it's your button. Yes, in this program it can only be called by the button, but that's not always the case.

5. The button's text changes because B and the button you created and displayed are the same object. Objects (and arrays) in Java are "pointers," they tell you where the object is. When you assign one object to another variable, you're not copying the object, you're just using another variable to point to the same object.