Overview (NetBeans Dialogs API) - NetBeans API Javadoc 5.0.0

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV NEXT

FRAMES NO FRAMES

NetBeans Dialogs API

See:
Description

Dialogs API

org.openide Miscellaneous general classes, especially the util classes to handle a user notifications, displaying dialogs and wizards.

What is New (see all changes)?

Dec 6 '05 Interface AsynchronousInstantiatingIterator added
The AsynchronousInstantiatingIterator allows to implement asynchronous instantating of newly created objects. Wizard's framework esures that the method AsynchronousInstantiatingIterator.instantiate() will be called ouside of an event queue.
May 16 '05 Interface AsynchronousValidationgPanel added
The AsynchronousValidatingPanel allows to implement background validation that does not block UI thread. I.e. UI thread can be used to render validation progress.
Mar 28 '05 Add method NotifyDescriptor.getDefaultValue()
The NotifyDescriptor.getDefaultValue() returns object which represents the default value. This default value is introduced in the constructor of NotifyDescriptor.
Jan 8 '05 Added paramater leaf to DialogDescriptor

Added the parameter leaf in constructor of the DialogDescriptor. The parameter is not mandatory and can be set manually. If this parameter is false (as default), all works as before. If the parameter leaf is true, then a dialog which is created by this descriptor cannot own any other windows.
Jul 2 '04 Added WizardDescriptor.getInstantiatedObjects
Added the new method Set getInstantiatedObjects. This method returns set of newly instantiated objects if the wizard has been correctly finished. The empty set is returned as default, if the wizard uses the InstantiatingIterator then returns a set of Object as same as InstantiatingIterator.instantiate() does. The method throws the exception IllegalStateException if this method is called on the unfinished wizard.

Use Cases

There is a Wizard Guide Book providing the introductionary information, moreover here is a list of frequently asked questions and their answers:

How to change the title of a wizard?

Q: Although none of my panels have names set (using setName() method) and the method name() in the WizardDescriptor.Iterator returns an empty string, I'm getting "wizard ( )" as the title of each panel in my wizard. When I set the name of the panel and return a string from the method name() I get: "panelName wizard (myName)". The wizard steps are labeled correctly, it just the panel title/name that looks like it adds "wizard ()" to any of my panels. I don't mind the "( )", but I would like to rid of the word "wizard".

A: You can change the format of your wizard's title by WizardDescriptor.setTitleFormat(MessageFormat format) and rid of 'wizard' word in the default wizard's title.

Exported Interfaces

This table lists all of the module exported APIs with defined stability classifications. It is generated based on answers to questions about the architecture of the module. Read them all...

Group of java interfaces

Interface Name	In/Out	Stability	Specified in What Document?
DialogsAPI	Exported	Official	.../org/openide/package-summary.html

Implementation Details

Read more about the implementation in the answers to architecture questions.