HorizontalMargin and VerticalMargin

The HorizontalMargin and VerticalMargin properties are used to set or read the minimum printer margins. Applications cannot print below the minimum margins defined by the printer. The Converter products being virtual printers, the minimum margins can be set to 0, this might cause some clipping if the generated document is later printed to a physical printer.

 

The default value is set to 6 millimeters in order to accommodate most hardware printers available in the market.

 

Syntax

ActiveX:

System.Int16 HorizontalMargin
System.Int16 VerticalMargin

DLL:

long GetHorizontalMargin(HANDLE hPrinter)
long SetHorizontalMargin(HANDLE hPrinter, long nMargin)
long GetVerticalMargin(HANDLE hPrinter)
long SetVerticalMargin(HANDLE hPrinter, long nMargin)

 

Parameters

HorizontalMargin

[in, out] Minimum horizontal printer margin in 10th of a millimeter unit.

VerticalMargin

[in, out] Minimum vertical printer margin in 10th of a millimeter unit.

hPrinter

Handle to printer returned by any of the DriverInit function calls.

nMargin

Minimum printer margin in 10th of a millimeter unit.

 

Return Value

SetHorizontalMargin and SetVerticalMargin return 1 if successful, 0 otherwise.  HorizontalMargin, VerticalMargin, GetHorizontalMargin and GetVerticalMargin return the current value for the specified printer in 10th of a millimeter. The default values for both vertical and horizontal margins is 6 mm, the return value should be 60 if these settings are not modified.

 

Remarks

These properties can be used in two situations:

  1. The developer needs to modify the default values for the printer; in this case SetDefaultConfig should be called after modifying these settings to set the value as default for all applications. Application developers should not call this function for every printout but only after printer initialization.

  2. The printer device context is created using the function CDICreateDC. This function uses the settings provided by these functions and there is no need to call SetDefaultConfig.

 

These settings define the minimum margin below which an application cannot print. Applications usually define their own margin settings and send a warning to the user which attempts to set margins lower than the printer' s minimum value.

The default value for these properties is 60, or 6.0 millimeters.

 

Member of CDIntfEx.CDIntfEx.

 

Example

<Flags()>


Public Enum acFileNameOptions As Integer


    ' Please check FileNameOptions for the complete flags version


    NoPrompt = &H1


    UseFileName = &H2


    Concatenate = &H4


    DisableCompression = &H8


    EmbedFonts = &H10


    BroadcastMessages = &H20


    PrintWatermark = &H40


End Enum


 


Public Sub Sample()


    ' Constants for Activation codes


    Const strLicenseTo As String = "Amyuni PDF Converter Evaluation"


    Const strActivationCode As String = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA"


    Const AMYUNIPRINTERNAME As String = "Amyuni PDF Converter"


 


    ' Declare a new cdintfex object if it does not exist in the form.


    Dim PDF As 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)


 


    ' Resulting PDF document stored here


    PDF.DefaultDirectory = "C:\Temp"


 


    ' Set Printer options


    PDF.FileNameOptionsEx = acFileNameOptions.NoPrompt


 


    ' Set minimum printer margins


    PDF.HorizontalMargin = 70  ' For 7mm


    PDF.VerticalMargin = 70  ' For 7mm


 


    ' Apply Settings


    PDF.SetDefaultConfig()


 


    ' The BatchConvert method converts a number of files to PDF.


    PDF.BatchConvert("C:\Temp\*.docx")


 


    ' The RestoreDefaultPrinter function resets the system default printer 


    ' to the printer that was the default before the call to SetDefaultPrinter.


    PDF.RestoreDefaultPrinter()


 


    ' This function will simply detach from an existing printer because the handle was created using DriverInit


    PDF.DriverEnd()


 


    ' Destroy PDF object


    PDF = Nothing    


End Sub


[Flags]


public enum acFileNameOptions


{


    // Please check FileNameOptions for the complete flags version


    NoPrompt = 0x00000001,


    UseFileName = 0x00000002,


    Concatenate = 0x00000004,


    DisableCompression = 0x00000008,


    EmbedFonts = 0x00000010,


    BroadcastMessages = 0x00000020,


    PrintWatermark = 0x00000040


}


public void Sample()


{


    // Constants for Activation codes


    const string strLicenseTo = "Amyuni PDF Converter Evaluation";


    const string strActivationCode = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA";


    const string AMYUNIPRINTERNAME = "Amyuni PDF Converter";


 


    // Declare a new cdintfex object if it does not exist in the form.


    CDIntfEx.CDIntfEx 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);


 


    // Resulting PDF document stored here


    PDF.DefaultDirectory = @"C:\Temp";


 


    // Set Printer options


    PDF.FileNameOptionsEx = (int)acFileNameOptions.NoPrompt;


 


    // Set minimum printer margins


    PDF.HorizontalMargin = 70;  // For 7mm


    PDF.VerticalMargin = 70;  // For 7mm


 


    // Apply Settings


    PDF.SetDefaultConfig();


 


    // The BatchConvert method converts a number of files to PDF.


    PDF.BatchConvert(@"C:\Temp\*.docx");


 


    // The RestoreDefaultPrinter function resets the system default printer 


    // to the printer that was the default before the call to SetDefaultPrinter.


    PDF.RestoreDefaultPrinter();


 


    // This function will simply detach from an existing printer because the handle was created using DriverInit


    PDF.DriverEnd();


 


 


}


// PDF Converter Cpp.cpp : Defines the entry point for the console application.


// 


 


#include <Windows.h>


#include <string>


#include <iostream>


#include "CdIntf.h"


#pragma comment (lib, "CDIntf.lib")


 


using namespace std;


int main()


{


     // Constants for Activation codes


    #define strLicenseTo  "Amyuni PDF Converter Evaluation"


    #define strActivationCode "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA"


    #define AMYUNIPRINTERNAME "Amyuni PDF Converter"


 


    // 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


    HANDLE PDF = DriverInit(AMYUNIPRINTERNAME);


 


    // The CDISetDefaultPrinter function sets the system default printer to the one


    // initialized by the DriverInit functions.


    CDISetDefaultPrinter(PDF);


 


    // 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


    EnablePrinter(PDF, strLicenseTo, strActivationCode);


 


    // Resulting PDF document stored here


    SetDefaultDirectory(PDF, "c:\\Temp");


 


    // Set Printer options


    SetFileNameOptions(PDF, NoPrompt);


 


    // Set minimum printer margins


    SetHorizontalMargin(PDF, 70);  // For 7mm


    SetVerticalMargin(PDF, 70);  // For 7mm


 


    // Apply Settings


    SetDefaultConfig(PDF);


 


    // The BatchConvert method converts a number of files to PDF.


    BatchConvertEx(PDF, "c:\\Temp\\*.docx");


 


    // The RestoreDefaultPrinter function resets the system default printer 


    // to the printer that was the default before the call to SetDefaultPrinter.


    RestoreDefaultPrinter(PDF);


 


    // This function will simply detach from an existing printer because the handle was created using DriverInit


    DriverEnd(PDF); 


 


    // Destroy PDF object


    PDF = nullptr;    


 


    return 0;


}


package Example;


 


import com.jacob.activeX.ActiveXComponent;


import com.jacob.com.Dispatch;


 


public class Sample {


    public enum acFileNameOptions


        {


            // Please check FileNameOptions for the complete flags version


            NoPrompt(0x00000001),


            UseFileName(0x00000002),


            Concatenate(0x00000004),


            DisableCompression(0x00000008),


            EmbedFonts(0x00000010),


            BroadcastMessages(0x00000020),


            PrintWatermark(0x00000040);


            public int value;


            public acFileNameOptions(int value)


            {


                this.value = value;


            }


            public Object value(){


                return value;


            }        }


    public static void main(String[] args)


    {


        // Constants for Activation codes


        String strLicenseTo  = "Amyuni PDF Converter Evaluation";


        String strActivationCode = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA";


        String AMYUNIPRINTERNAME = "Amyuni PDF Converter";


 


        // Declare a new cdintfex object if it does not exist in the form.


        ActiveXComponent pdf = new ActiveXComponent("CDIntfEx.CDIntfEx.6.5"); 


 


        // 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


        Dispatch.call(pdf,"DriverInit",AMYUNIPRINTERNAME);


 


        // The SetDefaultPrinter function sets the system default printer to the one


        // initialized by the DriverInit functions.


        Dispatch.call(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


        Dispatch.call(pdf,"EnablePrinter", strLicenseTo, strActivationCode); 


 


        // Resulting PDF document stored here


        Dispatch.put(pdf,"DefaultDirectory","c:\\Temp");


 


        // Set Printer options


        Dispatch.put(pdf,"FileNameOptionsEx",acFileNameOptions.NoPrompt.value);


 


        // Activate or deactivate the TrueType® font embedding


        Dispatch.put(pdf, "HorizontalMargin", 70);  // For 7mm


        Dispatch.put(pdf, "VerticalMargin", 70);  // For 7mm


 


        // Apply Settings


        Dispatch.call(pdf, "SetDefaultConfig");


 


        // The BatchConvert method converts a number of files to PDF.


        Dispatch.call(pdf,"BatchConvert","c:\\Temp\\*.docx");


 


        // The RestoreDefaultPrinter function resets the system default printer 


        // to the printer that was the default before the call to SetDefaultPrinter.


        Dispatch.call(pdf,"RestoreDefaultPrinter"); 


 


        // This function will simply detach from an existing printer because the handle was created using DriverInit


        Dispatch.call(pdf,"DriverEnd");


 


        // Destroy PDF object


        pdf = null;        


    }


}


$acFileNameOptions = @{


    NoPrompt = 0x00000001


    UseFileName = 0x00000002


    Concatenate = 0x00000004


    DisableCompression = 0x00000008


    EmbedFonts = 0x00000010


    BroadcastMessages = 0x00000020


    PrintWatermark = 0x00000040


} 


#Please check FileNameOptions for the complete flags version


 


# Constants for Activation codes


$strLicenseTo  =  "Amyuni PDF Converter Evaluation"


$strActivationCode = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA"


$AMYUNIPRINTERNAME = "Amyuni PDF Converter"


 


#Declare a new cdintfex object if it does not exist in the form.


$PDF = New-Object -ComObject CDIntfEx.CDIntfEx.6.5


 


#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


[System.__ComObject].InvokeMember('DriverInit', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF,$AMYUNIPRINTERNAME) 


 


#The SetDefaultPrinter function sets the system default printer to the one


#initialized by the DriverInit functions.


[System.__ComObject].InvokeMember('SetDefaultPrinter', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF,$null) 


 


#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


[System.__ComObject].InvokeMember('EnablePrinter', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF, @($strLicenseTo, $strActivationCode))


 


#Resulting PDF document stored here


[System.__ComObject].InvokeMember('DefaultDirectory', [System.Reflection.BindingFlags]::SetProperty,$null,$PDF,"C:\Temp") 


 


#Set Printer options


[System.__ComObject].InvokeMember('FileNameOptionsEx', [System.Reflection.BindingFlags]::SetProperty,$null,$PDF,$acFileNameOptions::NoPrompt)


 


#Set minimum printer margins


[System.__ComObject].InvokeMember('HorizontalMargin', [System.Reflection.BindingFlags]::SetProperty,$null,$PDF,70)  # For 7mm


[System.__ComObject].InvokeMember('VerticalMargin', [System.Reflection.BindingFlags]::SetProperty,$null,$PDF,70)  # For 7mm 


 


#Apply Settings


[System.__ComObject].InvokeMember('SetDefaultConfig', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF, $null)


 


#The BatchConvert method converts a number of files to PDF.


[System.__ComObject].InvokeMember('BatchConvert', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF, "C:\Temp\*.docx")


 


#The RestoreDefaultPrinter function resets the system default printer 


#to the printer that was the default before the call to SetDefaultPrinter.


[System.__ComObject].InvokeMember('RestoreDefaultPrinter', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF,$null) 


 


#This function will simply detach from an existing printer because the handle was created using DriverInit 


[System.__ComObject].InvokeMember('DriverEnd', [System.Reflection.BindingFlags]::InvokeMethod,$null,$PDF,$null) 


 


#Destroy PDF object


$PDF = $null


' FileNameOptions constants


' Please check FileNameOptions for the complete flags version


Const NoPrompt = &H1


Const UseFileName = &H2


Const Concatenate = &H4


Const DisableCompression = &H8


Const EmbedFonts = &H10


Const BroadcastMessages = &H20


Const PrintWatermark = &H40


Const MultilingualSupport = &H80


Const EncryptDocument = &H100


Const FullEmbed = &H200


 


' Constants for Activation codes


Const strLicenseTo = "Amyuni PDF Converter Evaluation"


Const strActivationCode = "07EFCDAB0100010025AFF1801CB9441306C5739F7D452154D8833B9CECBA2ADE79E3762A69FFC354528A5F4A5811BE3204A0A439F5BA"


Const AMYUNIPRINTERNAME = "Amyuni PDF Converter"


 


' Declare a new cdintfex object


Dim PDF


Set PDF = CreateObject("CDIntfEx.CDIntfEx.6.5")


 


' 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


 


' Resulting PDF document stored here


PDF.DefaultDirectory = "C:\Temp"


 


' Set Printer options


PDF.FileNameOptionsEx = NoPrompt


 


' Set minimum printer margins


PDF.HorizontalMargin = 70  ' For 7mm


PDF.VerticalMargin = 70  ' For 7mm


 


' Apply Settings


PDF.SetDefaultConfig


 


' The BatchConvert method converts a number of files to PDF.


PDF.BatchConvert "C:\Temp\*.docx"


 


' The RestoreDefaultPrinter function resets the system default printer


' to the printer that was the default before the call to SetDefaultPrinter.


PDF.RestoreDefaultPrinter


 


' This function will simply detach from an existing printer because the handle was created using DriverInit


PDF.DriverEnd


 


' Destroy PDF object


Set PDF = Nothing