User Tools

Site Tools


tplpreviewcrystal.htm
Navigation:  »No topics above this level«====== PreviewCrystalReport ====== Return to chapter overview

This template allows for previewing and printing of predefined Crystal Reports.

Requirements

There are no requirements for this template.

Populating the Template

1. From an embed point, press the Insert button and select the PreviewCrystalReport template.

Template Prompts

The PreviewCrystalReport template provides the following prompts:

General

Object Name

Set the object's label for the template-generated code. By fine-tuning the object names, you can make your generated code easier to read. The default object name is oCrystal8.

Report Name or variable (prefixed with !)

Type a valid Crystal report name including extension (.rpt) or a variable that will contain the report name. When using a variable, precede it with an exclamation (!). The report name must include the runtime path of the file. If the file is not found at runtime an error window will display containing the following error- “error opening job”.

Window Title or variable (prefixed with !)

Crystal Reports are run inside a Clarion window. Type a title to appear in the window caption bar or enter a variable name which will contain the window title. When using a variable, precede it with an exclamation (!).

Show Print Controls?

Check this box to turn off all preview window buttons. If checked, the Control Options template tab will not be available.

Control Options

This tab will not show if the Show Print Controls? option on the General tab is not checked.

Allow Prompting?

Check this box to allow the Crystal Report use its defined runtime parameter fields.

Allow Drill Down?

Check this box to allow support of Crystal's drill-down report feature.

Show Cancel Button?

Check this box to enable a Cancel button on the report preview window.

Show Close Button?

Check this box to enable a Close button on the report preview window.

Show Export Button?

Check this box to enable an Export button on the report preview window.

Show Launch Button?

Check this box to enable a Launch button on the report preview window. The Launch button runs the Analysis tool.

Show Navigation Buttons?

Check this box to enable page navigation buttons on the report preview window.

Show Print Button?

Check this box to enable a Print button on the report preview window.

Show Print Setup?

Check this box to enable a PrintSetup button on the report preview window.

Show Progress?

Check this box to enable the report progress controls in the preview window. These controls include Total Records, Records Read, Percent Read.

Show Refresh?

Check this box to enable a Refresh button on the report preview window.

Show Search?

Check this box to enable the two search controls on the report preview window. These two controls include a search button and an entry control.

Show Zoom?

Check this box to enable the zoom control on the report preview window.

Show Toolbar Tips?

Check this box to enable tool tips on the toolbar in the preview window.

Show Document Tips?

Check this box to enable tool tips on the document (report) in the preview window.

Window Options

Initial State

Select the initial size and state of your window from the drop-down list. Choose from:

Normal Display the window at the default size. If you don't specify a default size, Clarion's run-time library sets it for you.

Maximized This window fills the entire desktop, or the entire application frame, depending on whether the window is an application window, or an MDI child window.

Iconized The window appears in an iconized state in the Taskbar.

Frame Type

Pick the frame type for your window from the drop-down list. Choose from:

Single A single pixel frame that the user cannot resize. Most suitable for dialog boxes.

Double A thick frame, which the user cannot resize. Use this type frame for a system modal window (without a caption bar), or for a modal dialog box (with a caption bar).

Resizable A thick frame, which the user may resize. Choose this for application and MDI child windows.

None A single pixel frame. Most suitable for dialog boxes. The user cannot resize this frame.

Icon

To associate an icon with the window (and add a system menu'see System Menu below), specify an icon file name (.ICO file) in this field. Type the file name or press the ellipsis button (…) to select a file name with the standard Open File dialog. Specifying an icon automatically places a minimize button on the caption bar of your application or MDI child window.

System Menu

To place a system menu in your window, check the System Menu box, or specify an icon file (see Icon above), or specify a maximize box (see Maximize below). When your window has the SYSTEM attribute Windows 95/98 and Windows NT display an icon in the upper left corner. If you specify an icon (see Icon above), that icon displays, otherwise the system default icon displays. Initially, the system default icon is set to the Clarion icon; however, you can specify a system default icon with:

System{PROP:Icon} = 'My.ico'

Activate the system menu by CLICKING the button, box, or icon in the upper left corner of the window. Standard system menu choices include Restore, Minimize, Maximize, and Close.

Every application frame should have a system menu. For users on a system without a mouse, the system menu provides the only means of minimizing, maximizing or re-sizing the application window.

Maximize Box

To place a maximize button in your window (and a system menu'see System Menu above), check this box. In general, you should place a maximize button on application windows and MDI child document windows, not on dialog boxes.

3D Look

To provide the gray window background, and chiseled control look for your window, check this box. This is clearly a style consideration, but will go a long way in giving your application a professional look.

tplpreviewcrystal.htm.txt · Last modified: 2021/04/15 15:46 by 127.0.0.1