|
RpvCorporate.ocx.
Rpv Reports includes RpvCorporate.ocx
activex control. With this control, the developer that works using a Windows based
language, will be able to avoid the print server and the execution of Rpv.exe
using commands such as "shell", "exec", "call system", etc.
If you are familiar with Rpv format, learning
how to use RpvCorporate.ocx will be really easy for you. The following is a list
with its properties and methods.
IMPORTANT: RpvCorporate.ocx is installed automatically on the application directory. The
control must be accesed to that directory because it needs communication with
Rpv.exe and Rpv.lng files.
Properties to set to open the viewer.
| Property |
Description
|
Default value |
| Dirbuttons |
Hides direction buttons
(first, back, go to, next and last page). |
1 |
| Findbuttons |
Hides buttons "Find" and
"Find Next". |
1 |
| ExportButton |
Hides button "Export
Report". |
1 |
| OpenButton |
Hides button "Open" |
1 |
| PrintButtons |
Hides buttons "Print"
and "Print Setup". |
1 |
| SaveButton |
Hides button "Save". |
1 |
| SendByEMailButton |
Hides button "Send by
e-mail". |
1 |
| SizeButtons |
Hides Zoom buttons. |
1 |
Each of can be set to 1 or 0 (integer). Value zero means that the buttons
related with the specified property will not be shown when the viewer opens.
The property EditionEnabled is still accepted by the object but doesn't take
effect anymore since developer edition always starts with edition enabled and
final user edition never starts with edition enabled.
Other properties.
| Property |
Description
|
Default value. |
| RpvFileName |
Indicates the name of
the file (Rpv, Rpx, Rpd, Txt, Lst or Prn) that the control will use. The
extensions are required for all the files, included Rpv files. |
Empty |
| Response |
Returns a value
according with the following table.
| Value |
Meaning |
|
0 |
Succesful |
|
2 |
The report couldn't
be deleted. |
|
4 |
The report couldn't
be printed. The file is not recognized by Rpv. |
|
5 |
RpvFileName was not
specified. |
|
6 |
User selected
"cancel" instead "Print". |
|
7 |
Report was already
packed. A copy of the report was made to create the destination file. |
|
8 |
The report was
packed. Some files could not be found and were not added. |
|
9 |
The report could not
be packed. Operation aborted. |
|
Empty |
Methods of the control.
| Method |
Action |
Syntax |
Example |
| KillReport |
Deletes the report
specified in the property "RpvFileName". |
None |
Rpv1.RpvFileName = "c:\myreport.rpv"
Rpv.KillReport |
| PrintReport |
Prints the report using
the default printer or the printer declared in the report. |
PrintReport
PromptForPrinter as integer, RefreshReport as integer, PrintNoPrint as
integer
PromptForPrinter: where 1 shows the dialog to select the printer and
0 (zero) sends the printer directly to the default printer.
RefreshReport: where 1 forces Rpv to reload the report when it is
hosted on a web server ignoring the data stored in the cache directory.
Recommended value: 1
PrintNoPrint: where 1 indicates that the
entire form will be printed and 0 (zero) indicates that only the printable
areas will be printed. (Those areas between {print} and {noprint})
Recommended value: 0
|
Rpv1.RpvFileName = "c:\myreport.rpv"
Rpv1.PrintReport 1
This example prints the report showing the printer dialog. |
| SaveAsPack |
Packs the report (it
saves it as Rpv packed file). |
SaveAsPack
Destination.rpv |
Rpv1.RpvFileName = "c:\myreport.rpv"
Rpv1.SaveAsPack "c:\myreporte2.rpv" |
| ViewRpvReport |
Opens the viewer loading
the report specified in the property "RpvFileName". |
None |
Rpv1.RpvFileName = "c:\myreporte.rpv"
Rpv1.ViewRpvReport
This example opens the viewer opening the specified file. |
More methods.
See our sample application to see a program using
RpvCorporate.ocx control.
|
