| /* |
| * Copyright (c) 2000, 2017, 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.Dialog; |
| import java.awt.Frame; |
| import java.awt.GraphicsConfiguration; |
| import java.awt.GraphicsEnvironment; |
| import java.awt.HeadlessException; |
| import java.awt.Rectangle; |
| import java.awt.Window; |
| |
| 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.DialogOwner; |
| 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 {@code 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 {@code 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 {@code PrintService}'s {@code ServiceUIFactory} when the |
| * {@code PrintService} is browsed. The dialog will attempt to locate a |
| * {@code MAIN_UIROLE} first as a {@code JComponent}, then as a |
| * {@code Panel}. If there is no {@code 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 {@code null} if the user cancels the dialog. |
| * <p> |
| * An application must pass in an array of print services to browse. The |
| * array must be {@code non-null} and non-empty. Typically an application |
| * will pass in only {@code PrintServices} capable of printing a particular |
| * document flavor. |
| * <p> |
| * An application may pass in a {@code PrintService} to be initially |
| * displayed. A {@code non-null} parameter must be included in the array of |
| * browsable services. If this parameter is {@code null} a service is chosen |
| * by the implementation. |
| * <p> |
| * An application may optionally pass in the flavor to be printed. If this |
| * is {@code non-null} choices presented to the user can be better validated |
| * against those supported by the services. An application must pass in a |
| * {@code PrintRequestAttributeSet} for returning user choices. On calling |
| * the {@code 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. |
| * <p> |
| * 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, {@code null} means primary or default |
| * screen |
| * @param x location of dialog including border in screen coordinates |
| * relative to the origin of {@code gc} |
| * @param y location of dialog including border in screen coordinates |
| * relative to the origin of {@code gc} |
| * @param services to be browsable, must be {@code non-null} |
| * @param defaultService initial {@code PrintService} to display |
| * @param flavor the flavor to be printed, or {@code null} |
| * @param attributes on input is the initial application supplied |
| * preferences. This cannot be {@code null} but may be empty. On |
| * output the attributes reflect changes made by the user. |
| * @return print service selected by the user, or {@code null} if the user |
| * cancelled the dialog |
| * @throws HeadlessException if {@code GraphicsEnvironment.isHeadless()} |
| * returns {@code true} |
| * @throws IllegalArgumentException if services is {@code null} or empty, or |
| * attributes is {@code null}, or the initial {@code 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; |
| } |
| |
| DialogOwner dlgOwner = (DialogOwner)attributes.get(DialogOwner.class); |
| Window owner = (dlgOwner != null) ? dlgOwner.getOwner() : 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 {@code AttributeSet} that are |
| * unsupported by the given {@code 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); |
| } |
| } |
| } |
| } |
| } |