pdftron::PDF::PDFDCEX Class Reference

PDFDCEX is a utility class used to represent a PDF Device Context (DC). More...

#include <PDFDCEX.h>

List of all members.

Public Member Functions

 PDFDCEX ()
 Default constructor.
 ~PDFDCEX ()
 Destructor.
HDC Begin (PDFDoc &in_pdfdoc)
 Begin the process of translating GDI drawing into a PDF, starting with the creation of a GDI Device Context.
void End ()
 Closes the GDI Device Context, translating the GDI instruction to PDF, and adds the PDF objects to the page in the location specified by PDFDCEX::Begin( page, box, .
UInt32 GetDPI ()


Detailed Description

PDFDCEX is a utility class used to represent a PDF Device Context (DC).

Windows developers can use standard GDI or GDI+ API-s to write on PDFDCEX and to generate PDF documents based on their existing drawing functions. PDFDCEX can also be used to implement file conversion from any printable file format to PDF.

PDFDCEX class can be used in many ways to translate from GDI to PDF:

Very few code changes are required to perform the translation from GDI to PDF as PDFDCEX provides a GDI Device Context handle which can be passed to all GDI function requiring an HDC. PDFDCEX does use a "Virtual Printer" approach so the translation should be of both high quality and speed.

For more advanced translations or creations of PDF documents, such as security handling, the use of other PDFNet classes will be required.

An example use of PDFDCEX can be found in PDFDCTest.cpp:

 // Start with a PDFDoc to put the picture into, and a PDFDCEX to translate GDI to PDF
 PDFDoc pdfdoc;
 PDFDCEX pdfdcex;

 // Begin the translation from GDI to PDF, provide the PDFDoc to append the translated
 // GDI drawing to and get back a GDI Device Context
 HDC hDC = pdfdcex.Begin(pdfdoc);
 ::StartPage(hDC);

 ... perform GDI drawing ...

 ::EndPage(hDC);
 // Complete the translation
 pdfdcex.EndDoc();

 // Save the PDF document
 pdfdoc.Save("PDFDCEX_is_cool.pdf", SDF::SDFDoc::e_remove_unused, NULL);

Constructor & Destructor Documentation

pdftron::PDF::PDFDCEX::PDFDCEX (  ) 

Default constructor.

Creates an empty new GDI to PDF translator.

pdftron::PDF::PDFDCEX::~PDFDCEX (  ) 

Destructor.


Member Function Documentation

HDC pdftron::PDF::PDFDCEX::Begin ( PDFDoc in_pdfdoc  ) 

Begin the process of translating GDI drawing into a PDF, starting with the creation of a GDI Device Context.

Parameters:
in_pdfdoc the document which the converted GDI pages will be appended to.
Returns:
a GDI Handle to Display Context.

void pdftron::PDF::PDFDCEX::End (  ) 

Closes the GDI Device Context, translating the GDI instruction to PDF, and adds the PDF objects to the page in the location specified by PDFDCEX::Begin( page, box, .

..).

Exceptions:
An exception is thrown if there are any fatal errors in the the translation process.

UInt32 pdftron::PDF::PDFDCEX::GetDPI (  ) 


© 2002-2010 PDFTron Systems Inc.