Before starting
To brows this documentation you must have a Java Virtual Machine installed on your computer.
We recommend installing Java 6 or higher from Sun Microsystems' web site.
1. Introduction
The GdViewer Pro ActiveX control provides an embeddable Image & PDF viewer which can works as objects container for Windows application developers. Using Visual Basic, Visual FoxPro, MS Access, Delphi, VB.NET, C#, Visual C++, RealBasic (or another ActiveX-aware development tool), developers can build a custom interface including the capability to view Image and PDF files.
2. Installing & Redistributing the Control
• Required files:
You must copy the msvbvm60.dll and the gdviewerpro4.ocx into c:\%Windows%\System32\ .
You can download the last gdviewerpro4.ocx edition here.
Note: gdviewerpro4.ocx need to be registered on your system by running the folowing command: regsvr32 c:\%Windows%\System32\gdviewerpro4.ocx
• Optional files:
- If your application runs under windows 98, NT4, ME or 2000 you must copy the gdiplus.dll into c:\%Windows%\System32\ or into your application directory.
- PDF viewing functions are included in gdpdfplug.dll. This library is needed if your application includes PDF View support.
You must copy this file into c:\%Windows%\System32\ or into your application directory. You don't need to register this library on your system.
You can download the last gdpdfplug.dll edition here.
- The gdimgplug.dll library can be redistributed in order to increase the speed of image decoding and to extend the supported image formats to jpeg 2000, TGA, EXR, PSP...
You must copy this file into c:\%Windows%\System32\ or into your application directory. You don't need to register this library on your system.
You can download the last gdimgplug.dll edition here.
Parts of the gdimgplug.dll are based on the FreeImage open source image library. See http://freeimage.sourceforge.net for details. FreeImage is used under the FreeImage Public License - Version 1.0.
3. Using the Control
This manual assumes that you are familiar with using controls in your development tool.
The GdViewer Pro Control can be instantiated just like any other control. Before using the GdViewer Pro ActiveX you need to add a reference to it within your development tool.
All sample will be given in Visual Basic and usage from other ActiveX-aware development tools is not specifically covered in this manual, but should be similar to the Visual Basic usage.
To add a reference to the GdViewer Pro control in Visual Basic 5 or 6:
• Select the “Components...” command on the “Projects” menu, then check the box next to “GdViewer Pro 4 - Image Viewer ActiveX".
Note: If you can't see the GdViewer Pro 4 - Image Viewer ActiveX box you can add it by clicking into the "Brows.." button.
To add a reference to the GdViewer Pro control in Visual Studio .NET:
• Right-click into the Toolbox Items and select "Add/Remove Items" for visual studio 2003 or "Choose Items" for visual studio 2005 and visual studio 2008.
• Choose the COM tab and check the classe(s) you want to use: (GdViewerpro4.GdViewer or GdViewerPro4.GdViewerCnt).
Note: If you can't see the desired box you can add it by clicking into the "Brows.." button.
4. Class informations
• Component: GdViewer Pro 4 - Image Viewer ActiveX
Marked as Safe for Scripting and Initialization: NO
File: gdviewerpro4.ocx
Class count: 2
Class 1: GdViewer (Visual Class)
-> Access string: GdViewerPro4.GdViewer
-> CLSID: {9FB7C7CA-9F1C-450C-ACEF-A59D2D781510}
Class 2: GdViewerCnt
(Visual Class)
-> Access string: GdViewerPro4.GdViewerCnt
-> CLSID: {630A531C-250C-4104-9375-7A1EC6579C94}
• Component: GdViewer Pro 4 - Image Viewer ActiveX (Safe)
Marked as Safe for Scripting and Initialization: YES
File: gdviewerpro4S.ocx
Class count: 2
Class 1: GdViewer (Visual Class)
-> Access string: GdViewerPro4S.GdViewer
-> CLSID: {60ABA913-9C5B-4542-A97F-AFE1F26FD9AE}
Class 2: GdViewerCnt
(Visual Class)
-> Access string: GdViewerPro4S.GdViewerCnt
-> CLSID: {359A001A-273A-4754-BF62-ED55676D2132}