package org.litesoft.sandbox.multimodule.client.foundation.util;

import com.google.gwt.event.shared.*;
import com.google.gwt.user.client.*;

/**
 * Interface to Window-related events. Provides nice
 * isolation for unit testing, and allows customization of confirmation
 * handling.
 */
public interface WindowClose
{
    /**
     * Adds a {@link Window.ClosingHandler} to the Delegate.
     *
     * @param pHandler a {@link Window.ClosingHandler} instance
     *
     * @return a {@link HandlerRegistration} instance
     */
    HandlerRegistration addWindowClosingHandler( Window.ClosingHandler pHandler );

    /**
     * Called to confirm a window closing event.
     *
     * @param pMessage a warning message
     *
     * @return true to allow the window closing
     */
    boolean confirm( String pMessage );
}