The Print Options dialog is a BI Beans thin bean, for use in an HTML-client application. It allows users to specify options for printing a thin presentation bean.
The ThinBeanUI
implementation of the Print Options dialog is the
oracle.dss.thin.beans.dataView.PrintOptions
class. The UINode
for the Print Options dialog is oracle.dss.thin.beans.dataView.PrintOptionsBean
.
Your servlet must associate
the PrintOptions
object with the PrintOptionsBean
object.
The JSP tag for this dialog is the PrintOptions tag. In the UIX Language, the definition element is the printOptionsDef element, and the UINode is the printOptions element.
The Print Options dialog collects information from the user, and the event
that it generates is handled by the PrinterFriendlyView
object.
The PrintOptions
object does not need to be stored in the HTTP
session, but you can store
it in the HTTP session if you want to reuse the dialog page. How you display
the dialog depends on whether you store the PrintOptions
in the
session or instantiate it only when it is needed.
In a servlet, to specify the thin presentation to print, call the setView
method of the PrintOptions
class.
The Print Options dialog generates the following thin-bean events, which are defined in the oracle.dss.thin.beans.BIConstants
interface:
INIT_PRINTER_FRIENDLY_VIEW_EVENT
-- This is the event that
the OK navigation initiates. The JavaScript
for this event is generated by the PrintOptions.generateOnClickSubmit
method. Set
an event target on the PrintOptions
for this event, to
route the event to a PrinterFriendlyView
. The PrinterFriendlyView
handles this event.
This event has parameters, which are passed to the PrinterFriendlyView
. Your code does not need to manage these parameters. You might add extra parameters to pass any other necessary information to the PrinterFriendlyView
. For example, if a PrintOptions
can print different views, you need to identify which view to print. You can do this by passing the view name as an extra parameter.
CANCEL_EVENT
-- This event indicates that the user has canceled the print job. Set an event target to route this event to your application. See Setting Up OK and Cancel Navigation for a Thin Dialog for more information.
The Print Options bean handles the BIConstants.INIT_EVENT
. The PrintOptions
object passes this event to any ThinBeanDialogListener
implementations that have been registered with it.
Initialize the Print Options dialog as you would initialize any thin bean dialog. In your initialization code, set the view to print, by calling PrintOptions.setView
.