< prev index next >
src/java.desktop/share/classes/javax/print/attribute/PrintRequestAttributeSet.java
Print this page
*** 1,7 ****
/*
! * 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
--- 1,7 ----
/*
! * 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
*** 21,110 ****
* 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.attribute;
/**
! * Interface PrintRequestAttributeSet specifies the interface for a set of
! * print request attributes, i.e. printing attributes that implement interface
! * {@link PrintRequestAttribute PrintRequestAttribute}.
! * The client uses a PrintRequestAttributeSet to specify the settings to be
! * applied to a whole print job and to all the docs in the print job.
! * <P>
! * PrintRequestAttributeSet is just an {@link AttributeSet AttributeSet} whose
! * constructors and mutating operations guarantee an additional invariant,
! * namely that all attribute values in the PrintRequestAttributeSet must be
! * instances of interface {@link PrintRequestAttribute PrintRequestAttribute}.
! * The {@link #add(Attribute) add(Attribute)}, and
! * {@link #addAll(AttributeSet) addAll(AttributeSet)} operations
! * are respecified below to guarantee this additional invariant.
*
* @author Alan Kaminsky
*/
public interface PrintRequestAttributeSet extends AttributeSet {
/**
* Adds the specified attribute value to this attribute set if it is not
! * already present, first removing any existing value in the same
! * attribute category as the specified attribute value (optional
! * operation).
! *
! * @param attribute Attribute value to be added to this attribute set.
! *
! * @return {@code true} if this attribute set changed as a result of
! * the call, i.e., the given attribute value was not already a
! * member of this attribute set.
! *
! * @throws UnmodifiableSetException
! * (unchecked exception) Thrown if this attribute set does not
! * support the {@code add()} operation.
! * @throws ClassCastException
! * (unchecked exception) Thrown if the {@code attribute} is
! * not an instance of interface
! * {@link PrintRequestAttribute PrintRequestAttribute}.
! * @throws NullPointerException
! * (unchecked exception) Thrown if the {@code attribute} is null.
*/
public boolean add(Attribute attribute);
/**
! * Adds all of the elements in the specified set to this attribute.
! * The outcome is the same as if the
! * {@link #add(Attribute) add(Attribute)}
! * operation had been applied to this attribute set successively with
! * each element from the specified set. If none of the categories in the
! * specified set are the same as any categories in this attribute set,
! * the {@code addAll()} operation effectively modifies this attribute
! * set so that its value is the <i>union</i> of the two sets.
! * <P>
! * The behavior of the {@code addAll()} operation is unspecified if
! * the specified set is modified while the operation is in progress.
! * <P>
! * If the {@code addAll()} operation throws an exception, the effect
! * on this attribute set's state is implementation dependent; elements
! * from the specified set before the point of the exception may or
! * may not have been added to this attribute set.
! *
! * @param attributes whose elements are to be added to this attribute
! * set.
! *
! * @return {@code true} if this attribute set changed as a result of
! * the call.
! *
! * @throws UnmodifiableSetException
! * (Unchecked exception) Thrown if this attribute set does not
! * support the {@code addAll()} method.
! * @throws ClassCastException
! * (Unchecked exception) Thrown if some element in the specified
! * set is not an instance of interface {@link PrintRequestAttribute
! * PrintRequestAttribute}.
! * @throws NullPointerException
! * (Unchecked exception) Thrown if the specified set is null.
! *
* @see #add(Attribute)
*/
public boolean addAll(AttributeSet attributes);
-
}
--- 21,94 ----
* 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.attribute;
/**
! * Interface {@code PrintRequestAttributeSet} specifies the interface for a set
! * of print request attributes, i.e. printing attributes that implement
! * interface {@link PrintRequestAttribute PrintRequestAttribute}. The client
! * uses a {@code PrintRequestAttributeSet} to specify the settings to be applied
! * to a whole print job and to all the docs in the print job.
! * <p>
! * {@code PrintRequestAttributeSet} is just an {@link AttributeSet AttributeSet}
! * whose constructors and mutating operations guarantee an additional invariant,
! * namely that all attribute values in the {@code PrintRequestAttributeSet} must
! * be instances of interface
! * {@link PrintRequestAttribute PrintRequestAttribute}. The
! * {@link #add(Attribute) add(Attribute)}, and
! * {@link #addAll(AttributeSet) addAll(AttributeSet)} operations are respecified
! * below to guarantee this additional invariant.
*
* @author Alan Kaminsky
*/
public interface PrintRequestAttributeSet extends AttributeSet {
/**
* Adds the specified attribute value to this attribute set if it is not
! * already present, first removing any existing value in the same attribute
! * category as the specified attribute value (optional operation).
! *
! * @param attribute attribute value to be added to this attribute set
! * @return {@code true} if this attribute set changed as a result of the
! * call, i.e., the given attribute value was not already a member of
! * this attribute set
! * @throws UnmodifiableSetException if this attribute set does not support
! * the {@code add()} operation
! * @throws ClassCastException if the {@code attribute} is not an instance of
! * interface {@link PrintRequestAttribute PrintRequestAttribute}
! * @throws NullPointerException if the {@code attribute} is {@code null}
*/
public boolean add(Attribute attribute);
/**
! * Adds all of the elements in the specified set to this attribute. The
! * outcome is the same as if the {@link #add(Attribute) add(Attribute)}
! * operation had been applied to this attribute set successively with each
! * element from the specified set. If none of the categories in the
! * specified set are the same as any categories in this attribute set, the
! * {@code addAll()} operation effectively modifies this attribute set so
! * that its value is the <i>union</i> of the two sets.
! * <p>
! * The behavior of the {@code addAll()} operation is unspecified if the
! * specified set is modified while the operation is in progress.
! * <p>
! * If the {@code addAll()} operation throws an exception, the effect on this
! * attribute set's state is implementation dependent; elements from the
! * specified set before the point of the exception may or may not have been
! * added to this attribute set.
! *
! * @param attributes whose elements are to be added to this attribute set
! * @return {@code true} if this attribute set changed as a result of the
! * call
! * @throws UnmodifiableSetException if this attribute set does not support
! * the {@code addAll()} method
! * @throws ClassCastException if some element in the specified set is not an
! * instance of interface
! * {@link PrintRequestAttribute PrintRequestAttribute}
! * @throws NullPointerException if the specified set is {@code null}
* @see #add(Attribute)
*/
public boolean addAll(AttributeSet attributes);
}
< prev index next >