javax.print
public abstract class ServiceUIFactory extends Object
ServiceUIFactory
enables print services to provide additional
user interface dialogs.
A print service may provide a ServiceUIFactory
implementation
if its getServiceUIFactory()
method is called. If a factory
object is returned it can be queried for provided user interface dialogs.
Different roles are defined to denote dialogs providing informations about
the print service, dialogs for administration of a print service and for
end-user browsing dialogs.
The factory can support providing these UI roles in different dialog types (AWT, Swing, JComponent, Panel). The support and use of Swing interfaces is however preferred.
Modifier and Type | Field and Description |
---|---|
static int |
ABOUT_UIROLE
A user interface providing informations about the print service.
|
static int |
ADMIN_UIROLE
A user interface to administer the print service.
|
static String |
DIALOG_UI
Identifies a UI provided as an AWT dialog.
|
static String |
JCOMPONENT_UI
Identifies a UI provided as a Swing JComponent.
|
static String |
JDIALOG_UI
Identifies a UI provided as a Swing JDialog.
|
static int |
MAIN_UIROLE
A user interface for end-user browsing of the print service.
|
static String |
PANEL_UI
Identifies a UI provided as an AWT Panel.
|
static int |
RESERVED_UIROLE
Role IDs greater than this may be used for other private roles.
|
Constructor and Description |
---|
ServiceUIFactory()
Constructs a
ServiceUIFactory object. |
Modifier and Type | Method and Description |
---|---|
abstract Object |
getUI(int role,
String ui)
Returns an UI object which may be cast to the requested UI type.
|
abstract String[] |
getUIClassNamesForRole(int role)
Returns the UI types supported by this factory for an UI role.
|
public static final int ABOUT_UIROLE
public static final int ADMIN_UIROLE
public static final int MAIN_UIROLE
public static final int RESERVED_UIROLE
public static final String DIALOG_UI
public static final String JCOMPONENT_UI
public static final String JDIALOG_UI
public static final String PANEL_UI
public ServiceUIFactory()
ServiceUIFactory
object.public abstract Object getUI(int role, String ui)
role
- the role requested. Must be one of the standard roles
or a private role supported by this factoryui
- type in which the role is requestedIllegalArgumentException
- if role
is neither one of
the standard ones nor a private one supported by this factorypublic abstract String[] getUIClassNamesForRole(int role)
role
- the role to be looked upIllegalArgumentException
- if role
is neither one of
the standard ones nor a private one supported by this factory