1 /* 2 * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package javax.print.event; 27 28 import javax.print.DocPrintJob; 29 import javax.print.attribute.AttributeSetUtilities; 30 import javax.print.attribute.PrintJobAttributeSet; 31 32 /** 33 * Class {@code PrintJobAttributeEvent} encapsulates an event a 34 * {@code PrintService} reports to let the client know that one or more printing 35 * attributes for a {@code PrintJob} have changed. 36 */ 37 public class PrintJobAttributeEvent extends PrintEvent { 38 39 /** 40 * Use serialVersionUID from JDK 1.4 for interoperability. 41 */ 42 private static final long serialVersionUID = -6534469883874742101L; 43 44 /** 45 * The printing service attributes that changed. 46 */ 47 @SuppressWarnings("serial") // Not statically typed as Serializable 48 private PrintJobAttributeSet attributes; 49 50 /** 51 * Constructs a {@code PrintJobAttributeEvent} object. 52 * 53 * @param source the print job generating this event 54 * @param attributes the attribute changes being reported 55 * @throws IllegalArgumentException if {@code source} is {@code null} 56 */ 57 public PrintJobAttributeEvent (DocPrintJob source, 58 PrintJobAttributeSet attributes) { 59 super(source); 60 61 this.attributes = AttributeSetUtilities.unmodifiableView(attributes); 62 } 63 64 /** 65 * Determine the {@code PrintJob} to which this print job event pertains. 66 * 67 * @return {@code PrintJob} object 68 */ 69 public DocPrintJob getPrintJob() { 70 71 return (DocPrintJob) getSource(); 72 } 73 74 /** 75 * Determine the printing attributes that changed and their new values. 76 * 77 * @return attributes containing the new values for the print job attributes 78 * that changed. The returned set may not be modifiable. 79 */ 80 public PrintJobAttributeSet getAttributes() { 81 82 return attributes; 83 } 84 }