SDelayedEventModel.java :  » Swing-Library » wings3 » org » wings » Java Open Source

/*
 * Copyright 2000,2005 wingS development team.
 *
 * This file is part of wingS (http://wingsframework.org).
 *
 * wingS is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License
 * as published by the Free Software Foundation; either version 2.1
 * of the License, or (at your option) any later version.
 *
 * Please see COPYING for the complete licence.
 */
package org.wings;

/**
 * For components/models that should not fire events immediately when they occur, but on request (internal). 
 *
 * @author <a href="mailto:haaf@mercatis.de">Armin Haaf</a>
 */
public interface SDelayedEventModel {
    /**
     * if this is set to true, events are not fired immediately. They are
     * collected and fired after setting this to false...
     */
    void setDelayEvents(boolean b);


    boolean getDelayEvents();

    /**
     * fire delayed events which describes a "in progress"
     * state change, like TreeWillExpand, or ListSelectionEvent with
     * getIsAdjusting() true, ...
     */
    void fireDelayedIntermediateEvents();

    /**
     * fire remaining delayed events. In this level all events, which
     * are important to an application should be fired. All listeners, which are
     * notified in this level can assume that the components are in a consistent
     * (considering user interaction) state.
     */
    void fireDelayedFinalEvents();
}