The DigitalSignatureEx method is used to add a digital signature to a PDF document. Prior to digitally signing a document, the users or developers should have on their systems a digital certificate that can be used to sign documents.
A user who receives a document that is digitally signed can verify if the digital signature is valid and if the document has been tempered with.
Public Function DigitalSignatureEx(signedBy As String, reason As String, imageFile As String, location As String, pageNumber As Integer, horzPos As Integer, vertPos As Integer, width As Integer, height As Integer, flags As Integer, Store As String, DateFormat As String) As Boolean
public bool DigitalSignatureEx(string signedBy, string reason, string imageFile, string location, int pageNumber, int horzPos, int vertPos, int width, int height, int flags, string Store, string DateFormat)
ssignedBy
Friendly name of the digital signature as it appears to the user when the digital certificate is installed on the system. In most cases, this is the full name of the person signing the document.
reason
Reason for signing the document. It can be an empty string if no reason is specified.
imageFile
Full path of the file containing the image that is associated with the signature. This is optional, a digital signature does not always contain an image.
location
Physical location of the person who signed the document. This parameter is optional.
pageNumber
Page number on which to insert the signature. Page numbers start with 1, the value -1 indicates the last page in the document.
horzPos, vertPos
Horizontal and vertical position of the digital signature in Twips.
width, height
Width and height of the digital signature in Twips.
flags
Combination of flags that determine how the digital signature appears on the page. A value of 0 indicates that the signature is invisible.
Flags |
Value (Dec) |
Value (Hex) |
---|---|---|
Hidden Signature |
0 |
0x000 |
Signer name |
1 |
0x001 |
Reason for signing |
2 |
0x002 |
Location |
4 |
0x004 |
Associated image |
8 |
0x008 |
Certificate |
16 |
0x010 |
Date of signing |
32 |
0x020 |
Signature type |
64 |
0x040 |
Show all |
255 |
0x0FF |
Enabling PAdES |
256 |
0x100 |
Enabling PAdES with LTV support (Long Term Validation) |
512 |
0x200 |
Store
Certification store location where the library will look for the certificate.
There are 2 parameters to specify, the Store Location and the Store Name. These can be specified by using 4 letters for the Store Location, followed by 2 back-slashes, followed by the Store Name: <Store Location>\\<store name>.
The default value is HKCU\\MY.
For the Store Location can be specified using the 4 letter codes from this list:
Store Location |
Name |
---|---|
HKCU |
CERT_SYSTEM_STORE_CURRENT_USER |
HKLM |
CERT_SYSTEM_STORE_LOCAL_MACHINE |
HKCS |
CERT_SYSTEM_STORE_CURRENT_SERVICE |
HKSS |
CERT_SYSTEM_STORE_SERVICES |
HKUS |
CERT_SYSTEM_STORE_USERS |
HKUG |
CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY |
HKMG |
CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY |
HKME |
CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE |
For each system store location, the predefined systems stores are:
System Store Location |
---|
MY |
Root |
Trust |
CA |
DateFormat
Formatting string for the date value in the digital certificate.
The default value (empty string) displays the date in the default PDF format.
Returns Value True if the call succeeded and False otherwise.
The exception Amyuni.PDFCreator.IacException.LicenseKeyError might be generated if the provided license is not valid or wrong.
For more information about the Store Location, please, check this Microsoft article: https:// msdn.microsoft.com/en-us/library/windows/desktop/aa388136(v=vs.85).aspx
The possible values for the DateFormat are explained here: https:// msdn.microsoft.com/en-us/library/aa272978(v=vs.60).aspx
E.g. specifying ā%cā will display the date in the default system format for date/time.
This object uses the DefaultFont attribute of the Document Object for the texts.
Member of Amyuni.PDFCreator.IacDocument.
<Flags()>
Public Enum FlagsSignature As Integer
SIGNATURE_DISPLAY_SIGNER = &H1
SIGNATURE_DISPLAY_REASON = &H2
SIGNATURE_DISPLAY_LOCATION = &H4
SIGNATURE_DISPLAY_IMAGE = &H8
SIGNATURE_DISPLAY_CERTIFICATE = &H10
SIGNATURE_DISPLAY_DATE = &H20
SIGNATURE_DISPLAY_TYPE = &H40
SIGNATURE_LEVEL_PADES = &H100
SIGNATURE_LEVEL_PADES_LTV = &H200
End Enum
Sub Sample()
' Constants for Activation codes
Const strLicenseTo As String = "Amyuni PDF Creator .NET Evaluation"
Const strActivationCode As String = "07EFCDAB0100010025C3B7B351579FF94C49112EAF7368612744C7237C2F6A215A53E83A9ECCFFE54C52063CB05338BDE555773D7B1B"
' Initialize library
' This should be done once
acPDFCreatorLib.Initialize()
' set license key This is needed only with licensed version
acPDFCreatorLib.SetLicenseKey(strLicenseTo, strActivationCode)
' Create a new PDF document
Dim doc As New Amyuni.PDFCreator.IacDocument()
' Create page object
Dim page As Amyuni.PDFCreator.IacPage
' Define first page of PDF document
page = doc.GetPage(1)
' Switch to design mode before adding objects to the document
doc.ReportState = Amyuni.PDFCreator.IacReportState.acReportStateDesign
' Create a Text
With page.CreateObject(Amyuni.PDFCreator.IacObjectType.acObjectTypeText, "Text1")
.Attribute("Left").Value = 1000
.Attribute("Top").Value = 0
.Attribute("Right").Value = 3250
.Attribute("Bottom").Value = 500
.Attribute("Text").Value = "Amyuni Technologies"
.Attribute("Single line").Value = True
End With
' Switch to run mode after objects to the document
doc.ReportState = Amyuni.PDFCreator.IacReportState.acReportStateRun
' Add digital signature
Dim signedBy As String = "Test User"
Dim reason As String = "Testing"
Dim imageFile As String = "C:\temp\signature.png"
Dim location As String = "Montreal"
Dim pageNumber As Integer = 1
Dim horzPos As Integer = 4000
Dim vertPos As Integer = 4500
Dim width As Integer = 6000
Dim height As Integer = 6000
Dim flags As Integer = FlagsSignature.SIGNATURE_DISPLAY_SIGNER Or FlagsSignature.SIGNATURE_DISPLAY_IMAGE
Dim store As String = "HKCU\\MY"
Dim dateFormat As String = "%c"
doc.DigitalSignatureEx(signedBy, reason, imageFile, location, pageNumber, horzPos, vertPos, width, height, flags, store, dateFormat)
' Create new stream object
Dim fileWrite As System.IO.Stream = System.IO.File.OpenWrite("C:\temp\CreatePDFDocument_resulting.pdf")
' Save stream
doc.Save(fileWrite, Amyuni.PDFCreator.IacFileSaveOption.acFileSaveView)
' Close the stream
fileWrite.Close()
' terminate library to free resources
acPDFCreatorLib.Terminate()
' destroy objects
doc.Dispose()
page.Dispose()
End Sub
[Flags]
enum FlagsSignature
{
SIGNATURE_DISPLAY_SIGNER = 0x001,
SIGNATURE_DISPLAY_REASON = 0x002,
SIGNATURE_DISPLAY_LOCATION = 0x004,
SIGNATURE_DISPLAY_IMAGE = 0x008,
SIGNATURE_DISPLAY_CERTIFICATE = 0x010,
SIGNATURE_DISPLAY_DATE = 0x020,
SIGNATURE_DISPLAY_TYPE = 0x040,
SIGNATURE_LEVEL_PADES = 0x100,
SIGNATURE_LEVEL_PADES_LTV = 0x200
}
static void Sample()
{
// Constants for Activation codes
const string strLicenseTo = "Amyuni PDF Creator .NET Evaluation";
const string strActivationCode = "07EFCDAB0100010025C3B7B351579FF94C49112EAF7368612744C7237C2F6A215A53E83A9ECCFFE54C52063CB05338BDE555773D7B1B";
// Initialize library
// This should be done once
acPDFCreatorLib.Initialize();
// set license key This is needed only with licensed version
acPDFCreatorLib.SetLicenseKey(strLicenseTo, strActivationCode);
// Create a new PDF document
Amyuni.PDFCreator.IacDocument doc = new Amyuni.PDFCreator.IacDocument();
// Create page object
Amyuni.PDFCreator.IacPage page;
// Define first page of PDF document
page = doc.GetPage(1);
// Switch to design mode before adding objects to the document
doc.ReportState = Amyuni.PDFCreator.IacReportState.acReportStateDesign;
// Create a Text
using (Amyuni.PDFCreator.IacObject oText = page.CreateObject(Amyuni.PDFCreator.IacObjectType.acObjectTypeText, "Text1"))
{
oText.Attribute("Left").Value = 1000;
oText.Attribute("Top").Value = 0;
oText.Attribute("Right").Value = 3250;
oText.Attribute("Bottom").Value = 500;
oText.Attribute("Text").Value = "Amyuni Technologies";
oText.Attribute("Single line").Value = true;
}
// Switch to run mode after objects to the document
doc.ReportState = Amyuni.PDFCreator.IacReportState.acReportStateRun;
// Encryption
string signedBy = "Test User";
string reason = "Testing";
string imageFile = @"C:\temp\signature.png";
string location = "Montreal";
int pageNumber = 1;
int horzPos = 4000;
int vertPos = 4500;
int width = 6000;
int height = 6000;
int flags = (int)(FlagsSignature.SIGNATURE_DISPLAY_SIGNER | FlagsSignature.SIGNATURE_DISPLAY_IMAGE);
string store = "HKCU\\MY";
string dateFormat = "%c";
doc.DigitalSignatureEx(signedBy, reason, imageFile, location, pageNumber, horzPos, vertPos, width, height, flags, store, dateFormat);
// Create new stream object
System.IO.FileStream fileWrite = new System.IO.FileStream(@"C:\temp\CreatePDFDocument_resulting.pdf",
System.IO.FileMode.Create,
System.IO.FileAccess.Write,
System.IO.FileShare.Read);
// Save stream
doc.Save(fileWrite, Amyuni.PDFCreator.IacFileSaveOption.acFileSaveView);
// Close the stream
fileWrite.Close();
// terminate library to free resources
acPDFCreatorLib.Terminate();
}