| /* |
| * Copyright (c) 2000, 2014, Oracle and/or its affiliates. All rights reserved. |
| * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| * |
| * This code is free software; you can redistribute it and/or modify it |
| * under the terms of the GNU General Public License version 2 only, as |
| * published by the Free Software Foundation. Oracle designates this |
| * particular file as subject to the "Classpath" exception as provided |
| * by Oracle in the LICENSE file that accompanied this code. |
| * |
| * This code is distributed in the hope that it will be useful, but WITHOUT |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| * version 2 for more details (a copy is included in the LICENSE file that |
| * accompanied this code). |
| * |
| * You should have received a copy of the GNU General Public License version |
| * 2 along with this work; if not, write to the Free Software Foundation, |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| * |
| * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
| * or visit www.oracle.com if you need additional information or have any |
| * questions. |
| */ |
| |
| package javax.print; |
| |
| import java.awt.GraphicsConfiguration; |
| import java.awt.GraphicsDevice; |
| import java.awt.GraphicsEnvironment; |
| import java.awt.HeadlessException; |
| import java.awt.Dialog; |
| import java.awt.Frame; |
| import java.awt.Point; |
| import java.awt.Rectangle; |
| import java.awt.Window; |
| import java.awt.KeyboardFocusManager; |
| import javax.print.attribute.Attribute; |
| import javax.print.attribute.AttributeSet; |
| import javax.print.attribute.PrintRequestAttributeSet; |
| import javax.print.attribute.standard.Destination; |
| import javax.print.attribute.standard.Fidelity; |
| |
| import sun.print.ServiceDialog; |
| import sun.print.SunAlternateMedia; |
| |
| /** This class is a collection of UI convenience methods which provide a |
| * graphical user dialog for browsing print services looked up through the Java |
| * Print Service API. |
| * <p> |
| * The dialogs follow a standard pattern of acting as a continue/cancel option |
| *for a user as well as allowing the user to select the print service to use |
| *and specify choices such as paper size and number of copies. |
| * <p> |
| * The dialogs are designed to work with pluggable print services though the |
| * public APIs of those print services. |
| * <p> |
| * If a print service provides any vendor extensions these may be made |
| * accessible to the user through a vendor supplied tab panel Component. |
| * Such a vendor extension is encouraged to use Swing! and to support its |
| * accessibility APIs. |
| * The vendor extensions should return the settings as part of the |
| * AttributeSet. |
| * Applications which want to preserve the user settings should use those |
| * settings to specify the print job. |
| * Note that this class is not referenced by any other part of the Java |
| * Print Service and may not be included in profiles which cannot depend |
| * on the presence of the AWT packages. |
| */ |
| |
| public class ServiceUI { |
| |
| |
| /** |
| * 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. |
| * <p> |
| * 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. |
| * <p> |
| * 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. |
| * <p> |
| * 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. |
| * <p> |
| * 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. |
| * <p> |
| * 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. |
| * <p> |
| * 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. |
| * <p> |
| * 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 : |
| * <pre>{@code |
| * 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 ... |
| * } |
| * } |
| * }</pre> |
| * |
| * @param gc used to select screen. null means primary or default screen. |
| * @param x location of dialog including border in screen coordinates |
| * @param y location of dialog including border in screen coordinates |
| * @param services to be browsable, must be non-null. |
| * @param defaultService initial PrintService to display. |
| * @param flavor the flavor to be printed, or null. |
| * @param attributes on input is the initial application supplied |
| * preferences. This cannot be null but may be empty. |
| * On output the attributes reflect changes made by the user. |
| * @return print service selected by the user, or null if the user |
| * cancelled the dialog. |
| * @throws HeadlessException if GraphicsEnvironment.isHeadless() |
| * returns true. |
| * @throws IllegalArgumentException if services is null or empty, |
| * or attributes is null, or the initial PrintService is not in the |
| * list of browsable services. |
| */ |
| @SuppressWarnings("deprecation") |
| public static PrintService printDialog(GraphicsConfiguration gc, |
| int x, int y, |
| PrintService[] services, |
| PrintService defaultService, |
| DocFlavor flavor, |
| PrintRequestAttributeSet attributes) |
| throws HeadlessException |
| { |
| 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(); |
| |
| x += gcBounds.x; |
| y += gcBounds.y; |
| ServiceDialog dialog; |
| if (owner instanceof Frame) { |
| dialog = new ServiceDialog(gc, |
| x, |
| y, |
| services, defaultIndex, |
| flavor, attributes, |
| (Frame)owner); |
| } else { |
| dialog = new ServiceDialog(gc, |
| x, |
| y, |
| services, defaultIndex, |
| flavor, attributes, |
| (Dialog)owner); |
| } |
| Rectangle dlgBounds = dialog.getBounds(); |
| |
| // if portion of dialog is not within the gc boundary |
| if (!gcBounds.contains(dlgBounds)) { |
| // check if dialog exceed window bounds at left or bottom |
| // Then position the dialog by moving it by the amount it exceeds |
| // the window bounds |
| // If it results in dialog moving beyond the window bounds at top/left |
| // then position it at window top/left |
| if (dlgBounds.x + dlgBounds.width > gcBounds.x + gcBounds.width) { |
| if ((gcBounds.x + gcBounds.width - dlgBounds.width) > gcBounds.x) { |
| x = (gcBounds.x + gcBounds.width) - dlgBounds.width; |
| } else { |
| x = gcBounds.x; |
| } |
| } |
| if (dlgBounds.y + dlgBounds.height > gcBounds.y + gcBounds.height) { |
| if ((gcBounds.y + gcBounds.height - dlgBounds.height) > gcBounds.y) { |
| y = (gcBounds.y + gcBounds.height) - dlgBounds.height; |
| } else { |
| y = gcBounds.y; |
| } |
| } |
| dialog.setBounds(x, y, dlgBounds.width, dlgBounds.height); |
| } |
| 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(); |
| } |
| |
| /** |
| * POSSIBLE FUTURE API: This method may be used down the road if we |
| * decide to allow developers to explicitly display a "page setup" dialog. |
| * Currently we use that functionality internally for the AWT print model. |
| */ |
| /* |
| public static void pageDialog(GraphicsConfiguration gc, |
| int x, int y, |
| PrintService service, |
| DocFlavor flavor, |
| PrintRequestAttributeSet attributes) |
| throws HeadlessException |
| { |
| if (GraphicsEnvironment.isHeadless()) { |
| throw new HeadlessException(); |
| } else if (service == null) { |
| throw new IllegalArgumentException("service must be non-null"); |
| } else if (attributes == null) { |
| throw new IllegalArgumentException("attributes must be non-null"); |
| } |
| |
| ServiceDialog dialog = new ServiceDialog(gc, x, y, service, |
| flavor, attributes); |
| dialog.show(); |
| |
| if (dialog.getStatus() == ServiceDialog.APPROVE) { |
| PrintRequestAttributeSet newas = dialog.getAttributes(); |
| Class amCategory = SunAlternateMedia.class; |
| |
| if (attributes.containsKey(amCategory) && |
| !newas.containsKey(amCategory)) |
| { |
| attributes.remove(amCategory); |
| } |
| |
| attributes.addAll(newas.values()); |
| } |
| |
| dialog.getOwner().dispose(); |
| } |
| */ |
| |
| /** |
| * Removes any attributes from the given AttributeSet that are |
| * unsupported by the given PrintService/DocFlavor combination. |
| */ |
| private static void removeUnsupportedAttributes(PrintService ps, |
| DocFlavor flavor, |
| AttributeSet aset) |
| { |
| AttributeSet asUnsupported = ps.getUnsupportedAttributes(flavor, |
| aset); |
| |
| if (asUnsupported != null) { |
| Attribute[] usAttrs = asUnsupported.toArray(); |
| |
| for (int i=0; i<usAttrs.length; i++) { |
| Class<? extends Attribute> category = usAttrs[i].getCategory(); |
| |
| if (ps.isAttributeCategorySupported(category)) { |
| Attribute attr = |
| (Attribute)ps.getDefaultAttributeValue(category); |
| |
| if (attr != null) { |
| aset.add(attr); |
| } else { |
| aset.remove(category); |
| } |
| } else { |
| aset.remove(category); |
| } |
| } |
| } |
| } |
| } |
