messagebox.java

非常接近C/S操作方式的Java Ajax框架－ZK 用ZK框架使你的B/S应用程序更漂亮更易操作。 官网：www.zkoss.org

/* Messagebox.java

{{IS_NOTE
	Purpose:
		
	Description:
		
	History:
		Thu Nov 24 15:09:25     2005, Created by tomyeh
}}IS_NOTE

Copyright (C) 2005 Potix Corporation. All Rights Reserved.

{{IS_RIGHT
	This program is distributed under GPL Version 2.0 in the hope that
	it will be useful, but WITHOUT ANY WARRANTY.
}}IS_RIGHT
*/
package org.zkoss.zhtml;

import org.zkoss.mesg.Messages;
import org.zkoss.zk.ui.WebApp;
import org.zkoss.zk.ui.UiException;

/**
 * Represents the message box.
 *
 * <p>You don't create {@link Messagebox} directly. Rather, use {@link #show}.
 * 
 * <p>A non-XHTML extension.
 *
 * @author tomyeh
 */
public class Messagebox {
	/** A symbol consisting of a question mark in a circle. */
	public static final String QUESTION = org.zkoss.zul.Messagebox.QUESTION;
	/** A symbol consisting of an exclamation point in a triangle with
	 * a yellow background.
	 */
	public static final String EXCLAMATION  = org.zkoss.zul.Messagebox.EXCLAMATION;
	/** The same as {@link #EXCLAMATION}.
	 */
	public static final String INFORMATION = EXCLAMATION;
	/** A symbol consisting of a white X in a circle with a red background. */
	public static final String ERROR = org.zkoss.zul.Messagebox.ERROR;
	/** Contains no symbols. */
	public static final String NONE = null;

	/** A OK button. */
	public static final int OK = org.zkoss.zul.Messagebox.OK;
	/** A Cancel button. */
	public static final int CANCEL = org.zkoss.zul.Messagebox.CANCEL;
	/** A Yes button. */
	public static final int YES = org.zkoss.zul.Messagebox.YES;
	/** A No button. */
	public static final int NO = org.zkoss.zul.Messagebox.NO;
	/** A Abort button. */
	public static final int ABORT = org.zkoss.zul.Messagebox.ABORT;
	/** A Retry button. */
	public static final int RETRY = org.zkoss.zul.Messagebox.RETRY;
	/** A IGNORE button. */
	public static final int IGNORE = org.zkoss.zul.Messagebox.IGNORE;

	/** Shows a message box and returns what button is pressed.
	 *
	 * @param title the title. If null, {@link WebApp#getAppName} is used.
	 * @param buttons a combination of {@link #OK}, {@link #CANCEL},
	 * {@link #YES}, {@link #NO}, {@link #ABORT}, {@link #RETRY},
	 * and {@link #IGNORE}. If zero, {@link #OK} is assumed
	 * @param icon one of predefined images: {@link #QUESTION},
	 * {@link #EXCLAMATION}, {@link #ERROR}, {@link #NONE}, or any URI of
	 * an image.
	 * @return the button being pressed (one of {@link #OK}, {@link #CANCEL},
	 * {@link #YES}, {@link #NO}, {@link #ABORT}, {@link #RETRY},
	 * and {@link #IGNORE}).
	 */
	public static final
	int show(String message, String title, int buttons, String icon)
	throws InterruptedException {
		return org.zkoss.zul.Messagebox.show(message, title, buttons, icon);
	}
	/** Shows a message box and returns what button is pressed.
	 * A shortcut to show(message, null, OK, INFORMATION).
	 */
	public static final int show(String message)
	throws InterruptedException {
		return show(message, null, OK, INFORMATION);
	}
	/** Shows a message box by specifying a message code, and returns what
	 * button is pressed.
	 *
	 * @param titleCode the message code for the title. If non-positive,
	 * the default title is used.
	 */
	public static final
	int show(int messageCode, Object[] args, int titleCode, int button, String icon)
	throws InterruptedException {
		return show(Messages.get(messageCode, args),
			titleCode > 0 ? Messages.get(titleCode): null, button, icon);
	}
	/** Shows a message box by specifying a message code, and returns what
	 * button is pressed.
	 *
	 * @param titleCode the message code for the title. If non-positive,
	 * the default title is used.
	 */
	public static final
	int show(int messageCode, Object arg, int titleCode, int button, String icon)
	throws InterruptedException {
		return show(Messages.get(messageCode, arg),
			titleCode > 0 ? Messages.get(titleCode): null, button, icon);
	}
	/** Shows a message box by specifying a message code, and returns what
	 * button is pressed.
	 *
	 * @param titleCode the message code for the title. If non-positive,
	 * the default title is used.
	 */
	public static final
	int show(int messageCode, int titleCode, int button, String icon)
	throws InterruptedException {
		return show(Messages.get(messageCode),
			titleCode > 0 ? Messages.get(titleCode): null, button, icon);
	}
}