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 private PrintJobAttributeSet attributes; 48 49 /** 50 * Constructs a {@code PrintJobAttributeEvent} object. 51 * 52 * @param source the print job generating this event 53 * @param attributes the attribute changes being reported 54 * @throws IllegalArgumentException if {@code source} is {@code null} 55 */ 56 public PrintJobAttributeEvent (DocPrintJob source, 57 PrintJobAttributeSet attributes) { 58 super(source); 59 60 this.attributes = AttributeSetUtilities.unmodifiableView(attributes); 61 } 62 63 /** 64 * Determine the {@code PrintJob} to which this print job event pertains. 65 * 66 * @return {@code PrintJob} object 67 */ 68 public DocPrintJob getPrintJob() { 69 70 return (DocPrintJob) getSource(); 71 } 72 73 /** 74 * Determine the printing attributes that changed and their new values. 75 * 76 * @return attributes containing the new values for the print job attributes 77 * that changed. The returned set may not be modifiable. 78 */ 79 public PrintJobAttributeSet getAttributes() { 80 81 return attributes; 82 } 83 }