ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahh_5.4.0.1/vprtout.htm

104 lines
5.8 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="VPrinterOutput class" />
<meta name="abstract" content="" />
<meta name="description" content="" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="vprtout" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>VPrinterOutput class</title>
</head>
<body id="vprtout"><a name="vprtout"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">VPrinterOutput class</h1>
<div><p></p>
<div class="section"><p>A <a href="javadoc/com/ibm/as400/vaccess/VPrinterOutput.html#NAVBAR_TOP"> VPrinterOutput</a> object is a resource that
represents a list of spooled files on a server for use in <a href="vpanes.htm#vpanes">AS400Panes</a>.</p>
</div>
<div class="section"><p>To use a VPrinterOutput object, set the system property. This
property can be set using a constructor or through the <a href="javadoc/com/ibm/as400/vaccess/VPrinterOutput.html#SETSYSTEM(COM.IBM.AS400.ACCESS.AS400)"> setSystem()</a> method. The VPrinterOutput
object is then "plugged" into the AS400Pane as the root, using the constructor
or setRoot() method of the AS400Pane.</p>
</div>
<div class="section"><p>A VPrinterOutput object has other useful properties for defining
the set of spooled files that is presented in AS400Panes. Use <a href="javadoc/com/ibm/as400/vaccess/VPrinterOutput.html#SETFORMTYPEFILTER(JAVA.LANG.STRING)"> setFormTypeFilter()</a> to specify which types
of forms should appear. Use <a href="javadoc/com/ibm/as400/vaccess/VPrinterOutput.html#SETUSERDATAFILTER(JAVA.LANG.STRING)"> setUserDataFilter()</a> to specify which user
data should appear. Finally, use <a href="javadoc/com/ibm/as400/vaccess/VPrinterOutput.html#SETUSERFILTER(JAVA.LANG.STRING)"> setUserFilter()</a> to specify which users
spooled files should appear.</p>
</div>
<div class="section"><p>When AS400Pane and VPrinterOutput objects are created, they are
initialized to a default state. The list of spooled files is not loaded at
creation time. To load the contents, the caller must explicitly call the load()
method on either object. This will initiate communication to the server to
gather the contents of the list.</p>
</div>
<div class="section"><p>At run-time, a user can perform actions on any spooled file or
spooled file list by right-clicking it to display the context menu. The spooled
file list context menu can include an item called <strong>Properties</strong> that
allows the user to set the filter properties, which can change the contents
of the list. </p>
</div>
<div class="section"><p>The spooled file context menu can include the following items: </p>
</div>
<div class="section"><ul><li><strong>Reply</strong> - replies to the spooled file</li>
<li><strong>Hold</strong> - holds the spooled file</li>
<li><strong>Release</strong> - releases the spooled file</li>
<li><strong>Print next</strong> - prints the next spooled file</li>
<li><strong>Send</strong> - sends the spooled file</li>
<li><strong>Move</strong> - moves the spooled file</li>
<li><strong>Delete</strong> - deletes the spooled file</li>
<li><strong>Properties</strong> - displays many properties of the spooled file and
allows the user to change some of them</li>
</ul>
</div>
<div class="section"><p>Of course, users can only access spooled files to which they are
authorized. In addition, the caller can prevent the user from performing actions
by using the setAllowActions() method on the pane.</p>
</div>
<div class="section"><p>The following example creates a VPrinterOutput and presents it
in an AS400ListPane:</p>
</div>
<div class="section"><div class="p"><pre> // Create the VPrinterOutput object.
// Assume that "system" is an AS400
// object created and initialized
// elsewhere.
VPrinterOutput root = new VPrinterOutput (system);
// Create and load an AS400ListPane
// object.
AS400ListPane listPane = new AS400ListPane (root);
listPane.load ();
// Add the list pane to a frame.
// Assume that "frame" is a JFrame
// created elsewhere.
frame.getContentPane ().add (listPane);</pre>
<strong>Example</strong></div>
</div>
<div class="section"><p>Present a list of spooled files by using the print resource, <a href="vprinteroutputexample.htm#vprinteroutputexample">VPrinterOutput</a> object.
Figure 1 shows the VPrinterOutput graphical user interface component:</p>
</div>
<div class="section"><p><strong>Figure 1: VPrinterOutput GUI component</strong></p>
</div>
<div class="section"><p><img src="rzahh116.gif" alt="VPrinterOutput GUI component" /></p>
</div>
</div>
</body>
</html>