Kiwi 1.1.3b API Specification: Class DialogSet

Site

windows 2000
visual c++
java
visual basic
javascripts
recommend it

Book

thinking in java

Interact

forum
guest book
jobs
jokes
what's new

share code

Resource

add resource
modify resource
new resource

Get the weekly e-mail highlights on Java!

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

kiwi.ui.dialog
Class DialogSet

java.lang.Object
  |
  +--kiwi.ui.dialog.DialogSet

public class DialogSet
extends Object
implements PropertyChangeListener

This class is the Kiwi analogy to the Swing JOptionPane. It provides a simple interface for displaying some of the more commonly-used Kiwi dialogs without requiring any Dialog objects to be instantiated.

A placement policy may be assigned to a DialogSet; this policy defines where dialogs will appear relative to their owner Window. If there is no owner, dialogs will appear in the center of the screen.

Although each instance of DialogSet may have its own owner Window and placement policy, they will all share singleton instances of KMessageDialog, KQuestionDialog, and KInputDialog.

Version:: 1.0.1 (10/98)
Author:: Mark Lindner, PING Software Group
See Also:: KMessageDialog, KQuestionDialog, KInputDialog

Field Summary
`static int`	`CASCADE_PLACEMENT` Placement policy.
`static int`	`CENTER_PLACEMENT` Placement policy.

Constructor Summary
`DialogSet(Window owner, int placement)` Construct a new `DialogSet` with the given owner and placement policy.

Method Summary
`static DialogSet`	`getInstance()` Get a reference to the default instance of `DialogSet`.
`void`	`propertyChange(PropertyChangeEvent evt)` Respond to property change events.
`String`	`showInputDialog(String prompt)` Show a `KInputDialog`.
`String`	`showInputDialog(String title, Icon icon, String prompt)` Show a `KInputDialog`.
`String`	`showInputDialog(String title, Icon icon, String prompt, String defaultValue)` Show a `KInputDialog`.
`String`	`showInputDialog(String prompt, String defaultValue)` Show a `KInputDialog`.
`void`	`showMessageDialog(String message)` Show a `KMessageDialog`.
`void`	`showMessageDialog(String title, Icon icon, String message)` Show a `KMessageDialog`.
`boolean`	`showQuestionDialog(String prompt)` Show a `KQuestionDialog`.
`boolean`	`showQuestionDialog(String title, Icon icon, String prompt)` Show a `KQuestionDialog`.
`boolean`	`showQuestionDialog(String title, Icon icon, String prompt, int type)` Show a `KQuestionDialog`.
`boolean`	`showQuestionDialog(String prompt, int type)` Show a `KQuestionDialog`.

Methods inherited from class java.lang.Object

clone, 
equals, 
finalize, 
getClass, 
hashCode, 
notify, 
notifyAll, 
toString, 
wait, 
wait, 
wait

Field Detail

CENTER_PLACEMENT

public static final int CENTER_PLACEMENT

Placement policy. Display dialogs centered within the bounds of their owner Window.

CASCADE_PLACEMENT

public static final int CASCADE_PLACEMENT

Placement policy. Display dialogs cascaded off the top-left corner of their owner Window.

Constructor Detail

DialogSet

public DialogSet(Window owner,
                 int placement)
          throws IllegalArgumentException

Construct a new DialogSet with the given owner and placement policy.

Parameters:: owner - The Window that is the owner of this DialogSet.; placement - The placement for dialogs in this DialogSet; one of the numeric constants defined above.

Method Detail

getInstance

public static DialogSet getInstance()

Get a reference to the default instance of DialogSet. This instance has no owner Window, and hence its dialogs appear centered on the screen.

Returns:: The default (singleton) instance.

showInputDialog

public String showInputDialog(String prompt)

Show a KInputDialog. Displays an input dialog and returns when the dialog is dismissed.

Parameters:: prompt - The prompt to display in the dialog.
Returns:: The text that was entered in the dialog, or null if the dialog was cancelled.

showInputDialog

public String showInputDialog(String prompt,
                              String defaultValue)

Show a KInputDialog. Displays an input dialog and returns when the dialog is dismissed.

Parameters:: prompt - The prompt to display in the dialog.; defaultValue - The default value to display in the input field.
Returns:: The text that was entered in the dialog, or null if the dialog was cancelled.

showInputDialog

public String showInputDialog(String title,
                              Icon icon,
                              String prompt)

Show a KInputDialog. Displays an input dialog and returns when the dialog is dismissed.

Parameters:: title - The title for the dialog window.; icon - The icon to display in the dialog.; prompt - The prompt to display in the dialog.
Returns:: The text that was entered in the dialog, or null if the dialog was cancelled.

showInputDialog

public String showInputDialog(String title,
                              Icon icon,
                              String prompt,
                              String defaultValue)

Show a KInputDialog. Displays an input dialog and returns when the dialog is dismissed.

Parameters:: title - The title for the dialog window.; icon - The icon to display in the dialog.; prompt - The prompt to display in the dialog.; defaultValue - The default value to display in the input field.
Returns:: The text that was entered in the dialog, or null if the dialog was cancelled.

showQuestionDialog

public boolean showQuestionDialog(String prompt,
                                  int type)

Show a KQuestionDialog. Displays a question dialog and returns when the dialog is dismissed.

Parameters:: prompt - The prompt to display in the dialog.; type - The question dialog type to display; one of the symbolic constants defined in KQuestionDialog.
Returns:: The status of the dialog; true if the dialog was accepted or false if it was cancelled.

showQuestionDialog

public boolean showQuestionDialog(String prompt)

Show a KQuestionDialog. Displays a question dialog and returns when the dialog is dismissed.

Parameters:: prompt - The prompt to display in the dialog.
Returns:: The status of the dialog; true if the dialog was accepted or false if it was cancelled.

showQuestionDialog

public boolean showQuestionDialog(String title,
                                  Icon icon,
                                  String prompt)

Show a KQuestionDialog. Displays a question dialog and returns when the dialog is dismissed.

Parameters:: title - The title for the dialog window.; icon - The icon to display in the dialog.; prompt - The promopt to display in the dialog.
Returns:: The status of the dialog; true if the dialog was accepted or false if it was cancelled.

showQuestionDialog

public boolean showQuestionDialog(String title,
                                  Icon icon,
                                  String prompt,
                                  int type)

Show a KQuestionDialog. Displays a question dialog and returns when the dialog is dismissed.

Parameters:: title - The title for the dialog window.; icon - The icon to display in the dialog.; prompt - The promopt to display in the dialog.; type - The question dialog type to display; one of the symbolic constants defined in KQuestionDialog.
Returns:: The status of the dialog; true if the dialog was accepted or false if it was cancelled.

showMessageDialog

public void showMessageDialog(String message)

Show a KMessageDialog. Displays a message dialog and returns when the dialog is dismissed.

Parameters:: prompt - The prompt to display in the dialog.

showMessageDialog

public void showMessageDialog(String title,
                              Icon icon,
                              String message)

Show a KMessageDialog. Displays a message dialog and returns when the dialog is dismissed.

Parameters:: title - The title for the dialog window.; icon - The icon to display in the dialog.; prompt - The prompt to display in the dialog.

propertyChange

public void propertyChange(PropertyChangeEvent evt)

Respond to property change events.

Specified by:: propertyChange in interface PropertyChangeListener

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

internet.commerce

Acceptable Use Policy

Search:

Jupitermedia Corporation has two divisions: Jupiterimages and JupiterOnlineMedia

Jupitermedia Corporate Info

Legal Notices, Licensing, Reprints, & Permissions, Privacy Policy.

Web Hosting | Newsletters | Tech Jobs | Shopping | E-mail Offers

kiwi.ui.dialog Class DialogSet

CENTER_PLACEMENT

CASCADE_PLACEMENT

DialogSet

getInstance

showInputDialog

showInputDialog

showInputDialog

showInputDialog

showQuestionDialog

showQuestionDialog

showQuestionDialog

showQuestionDialog

showMessageDialog

showMessageDialog

propertyChange

kiwi.ui.dialog
Class DialogSet