Presents a dialog to the user for selecting a print service (printer).
It is displayed at the location specified by the application and
is modal.
If the specification is invalid or would make the dialog not visible it
will be displayed at a location determined by the implementation.
The dialog blocks its calling thread and is application modal.
The dialog may include a tab panel with custom UI lazily obtained from
the PrintService's ServiceUIFactory when the PrintService is browsed.
The dialog will attempt to locate a MAIN_UIROLE first as a JComponent,
then as a Panel. If there is no ServiceUIFactory or no matching role
the custom tab will be empty or not visible.
The dialog returns the print service selected by the user if the user
OK's the dialog and null if the user cancels the dialog.
An application must pass in an array of print services to browse.
The array must be non-null and non-empty.
Typically an application will pass in only PrintServices capable
of printing a particular document flavor.
An application may pass in a PrintService to be initially displayed.
A non-null parameter must be included in the array of browsable
services.
If this parameter is null a service is chosen by the implementation.
An application may optionally pass in the flavor to be printed.
If this is non-null choices presented to the user can be better
validated against those supported by the services.
An application must pass in a PrintRequestAttributeSet for returning
user choices.
On calling the PrintRequestAttributeSet may be empty, or may contain
application-specified values.
These are used to set the initial settings for the initially
displayed print service. Values which are not supported by the print
service are ignored. As the user browses print services, attributes
and values are copied to the new display. If a user browses a
print service which does not support a particular attribute-value, the
default for that service is used as the new value to be copied.
If the user cancels the dialog, the returned attributes will not reflect
any changes made by the user.
A typical basic usage of this method may be :
PrintService[] services = PrintServiceLookup.lookupPrintServices(
DocFlavor.INPUT_STREAM.JPEG, null);
PrintRequestAttributeSet attributes = new HashPrintRequestAttributeSet();
if (services.length > 0) {
PrintService service = ServiceUI.printDialog(null, 50, 50,
services, services[0],
null,
attributes);
if (service != null) {
... print ...
}
}
int defaultIndex = -1;
if (GraphicsEnvironment.isHeadless()) {
throw new HeadlessException();
} else if ((services == null) || (services.length == 0)) {
throw new IllegalArgumentException("services must be non-null " +
"and non-empty");
} else if (attributes == null) {
throw new IllegalArgumentException("attributes must be non-null");
}
if (defaultService != null) {
for (int i = 0; i < services.length; i++) {
if (services[i].equals(defaultService)) {
defaultIndex = i;
break;
}
}
if (defaultIndex < 0) {
throw new IllegalArgumentException("services must contain " +
"defaultService");
}
} else {
defaultIndex = 0;
}
// For now we set owner to null. In the future, it may be passed
// as an argument.
Window owner = null;
Rectangle gcBounds = (gc == null) ? GraphicsEnvironment.
getLocalGraphicsEnvironment().getDefaultScreenDevice().
getDefaultConfiguration().getBounds() : gc.getBounds();
ServiceDialog dialog;
if (owner instanceof Frame) {
dialog = new ServiceDialog(gc,
x + gcBounds.x,
y + gcBounds.y,
services, defaultIndex,
flavor, attributes,
(Frame)owner);
} else {
dialog = new ServiceDialog(gc,
x + gcBounds.x,
y + gcBounds.y,
services, defaultIndex,
flavor, attributes,
(Dialog)owner);
}
Rectangle dlgBounds = dialog.getBounds();
// get union of all GC bounds
GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
GraphicsDevice[] gs = ge.getScreenDevices();
for (int j=0; j<gs.length; j++) {
gcBounds =
gcBounds.union(gs[j].getDefaultConfiguration().getBounds());
}
// if portion of dialog is not within the gc boundary
if (!gcBounds.contains(dlgBounds)) {
// put in the center relative to parent frame/dialog
dialog.setLocationRelativeTo(owner);
}
dialog.show();
if (dialog.getStatus() == ServiceDialog.APPROVE) {
PrintRequestAttributeSet newas = dialog.getAttributes();
Class dstCategory = Destination.class;
Class amCategory = SunAlternateMedia.class;
Class fdCategory = Fidelity.class;
if (attributes.containsKey(dstCategory) &&
!newas.containsKey(dstCategory))
{
attributes.remove(dstCategory);
}
if (attributes.containsKey(amCategory) &&
!newas.containsKey(amCategory))
{
attributes.remove(amCategory);
}
attributes.addAll(newas);
Fidelity fd = (Fidelity)attributes.get(fdCategory);
if (fd != null) {
if (fd == Fidelity.FIDELITY_TRUE) {
removeUnsupportedAttributes(dialog.getPrintService(),
flavor, attributes);
}
}
}
return dialog.getPrintService();
