java.awt.print Documentation Differences

This file contains all the changes in documentation in the package java.awt.print as colored differences. Deletions are shown like this, and additions are shown like this.

If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.

Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.

Returns a copy of the Paper object associated with this PageFormat. Changes made to the Paper object returned from this method do not affect the Paper object of this PageFormat. To update the Paper object of this PageFormat create a new Paper object and set it into this PageFormat by using the #setPaper(Paper) method. @return a copy of the Paper object associated with this PageFormat.

Sets the Paper object for this PageFormat. @param paper the Paper object to which to set the Paper object for this PageFormat. @exception NullPointerException a null paper instance was passed as a parameter.

The Paper class describes the physical characteristics of a piece of paper.

When creating a Paper object it is the application's responsibility to ensure that the paper size and the imageable area are compatible. For example if the paper size is changed from 11 x 17 to 8.5 x 11 the application might need to reduce the imageable area so that whatever is printed fits on the page.

@see #setSize(double double) @see #setImageableArea(double double double double)

Sets the imageable area of this Paper. The imageable area is the area on the page in which printing occurs. @param x  y the coordinates to which to set the upper-left corner of the imageable area of this Paper @param width the value to which to set the width of the imageable area of this Paper @param height the value to which to set the height of the imageable area of this Paper

Sets the width and height of this Paper object which represents the properties of the page onto which printing occurs. The dimensions are supplied in 1/72nds of andan inch. @param width the value to which to set this Paper object's width @param height the value to which to set this Paper object's height

The Printable interface is implemented by the print methods of the current page painter which is called by the printing systemtosystem to render a page. When building a Pageable pairs of PageFormat instances and instances that implement this interface are used to describe each page. The instance implementing Printable is called to print the page's graphics. @see java.awt.print.Pageable @see java.awt.print.PageFormat @see java.awt.print.PrinterJob

Displays a dialog that allows modification of a PageFormat instance. The page argument is used to initialize controls in the page setup dialog. If the user cancels the dialog then this method returns the original page object unmodified. If the user okays the dialog then this method returns a new PageFormat object with the indicated changes. In either case the original page object is not modified. @param page the default PageFormat presented to the user for modification @return the original page object if the dialog is cancelled; a new PageFormat object containing the format indicated by the user if the dialog is acknowledged. @since JDK11.2

AltersReturns the clone of PageFormatpage argumentwith its settings adjusted to be usablecompatible with the current onprinter of this PrinterJob. For example the returned PageFormat could have its imageable area adjusted to fit within the object'sphysical area of the paper that is used by the current printer. @param page thisthe pagePageFormat descriptionthat is cloned and then itswhose settings are alteredchanged to be usuablecompatible for thiswith the PrinterJobcurrent printer @return a PageFormat that is cloned from the PageFormatpage parameter and alteredwhose settings are changed to conform with this PrinterJob.