long CaptureEvents(BOOL bCapture)
void StartDocPre()
void StartDocPost(long JobId, long hDC)
void EndDocPre(long JobId, long hDC)
void EndDocPost(long JobId, long hDC)
void StartPage(long JobId, long hDC)
void EndPage(long JobId, long hDC)
void EnabledPre()
void BufferFull(long JobId, long hDC)
void DocCancelled(long JobId, long hDC)
JobID
[out] Unique job ID generated by the spooler in the case of Windows NT/2000/XP, or internally by the printer driver in the case of other Windows.
hDC
[out] Printer Device Context.
The method CaptureEvents should be called before the CDIntfEx control starts sending events to the calling application and after EnablePrinter.
Events should be disabled before exiting the application by calling CaptureEvents (False).
CaptureEvents adds the option BroadcastMessages (&H20) to FileNameOptionsEx. If the user or developer changes the value for FileNameOptionsEx, they should make sure they include this option with their other options, events will otherwise be disabled.
Imports System.IO
Imports CDIntfEx
Module Module1
Dim printJobs As New Dictionary(Of Integer, BinaryWriter)
Dim PDF As CDIntfEx.CDIntfEx
Sub Main()
' Constants for Activation codes
Const strLicenseTo As String = "Amyuni Tech. DEMO"
Const strActivationCode As String =
"07EFCDAB010001008037C498F1760CD0526CC963C46CDA42AF3DED36562F3F79DB6D6E670F757ADF1BBBC35F66B21F9A0C0F96D6D079F14672"
Const AMYUNIPRINTERNAME As String = "Amyuni PDF Converter 650"
' Declare a new cdintfex object if it does not exist in the form.
PDF = New CDIntfEx.CDIntfEx
' Get a reference to the installed printer.
' This will fail if the printer name passed to the DriverInit method is
' not found in the printer’s folder
PDF.DriverInit(AMYUNIPRINTERNAME)
' The SetDefaultPrinter function sets the system default printer to the one
' initialized by the DriverInit functions.
PDF.SetDefaultPrinter()
' The EnablePrinter() method needs to be called right before each print job.
' and before the configuration
' Calling the EnablePrinter() method will start a 20 second time-out value
PDF.EnablePrinter(strLicenseTo, strActivationCode)
' ' it needs to have UseGetAvailableData property
PDF.UseGetAvailableData = True
' Handlers for PDF's printer events
AddHandler PDF.StartDocPost, AddressOf PdfStartDocPost
AddHandler PDF.EndPage, AddressOf PdfEndPage
AddHandler PDF.EndDocPost, AddressOf PdfEndDocPost
' Handlers for two new PDF events
AddHandler PDF.BufferFull, AddressOf PdfBufferFull
AddHandler PDF.DocCancelled, AddressOf PdfDocCancelled
'Start Capture of Events (Always after Enabling Printer)
PDF.CaptureEvents(True)
' Printing something
PDF.BatchConvert("c:\temp\Document.rtf")
' The RestoreDefaultPrinter function resets the system default printer
' to the printer that was the default before the call to SetDefaultPrinter.
PDF.RestoreDefaultPrinter()
'End Capture of Events
PDF.CaptureEvents(False)
' This function will simply detach from an existing printer because the handle was created using DriverInit
PDF.DriverEnd()
End Sub
''' <summary>
''' Helper that will retrieve all available data from the PDF Converter for the specified print job ID
''' </summary>
''' <param name="JobID">
''' </param>
Public Sub RetrieveAvailableDataForJob(JobID as Integer)
While True
Dim data As Byte() = PDF.GetAvailableDataEx(JobID, 100000)
Dim size As Integer = data.Length
If size = 0 Then
Exit While
End If
printJobs(JobID).Write(data, 0, size)
End While
End Sub
''' <summary>
''' It is important to handle StartDocPost event and call PDF.GetAvailableDataEx() because
''' the first call sets up a method of communication with the driver for this print job.
''' This also enables the driver to notify us when the buffer for this print job is full and
''' needs to be read before printing can resume.
''' </summary>
''' <param name="JobId">
''' </param>
''' <param name="hDC">
''' </param>
Public Sub PdfStartDocPost(JobId As Long, hDC As Long)
' Open the File
printJobs(JobID) = new BinaryWriter(File.OpenWrite("C:\Temp\jobID_" + JobID.ToString() + ".pdf"))
' Retrieve Data
RetrieveAvailableDataForJob(JobID)
End Sub
''' <summary>
''' Handling of EndPage event is optional. It can be used to either retrieve any available
''' data after each page is printed or simply to indicate page progress.
''' </summary>
''' <param name="JobId">
''' </param>
''' <param name="hDC">
''' </param>
Public Sub PdfEndPage(JobId As Long, hDC As Long)
' Retrieve Data
RetrieveAvailableDataForJob(JobID)
End Sub
''' <summary>
''' In the EndDocPost even we retrieve any remaining data for this print job and we close the associated file we are writing the data to.
''' </summary>
''' <param name="JobId">The job identifier.</param>
''' <param name="hDC">The h dc.</param>
Public Sub PdfEndDocPost(JobId As Long, hDC As Long)
' Retrieve Data last time
RetrieveAvailableDataForJob(JobID)
'Close the File
printJobs(JobID).Close()
printJobs.Remove(JobID)
End Sub
''' <summary>
''' Handling of the new DocCancelled event is important in case where the printing is in a different process
''' and the user cancels the printing from that external application. Without this handler, we cannot know
''' if the document finished printing and we will wait indefinitely for that. This is because Windows does not
''' send the EndDocPost event when a print job is cancelled.
''' </summary>
''' <param name="JobId">The job identifier.</param>
''' <param name="hDC">The h dc.</param>
Public Sub PdfDocCancelled(JobId As Long, hDC As Long)
'Close the File
printJobs(JobID).Close()
' might want to delete the file after closing it in this case ?
printJobs.Remove(JobID)
End Sub
''' <summary>
''' This even is important to handle for all print jobs because in some cases, the print buffer on the driver side
''' might fill before the printer fires any of the other events that we are handling on the PDF side. If we do not handle
''' this even here, it will result in the printer waiting indefinitely for PDF to read the available data before it can re-use
''' the space in the buffer. When we handle this event and call PDF.GetAvailableDataEx() we tell the driver that it can go ahead and
''' use the space for writing new data because we read the previous data.
''' </summary>
''' <param name="JobId">The job identifier.</param>
''' <param name="hDC">The h dc.</param>
Public Sub PdfBufferFull(JobId As Long, hDC As Long)
' Retrieve Data
RetrieveAvailableDataForJob(JobID)
End Sub
End Module
using System;
using System.Collections.Generic;
using System.IO;
namespace CDIntfPrintEventsTester
{
class Program
{
static Dictionary<int, BinaryWriter> printJobs = new Dictionary<int, BinaryWriter>();
static CDIntfEx.CDIntfEx PDF;
[STAThread]
static void Main(string[] args)
{
const string strLicenseTo = "Amyuni Tech. DEMO";
const string strActivationCode =
"07EFCDAB010001008037C498F1760CD0526CC963C46CDA42AF3DED36562F3F79DB6D6E670F757ADF1BBBC35F66B21F9A0C0F96D6D079F14672";
const string AMYUNIPRINTERNAME = "Amyuni PDF Converter 650";
// Declare a new cdintfex object if it does not exist in the form.
PDF = new CDIntfEx.CDIntfEx();
// Get a reference to the installed printer.
// This will fail if the printer name passed to the DriverInit method is
// not found in the printer’s folder
PDF.DriverInit(AMYUNIPRINTERNAME);
// The SetDefaultPrinter function sets the system default printer to the one
// initialized by the DriverInit functions.
PDF.SetDefaultPrinter();
// The EnablePrinter()method needs to be called right before each print job.
// and before the configuration
// Calling the EnablePrinter()method will start a 20 second time-out value
PDF.EnablePrinter(strLicenseTo, strActivationCode);
// ' it needs to have UseGetAvailableData property
PDF.UseGetAvailableData = true;
// Handlers for PDF's printer events
PDF.StartDocPost += PdfStartDocPost;
PDF.EndPage += PdfEndPage;
PDF.EndDocPost += PdfEndDocPost;
// Handlers for two new PDF events
PDF.BufferFull += PdfBufferFull;
PDF.DocCancelled += PdfDocCancelled;
// Start Capture of Events (Always after Enabling Printer)
PDF.CaptureEvents(true);
// Printing something
PDF.BatchConvert("c:\\temp\\Document.rtf");
// The RestoreDefaultPrinter function resets the system default printer
// to the printer that was the default before the call to SetDefaultPrinter.
PDF.RestoreDefaultPrinter();
// End Capture of Events
PDF.CaptureEvents(false);
// This function will simply detach from an existing printer because the handle was created using DriverInit
PDF.DriverEnd();
}
/// <summary>
///
/// Helper that will retrieve all available data from the PDF Converter for the specified print job ID
///
/// </summary>
/// <param name="JobID"></param>
private static void RetrieveAvailableDataForJob(int JobID)
{
while (true)
{
byte[] data = PDF.GetAvailableDataEx(JobID, 100000);
int size = data.Length;
if (size == 0) break;
printJobs[JobID].Write(data, 0, size);
}
}
/// <summary>
///
/// It is important to handle StartDocPost event and call PDF.GetAvailableDataEx() because
/// the first call sets up a method of communication with the driver for this print job.
/// This also enables the driver to notify us when the buffer for this print job is full and
/// needs to be read before printing can resume.
///
/// </summary>
/// <param name="JobID"></param>
/// <param name="hDC"></param>
private static void PdfStartDocPost(int JobID, int hDC)
{
// Open the File
printJobs[JobID] = new BinaryWriter(File.OpenWrite("C:\\Temp\\jobID_" + JobID.ToString() + ".pdf"));
// Retrieve Data
RetrieveAvailableDataForJob(JobID);
}
/// <summary>
///
/// Handling of EndPage event is optional. It can be used to either retrieve any available
/// data after each page is printed or simply to indicate page progress.
///
/// </summary>
/// <param name="JobID"></param>
/// <param name="hDC"></param>
private static void PdfEndPage(int JobID, int hDC)
{
// Retrieve Data
RetrieveAvailableDataForJob(JobID);
}
/// <summary>
///
/// In the EndDocPost even we retrieve any remaining data for this print job and we close the associated file we are writing the data to.
///
/// </summary>
/// <param name="JobID"></param>
/// <param name="hDC"></param>
private static void PdfEndDocPost(int JobID, int hDC)
{
// Retrieve Data last time
RetrieveAvailableDataForJob(JobID);
// Close the File
printJobs[JobID].Close();
printJobs.Remove(JobID);
}
/// <summary>
///
/// Handling of the new DocCancelled event is important in case where the printing is in a different process
/// and the user cancels the printing from that external application. Without this handler, we cannot know
/// if the document finished printing and we will wait indefinitely for that. This is because Windows does not
/// send the EndDocPost event when a print job is cancelled.
///
/// </summary>
/// <param name="JobID"></param>
/// <param name="hDC"></param>
private static void PdfDocCancelled(int JobID, int hDC)
{
// Close the File
printJobs[JobID].Close();
// might want to delete the file after closing it in this case ?
printJobs.Remove(JobID);
}
/// <summary>
///
/// This even is important to handle for all print jobs because in some cases, the print buffer on the driver side
/// might fill before the printer fires any of the other events that we are handling on the PDF side. If we do not handle
/// this even here, it will result in the printer waiting indefinitely for PDF to read the available data before it can re-use
/// the space in the buffer. When we handle this event and call PDF.GetAvailableDataEx() we tell the driver that it can go ahead and
/// use the space for writing new data because we read the previous data.
///
/// </summary>
/// <param name="JobID"></param>
/// <param name="hDC"></param>
private static void PdfBufferFull(int JobID, int hDC)
{
// Retrieve Data
RetrieveAvailableDataForJob(JobID);
}
}
}