From 554fd8c5195424bdbcabf5de30fdc183aba391bd Mon Sep 17 00:00:00 2001 From: upstream source tree Date: Sun, 15 Mar 2015 20:14:05 -0400 Subject: obtained gcc-4.6.4.tar.bz2 from upstream website; verified gcc-4.6.4.tar.bz2.sig; imported gcc-4.6.4 source tree from verified upstream tarball. downloading a git-generated archive based on the 'upstream' tag should provide you with a source tree that is binary identical to the one extracted from the above tarball. if you have obtained the source via the command 'git clone', however, do note that line-endings of files in your working directory might differ from line-endings of the respective files in the upstream repository. --- libjava/classpath/javax/print/package.html | 240 +++++++++++++++++++++++++++++ 1 file changed, 240 insertions(+) create mode 100644 libjava/classpath/javax/print/package.html (limited to 'libjava/classpath/javax/print/package.html') diff --git a/libjava/classpath/javax/print/package.html b/libjava/classpath/javax/print/package.html new file mode 100644 index 000000000..7527432f2 --- /dev/null +++ b/libjava/classpath/javax/print/package.html @@ -0,0 +1,240 @@ + + + + +GNU Classpath - javax.print + +Provides the basic interfaces and classes of the Java Print Service API. +

+The Java Print Service API enables programmers to: +

+

+

+

Print Service Discovery

+ +Print service types in the JPS API: + +

+

+

PrintService, MultiDocPrintService

+Discovery is done by the use of the static methods in the +PrintServiceLookup class. The discovery +process can be constrained by supplying the document formats and printing +attributes that need to be supported by the returned print service. Furthermore +the +lookupDefaultPrintService() method enables to lookup the default print +service of the platforms printing system. +

+

+

StreamPrintService

+StreamPrintService provides the same functionality as a print service for output +to a supplied OutputStream. Available stream print services are +discovered via the static methods in the +StreamPrintServiceFactory factory. The query can be constrained by supplying +the the requested document format support and the needed output format. +

+ +

Document formats

+ +The format of the printing documents are specified by the +DocFlavor class in the JPS API. It provides the +description of the format in which the print data will be supplied in a print +job to the print service and consists of two parts: + +The Java Print Service API differentiates between two types of print data, +client-formatted and service-formatted. Client-formatted print data is already +provided in a formatted representation by the client e.g. in an image format +or as postscript. For service-formatted print data, the Java Print Service +implementation produces the formatted print data. Here the doc flavor's +representation class name does specify an interface instead of the actual +print data source. The print service will call the methods of the given +implementation of this interface with a special Graphics object capable of +producing formatted print data from the graphics routines inside the +interface methods. + +

Printing attributes

+ +Print services as well as print jobs report their state and capabilities +by the way of supplying printing attributes. Also the behaviour of print +jobs (like how many copies should be printed) is controlled via printing +attributes. For these requirements the JPS API defines different roles +of attributes and common syntax classes in the package +javax.print.attribute. The actual available printing attributes +are implemented in the javax.print.attribute.standard package. + + +

Example of using the API

+
+import java.io.*;
+
+import javax.print.*; +import javax.print.attribute.*; +import javax.print.attribute.standard.*; +import javax.print.event.*; +
+public class Beispiel +{ +  public static void main(String[] args) +  { +    // Using the predefined doc flavor for postscript mimetype +    DocFlavor flavor = DocFlavor.INPUT_STREAM.POSTSCRIPT; +
+    // Looking for printservice supporting this doc flavor +    PrintService[] services = PrintServiceLookup.lookupPrintServices(flavor, null); +
+    // Just take the first +    PrintService service = services[0]; +    System.out.println("Name :" + service.getName()); +
+    try +      { +        // Create a print job +        DocPrintJob job = service.createPrintJob(); +
+        // We want to print a file so we construct an inputstream +        // on the file to supply the print data as given in the doc flavor +        File file = new File("File.ps"); +        InputStream stream = new FileInputStream(file); +
+        // Build a attribute set with the wanted printing attributes +        HashPrintRequestAttributeSet attr = new HashPrintRequestAttributeSet(); +        attr.add(new Copies(2)); // two copies +        attr.add(new PageRanges(2, 7)); // only the 2-7 pages +
+        // Construct a doc object with the provided class SimpleDoc +        SimpleDoc doc = new SimpleDoc(stream, flavor, null); +
+        // register us as the print - use the adapter class +        // and override the interesing failure condition +        job.addPrintJobListener(new PrintJobAdapter() +        { +          public void printJobFailed(PrintJobEvent arg0) +          { +            System.out.println("The PrintJob failed."); +          } +        }); +
+        // start the printing process +        job.print(doc, attr); +
+        // lets assume we want to cancel it +        if (job instanceof CancelablePrintJob) +          { +            CancelablePrintJob cancelJob = (CancelablePrintJob) job; +            cancelJob.cancel(); +          } +
+      } +    catch (PrintException e) +    { +      e.printStackTrace(); +    } +    catch (FileNotFoundException e) +    { +      e.printStackTrace(); +    } +  } +} +
+

+Since: 1.4 +

+ + -- cgit v1.2.3