org.openide

Interface WizardDescriptor.AsynchronousValidatingPanel<Data>

All Superinterfaces:

WizardDescriptor.Panel<Data>, WizardDescriptor.ValidatingPanel<Data>

All Known Subinterfaces:

WizardDescriptor.ExtendedAsynchronousValidatingPanel<Data>

Enclosing class:

WizardDescriptor

public static interface WizardDescriptor.AsynchronousValidatingPanel<Data>
extends WizardDescriptor.ValidatingPanel<Data>

A special interface for panels that need to do additional asynchronous validation when Next or Finish button is clicked.

During background validation is Next or Finish button disabled. On validation success wizard automatically progress to next panel or finishes.

During background validation Cancel button is hooked to signal the validation thread using interrupt().

Note: It is recommended to use ExtendedAsynchronousValidatingPanel instead as it adds a method to conveniently unlock wizard's user interface when the validation is finished.

Since:

6.2 (16 May 2005)

Method Summary

Modifier and Type	Method and Description
void	prepareValidation() Called synchronously from UI thread when Next of Finish buttons clicked.
void	validate() Is called in separate thread when Next of Finish buttons are clicked and allows deeper check to find out that panel is in valid state and it is ok to leave it.

Methods inherited from interface org.openide.WizardDescriptor.Panel

addChangeListener, getComponent, getHelp, isValid, readSettings, removeChangeListener, storeSettings

Method Detail

prepareValidation

void prepareValidation()

Called synchronously from UI thread when Next of Finish buttons clicked. It allows to lock user input to assure official data for background validation.

validate

void validate()
       throws WizardValidationException

Is called in separate thread when Next of Finish buttons are clicked and allows deeper check to find out that panel is in valid state and it is ok to leave it.

Specified by:

validate in interface WizardDescriptor.ValidatingPanel<Data>

Throws:

WizardValidationException - when validation fails