Summary of features

Top  Previous  Next

While a screen shot program captures what you see and send it to a bitmap graphic, PrintWindow works under a completely different approach. It takes the information from the controls of your window, and with that information creates them dynamically on a report. This way you have a lot of control over what is actually printed. Check out the Global extension to review all the customization options.

 

Report Scaling

You have several automatic and manual options to scale your report (See Scale). If by result of your choice the window don't fit in the report, it will print as many pages as necessary to show the whole window (either vertically or horizontally).

 

Window Title

The current window title can be automatically printed. You can override it with a local option.

 

Hidden Controls

Hidden controls are not printed. If some not-hidden controls are dependant on other controls that are hidden, they are skipped from printed as well (just like they are hidden on the window).

Hidden nesting is supported up to any level.

 

Disabled Controls

Disabled controls are printed on a silver color (that's by default, you can change the color). If some not-disabled controls are dependant on other controls that are disabled, they are printed silvered as well (just like they are disabled on the window).

Disabling nesting is supported up to any level.

A disabled Tab will be treated as hidden (i.e. it is not printed).

 

Sheet and Tabs

Actually you cannot print a real Tab or a Sheet on a report, so the Tabs are emulated. The look is customizable. For each Tab you may print the Tab with the sheet box, the Tab with just a border line, or just the Tab.

A simple window will print in a single report page, just like a screen shot.
If you have a window with a Sheet with a single Tab, it will equally print in a single report page.
If you have a window with a Sheet with more than a Tab, each Tab will print on a different page (by default). For the controls populated on the window itself, you will have the option to print them on every report page, or only on the first page, or only in the last page. This means that a simple Sheet with five Tabs will generate a report of five pages.
If you have multiple Sheets in a single window, all the Sheets will print on the same page.
If you have Sheets inside other Sheets, the first child Tab will print in the same page as the parent Sheet, while the additional Tabs will print on separate empty pages.
Tab controls support foreground and background color; however, if you set the selected color at runtime, only the selected Tab will have the run-time selected color at the moment of pressing the PrintWindow button, therefore the other Tabs will print with the background not-selected color.
Hidden or disabled Tabs won't print at all.
The sheets can have an optional shadow (active by default).

 

List box (Browse)

Emulated.

When a list is wider than the control width, you have the option to print just the visible columns or to print all the columns to the right.
When a list has more records than the control height, rows after the bottom are not shown taking note of: there is a limitation on the Clarion chain (Legacy templates) that prevent the list to be completely loaded (it is always page loaded), so it won't be an option to extend the browse height for Legacy templates. As for ABC chain, you have to select "file" loaded if you want to print more records than the height of the browse.
Only the current sort order is show. When you have a Browse with several Tabs, on the window each tab has its own order, but the printout will be ordered by the Tab selected when the PrintWindow button was pressed, and this order will be the same on all the pages.  TIP: If you want to print a regular browse where you have several Tabs, you can exclude them all with the exclude controls list, so the browse takes just one page.
It doesn't matter if you scroll horizontally on your listbox previously to print. The printout will be always from the first column to the right.
You can choose to print or not the selection bar, and its color.

 

Droplists, combos, listcombos

Emulated. They are a special subsets of listboxes that show the selected content in a entry-like box, and an empty box if nothing is currently selected.

 

Panels

Emulated. Bevel not supported.

They mimic the window behaviour of being "transparent" to other controls while you can set a background color for them. This is often used to set a framed background color for a group of controls.

 

Groups

Emulated when without text, otherwise native. Will print close to how they look on the window, although there are some differences in the handling of some color details. For example, if you set a background color for the header, the background area will be as wide as the group on the report instead of just behind the text.

 

Entries

Emulated. You can choose to draw the surrounding box or not. They can have an optional shadow (inactive by default).

 

Spins

Emulated. The button controls are not printed. The contents print the same way as a regular entry field.

 

Buttons

Emulated. By default they are not printed, but you can if you want. You can choose not to draw the surrounding box if they are flat. They can have an optional shadow (active by default). Their .ico graphics are not supported by the report engine, check .ICO files.

 

Images (as background)

They will set the size of the report, and all the controls are resized according to the image size to emulate a "form" type print.

When you use images as background, the template can handle only one image per Tab. If there are more images on any of the Tabs, they should be excluded from the list of processed controls.

A special global prompt is supplied to automatically replace the background window graphics with different (high definition) ones in the report.

 

Images (graphics)

Native. They will print as they look on the window, except for:

Transparencies; GIF transparencies are not supported by the report engine. You should replace the transparent color on any graphic by the same color as the background over it is printed (normally white).
.ICO files; they are not supported by the report engine. Check .ICO files.

 

Text fields

Native. You have the option to print exactly as they look on the window, or to allow the expanding of the content vertically when needed. Controls located below may be automatically moved to make room for the expanded text field.

 

Checkboxes

Emulated. Note that when you specify custom True/False values, you have to be sure that the values in the control are in sync with the dictionary settings.

 

Option and Radio buttons

Emulated.

 

Strings, lines, boxes, ellipses, prompts

Native. Will print exactly as they look on the window.

 

RTF on Clarion 5.5

Emulated. Raw data only. See RTF Support.

 

RTF on Clarion 6.x

Native. Full formatted data.