// YesNoCancelBox - a Yes/No/Cancel box
//
// Copyright (C) 1996 by Jef Poskanzer <jef@acme.com>.  All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions
// are met:
// 1. Redistributions of source code must retain the above copyright
//    notice, this list of conditions and the following disclaimer.
// 2. Redistributions in binary form must reproduce the above copyright
//    notice, this list of conditions and the following disclaimer in the
//    documentation and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
// ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
// FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
// DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
// OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
// HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
// LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
// OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
// SUCH DAMAGE.
//
// Visit the ACME Labs Java page for up-to-date versions of this and other
// fine Java utilities: http://www.acme.com/java/

package Acme.Widgets;

import java.awt.*;

/// A Yes/No/Cancel box.
// <P>
// Puts up a dialog with a specified message and three buttons, Yes No
// and Cancel.  All user input is locked out.  The program can retrieve
// the user's answer via the getAnswer() method.
// <P>
// Sample usage:
// <IMG ALIGN=RIGHT WIDTH=199 HEIGHT=79 SRC="YesNoCancelBox.gif">
// <BLOCKQUOTE><PRE><CODE>
// YesNoCancelBox ync = new YesNoCancelBox( this, "Sample YesNoCancelBox" );
// ync.show();
// switch ( ync.getAnswer() )
//     {
//     case YesNoCancelBox.YES:
//     [your code here]
//     break;
//     case YesNoCancelBox.NO:
//     [your code here]
//     break;
//     case YesNoCancelBox.CANCEL:
//     [your code here]
//     break;
//     }
// </CODE></PRE></BLOCKQUOTE>
// <P>
// <A HREF="/resources/classes/Acme/Widgets/YesNoCancelBox.java">Fetch the software.</A><BR>
// <A HREF="/resources/classes/Acme.tar.Z">Fetch the entire Acme package.</A>

public class YesNoCancelBox extends ButtonDialog
    {

    // Enumerated values.

    public static final int YES = WidgetUtils.YES;
    public static final int NO = WidgetUtils.NO;
    public static final int CANCEL = WidgetUtils.CANCEL;

    /// Constructor, default title.
    public YesNoCancelBox( Frame parent, String message )
	{
	this( parent, "Yes/No/Cancel", message );
	}

    /// Constructor, specified title.
    public YesNoCancelBox( Frame parent, String title, String message )
	{
	super( parent, title, message, "Yes", YES, "No", NO, "Cancel", CANCEL );
	}
    
    }