/// <summary>
/// Delete QR-Code signature from the document
/// </summary>
public static void Run()
{
Console.WriteLine("\n--------------------------------------------------------------------------------------------------------------------");
Console.WriteLine("[Example Basic Usage] # DeleteQRCode : Delete QR-Code signature from the document \n");
// The path to the documents directory.
string filePath = Constants.SAMPLE_SIGNED_MULTI;
string fileName = Path.GetFileName(filePath);
// copy source file since Delete method works with same Document
string outputFilePath = Path.Combine(Constants.OutputPath, "DeleteQRCode", fileName);
Constants.CheckDir(outputFilePath);
File.Copy(filePath, outputFilePath, true);
using (Signature signature = new Signature(outputFilePath))
{
QrCodeSearchOptions options = new QrCodeSearchOptions();
// search for QRCode signatures in document
List <QrCodeSignature> signatures = signature.Search <QrCodeSignature>(options);
if (signatures.Count > 0)
{
QrCodeSignature qrCodeSignature = signatures[0];
bool result = signature.Delete(qrCodeSignature);
if (result)
{
Console.WriteLine($"Signature with QR-Code '{qrCodeSignature.Text}' and encode type '{qrCodeSignature.EncodeType.TypeName}' was deleted from document ['{fileName}'].");
}
else
{
Helper.WriteError($"Signature was not deleted from the document! Signature with Barcode '{qrCodeSignature.Text}' and encode type '{qrCodeSignature.EncodeType.TypeName}' was not found!");
}
}
}
}
/// <summary>
/// Delete multiple signatures from the document
/// </summary>
public static void Run()
{
Console.WriteLine("\n--------------------------------------------------------------------------------------------------------------------");
Console.WriteLine("[Example Basic Usage] # DeleteMultiple : Delete multiple signatures from the document \n");
// The path to the documents directory.
string filePath = Constants.SAMPLE_SIGNED_MULTI;
string fileName = Path.GetFileName(filePath);
// copy source file since Delete method works with same Document
string outputFilePath = Path.Combine(Constants.OutputPath, "DeleteMultiple", fileName);
Constants.CheckDir(outputFilePath);
File.Copy(filePath, outputFilePath, true);
// processing signatures
using (Signature signature = new Signature(outputFilePath))
{
// define few search options
TextSearchOptions textSearchOptions = new TextSearchOptions();
ImageSearchOptions imageSearchOptions = new ImageSearchOptions();
BarcodeSearchOptions barcodeOptions = new BarcodeSearchOptions();
QrCodeSearchOptions qrCodeOptions = new QrCodeSearchOptions();
// add options to list
List <SearchOptions> listOptions = new List <SearchOptions>();
listOptions.Add(textSearchOptions);
listOptions.Add(imageSearchOptions);
listOptions.Add(barcodeOptions);
listOptions.Add(qrCodeOptions);
// search for signatures in document
SearchResult result = signature.Search(listOptions);
if (result.Signatures.Count > 0)
{
Console.WriteLine("\nTrying to delete all signatures...");
DeleteResult deleteResult = signature.Delete(result.Signatures);
if (deleteResult.Succeeded.Count == result.Signatures.Count)
{
Console.WriteLine("\nAll signatures were successfully deleted!");
}
else
{
Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
Helper.WriteError($"Not deleted signatures : {deleteResult.Failed.Count}");
}
Console.WriteLine("\nList of deleted signatures:");
int number = 1;
foreach (BaseSignature temp in deleteResult.Succeeded)
{
Console.WriteLine($"Signature #{number++}: Type: {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
}
}
else
{
Helper.WriteError("No one signature was found.");
}
}
}
/// <summary>
/// Search document for encrypted QR-Code signature with applying specific options
/// Please be aware that this example works only on licensed product due to limitation with QR-code processing
/// </summary>
public static void Run()
{
Console.WriteLine("\n--------------------------------------------------------------------------------------------------------------------");
Console.WriteLine("[Example Advanced Usage] # SearchForQRCodeEncryptedObject : Search document for encrypted QR-Code signature with applying specific options\n");
// The path to the documents directory.
string filePath = Constants.SAMPLE_PDF_QRCODE_ENCRYPTED_OBJECT;
using (Signature signature = new Signature(filePath))
{
// setup key and pasphrase
string key = "1234567890";
string salt = "1234567890";
// create data encryption
IDataEncryption encryption = new SymmetricEncryption(SymmetricAlgorithmType.Rijndael, key, salt);
QrCodeSearchOptions options = new QrCodeSearchOptions()
{
// specify special pages to search on
AllPages = true,
PageNumber = 1,
PagesSetup = new PagesSetup()
{
FirstPage = true, LastPage = true, OddPages = false, EvenPages = false
},
// specify special QRCode type to search
EncodeType = QrCodeTypes.QR,
//
DataEncryption = encryption
};
// search for signatures in document
try
{
List <QrCodeSignature> signatures = signature.Search <QrCodeSignature>(options);
Console.WriteLine("\nSource document contains following signatures.");
foreach (var qrCodeSignature in signatures)
{
Console.WriteLine("QRCode signature found at page {0} with type {1}.", qrCodeSignature.PageNumber, qrCodeSignature.EncodeType);
DocumentSignatureData documentSignatureData = qrCodeSignature.GetData <DocumentSignatureData>();
if (documentSignatureData != null)
{
Console.WriteLine("QRCode signature has DocumentSignatureData object:\n ID = {0}, Author = {1}, Signed = {2}, DataFactor {3}",
documentSignatureData.ID, documentSignatureData.Author, documentSignatureData.Signed.ToShortDateString(), documentSignatureData.DataFactor);
}
}
}
catch
{
Helper.WriteError("\nThis example requires license to properly run. " +
"\nVisit the GroupDocs site to obtain either a temporary or permanent license. " +
"\nLearn more about licensing at https://purchase.groupdocs.com/faqs/licensing. " +
"\nLear how to request temporary license at https://purchase.groupdocs.com/temporary-license.");
}
}
}
/// <summary>
/// Search document for QR-Code signature with applying specific options
/// </summary>
public static void Run()
{
Console.WriteLine("\n--------------------------------------------------------------------------------------------------------------------");
Console.WriteLine("[Example Advanced Usage] # SearchForQRCodeAdvanced : Search document for QR-Code signature with applying specific options\n");
// The path to the documents directory.
string filePath = Constants.SAMPLE_SIGNED_MULTI;
using (Signature signature = new Signature(filePath))
{
QrCodeSearchOptions options = new QrCodeSearchOptions()
{
// specify special pages to search on
AllPages = false,
PageNumber = 1,
PagesSetup = new PagesSetup()
{
FirstPage = true, LastPage = true, OddPages = false, EvenPages = false
},
// specify special QRCode type to search
EncodeType = QrCodeTypes.QR,
// specify text match type
MatchType = TextMatchType.Contains,
// specify text pattern to search
Text = "John",
// set field for QRCode images returning
ReturnContent = true,
// specify type of returned QRCode images
ReturnContentType = FileType.PNG
};
// search for signatures in document
List <QrCodeSignature> signatures = signature.Search <QrCodeSignature>(options); //For evaluation version is 0
Console.WriteLine("\nSource document contains following signatures.");
foreach (QrCodeSignature qrSignature in signatures)
{
Console.WriteLine($"\t #{qrSignature.SignatureId} at {qrSignature.PageNumber}-page, {qrSignature.EncodeType.TypeName} type, Text = '{qrSignature.Text}', created {qrSignature.CreatedOn.ToShortDateString()}, modified {qrSignature.ModifiedOn.ToShortDateString()}");
}
//Save QRCode images
string outputPath = System.IO.Path.Combine(Constants.OutputPath, "SearchForQRCodeAdvanced");
if (!Directory.Exists(outputPath))
{
Directory.CreateDirectory(outputPath);
}
int i = 0;
foreach (QrCodeSignature qrCodeSignature in signatures)
{
string outputFilePath = System.IO.Path.Combine(outputPath, $"image{i}{qrCodeSignature.Format.Extension}");
using (FileStream fs = new FileStream(outputFilePath, FileMode.Create))
{
fs.Write(qrCodeSignature.Content, 0, qrCodeSignature.Content.Length);
}
i++;
}
}
}
/// <summary>
/// Delete QR-code signature from the document.
/// </summary>
public static void Run()
{
Console.WriteLine("\n--------------------------------------------------------------------------------------------------------------------");
Console.WriteLine("[Example Advanced Usage] # DeleteQRCodeAfterSearch : Delete QR-code signature from the document\n");
// The path to the documents directory.
string filePath = Constants.SAMPLE_SIGNED_MULTI;
// copy source file since Delete method works with same Document
string fileName = Path.GetFileName(filePath);
string outputFilePath = Path.Combine(Constants.OutputPath, "DeleteQRCodeAfterSearch", fileName);
Constants.CheckDir(outputFilePath);
File.Copy(filePath, outputFilePath, true);
// initialize Signature instance
using (Signature signature = new Signature(outputFilePath))
{
QrCodeSearchOptions options = new QrCodeSearchOptions();
List <QrCodeSignature> signatures = signature.Search <QrCodeSignature>(options);
List <BaseSignature> signaturesToDelete = new List <BaseSignature>();
// collect signatures to delete
foreach (QrCodeSignature temp in signatures)
{
if (temp.Text.Contains("John"))
{
signaturesToDelete.Add(temp);
}
}
// delete signatures
DeleteResult deleteResult = signature.Delete(signaturesToDelete);
if (deleteResult.Succeeded.Count == signaturesToDelete.Count)
{
Console.WriteLine("All signatures were successfully deleted!");
}
else
{
Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
Helper.WriteError($"Not deleted signatures : {deleteResult.Failed.Count}");
}
Console.WriteLine("List of deleted signatures:");
foreach (BaseSignature temp in deleteResult.Succeeded)
{
Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
}
}
}
/// <summary>
/// Update QR-code signature from the document.
/// Update method supports changing QR-code location and size.
/// </summary>
public static void Run()
{
Console.WriteLine("\n--------------------------------------------------------------------------------------------------------------------");
Console.WriteLine("[Example Advanced Usage] # UpdateQRCodeAfterSearch : Update QR-code signature from the document\n");
// The path to the documents directory.
string filePath = Constants.SAMPLE_SIGNED_MULTI;
// copy source file since Update method works with same Document
string fileName = Path.GetFileName(filePath);
string outputFilePath = Path.Combine(Constants.OutputPath, "UpdateQRCodeAfterSearch", fileName);
Constants.CheckDir(outputFilePath);
File.Copy(filePath, outputFilePath, true);
// initialize Signature instance
using (Signature signature = new Signature(outputFilePath))
{
QrCodeSearchOptions options = new QrCodeSearchOptions();
List <QrCodeSignature> signatures = signature.Search <QrCodeSignature>(options);
// adjust signature properties
foreach (QrCodeSignature temp in signatures)
{
// apply some condition to adjust signature properties
temp.Left = temp.Left + 100;
temp.Top = temp.Top + 100;
temp.IsSignature = true;
}
// update all found signatures
UpdateResult updateResult = signature.Update(signatures.ConvertAll(p => (BaseSignature)p));
if (updateResult.Succeeded.Count == signatures.Count)
{
Console.WriteLine("\nAll signatures were successfully updated!");
}
else
{
Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
Helper.WriteError($"Not updated signatures : {updateResult.Failed.Count}");
}
Console.WriteLine("List of updated signatures:");
foreach (BaseSignature temp in updateResult.Succeeded)
{
Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
}
}
}
/// <summary>
/// Search document for QR-Code signature with applying specific options
/// </summary>
public static void Run()
{
Console.WriteLine("\n--------------------------------------------------------------------------------------------------------------------");
Console.WriteLine("[Example Advanced Usage] # SearchForQRCodeCustomSerializationObject : Search document for QR-Code signature with applying specific options\n");
// The path to the documents directory.
string filePath = Constants.SAMPLE_PDF_QRCODE_CUSTOM_SERIALIZATION_OBJECT;
using (Signature signature = new Signature(filePath))
{
// create data encryption
IDataEncryption encryption = new CustomXOREncryption();
QrCodeSearchOptions options = new QrCodeSearchOptions()
{
// specify special pages to search on
AllPages = true,
DataEncryption = encryption
};
try
{
// search for signatures in document
List <QrCodeSignature> signatures = signature.Search <QrCodeSignature>(options);
Console.WriteLine("\nSource document contains following signatures:");
foreach (var qrCodeSignature in signatures)
{
Console.WriteLine("QRCode signature found at page {0} with type {1}.", qrCodeSignature.PageNumber, qrCodeSignature.EncodeType);
DocumentSignatureData documentSignatureData = qrCodeSignature.GetData <DocumentSignatureData>();
if (documentSignatureData != null)
{
Console.WriteLine("QRCode signature has DocumentSignatureData object:\n ID = {0}, Author = {1}, Signed = {2}, DataFactor {3}",
documentSignatureData.ID, documentSignatureData.Author, documentSignatureData.Signed.ToShortDateString(), documentSignatureData.DataFactor);
}
}
}
catch
{
Helper.WriteError("\nThis example requires license to properly run. " +
"\nVisit the GroupDocs site to obtain either a temporary or permanent license. " +
"\nLearn more about licensing at https://purchase.groupdocs.com/faqs/licensing. " +
"\nLear how to request temporary license at https://purchase.groupdocs.com/temporary-license.");
}
}
}
/// <summary>
/// Search document for multiple signature types
/// </summary>
public static void Run()
{
Console.WriteLine("\n--------------------------------------------------------------------------------------------------------------------");
Console.WriteLine("[Example Basic Usage] # SearchForMultiple : Search document for multiple signature types \n");
// The path to the documents directory.
string filePath = Constants.SAMPLE_SIGNED_MULTI;
using (Signature signature = new Signature(filePath))
{
// define few search options
TextSearchOptions textOptions = new TextSearchOptions()
{
AllPages = true
};
DigitalSearchOptions digitalOptions = new DigitalSearchOptions()
{
AllPages = true
};
BarcodeSearchOptions barcodeOptions = new BarcodeSearchOptions()
{
AllPages = true,
Text = "123456",
MatchType = TextMatchType.Exact
};
QrCodeSearchOptions qrCodeOptions = new QrCodeSearchOptions()
{
AllPages = true,
Text = "John",
MatchType = TextMatchType.Contains
};
MetadataSearchOptions metadataOptions = new MetadataSearchOptions()
{
};
// add options to list
List <SearchOptions> listOptions = new List <SearchOptions>();
listOptions.Add(textOptions);
listOptions.Add(barcodeOptions);
listOptions.Add(qrCodeOptions);
listOptions.Add(metadataOptions);
listOptions.Add(digitalOptions);
// search for signatures in document
SearchResult result = signature.Search(listOptions);
if (result.Signatures.Count > 0)
{
Console.WriteLine($"\nSource document ['{filePath}'] contains following signatures.");
foreach (var resSignature in result.Signatures)
{
Console.WriteLine($"Signature found at page {resSignature.PageNumber} with type {resSignature.SignatureType} and Id#: {resSignature.SignatureId}");
}
}
else
{
Helper.WriteError("No one signature was found.");
}
}
}
/// <summary>
/// Following example shows how to process QR-Code Signature over all signature life-cycle.
/// First document is being signed with QR-Code Signature, then verified for it, searched for same, updating and finally deleting this signature.
/// Please be aware that this example works only on licensed product due to limitation with QR-code processing
/// </summary>
public static void Run()
{
Console.WriteLine("\n--------------------------------------------------------------------------------------------------------------------");
Console.WriteLine("[Example Advanced Usage] # ProcessingQrCodeSignatureOverCRUD : Process QR-Code Signature over all signature life-cycle\n");
// The path to the documents directory.
string filePath = Constants.SAMPLE_WORDPROCESSING;
string fileName = Path.GetFileName(filePath);
string outputFilePath = Path.Combine(Constants.OutputPath, "ProcessingQRCodeSignatureOverCRUD", fileName);
List <string> signatureIds = new List <string>();
// -----------------------------------------------------------------------------------------------------------------------------
// STEP 1. Sign document with QR-Code Signature
// -----------------------------------------------------------------------------------------------------------------------------
string bcText = "John Smith";
using (Signature signature = new Signature(filePath))
{
QrCodeSignOptions signOptions = new QrCodeSignOptions(bcText, QrCodeTypes.QR)
{
VerticalAlignment = VerticalAlignment.Top,
HorizontalAlignment = HorizontalAlignment.Center,
Width = 100,
Height = 40,
Margin = new Padding(20),
// set QR-Code color and Font
ForeColor = Color.Red,
Font = new SignatureFont {
Size = 12, FamilyName = "Comic Sans MS"
}
};
// sign document to file
SignResult signResult = signature.Sign(outputFilePath, signOptions);
Console.WriteLine("\nDocument {filePath} was signed with following signatures:");
foreach (BaseSignature temp in signResult.Succeeded)
{
// collect newly created signature' Id
signatureIds.Add(temp.SignatureId);
Console.WriteLine($"Signature : {temp.SignatureType} Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
}
}
// -----------------------------------------------------------------------------------------------------------------------------
// STEP 2. Verify document for QrCode Signature
// -----------------------------------------------------------------------------------------------------------------------------
using (Signature signature = new Signature(outputFilePath))
{
QrCodeVerifyOptions verifyOptions = new QrCodeVerifyOptions()
{
// specify if all pages should be verified
AllPages = false,
PageNumber = 1,
// QrCode type
EncodeType = QrCodeTypes.QR,
//
Text = bcText
};
// verify document signatures
VerificationResult verifyResult = signature.Verify(verifyOptions);
if (verifyResult.IsValid)
{
Console.WriteLine("\nDocument was verified successfully!");
}
else
{
Helper.WriteError("\nDocument failed verification process.");
}
// -----------------------------------------------------------------------------------------------------------------------------
// STEP 3. Search document for QrCode Signature
// -----------------------------------------------------------------------------------------------------------------------------
QrCodeSearchOptions searchOptions = new QrCodeSearchOptions()
{
// specify special pages to search on
AllPages = true
};
// search for QrCode signatures in document
List <QrCodeSignature> signatures = signature.Search <QrCodeSignature>(searchOptions);
Console.WriteLine("\nSource document contains following QrCode signature(s).");
// enumerate all signature for output
foreach (QrCodeSignature qrSignature in signatures)
{
if (qrSignature != null)
{
Console.WriteLine($"Found QrCode signature at page {qrSignature.PageNumber} with type [{qrSignature.EncodeType.TypeName}] and QrCode Text '{qrSignature.Text}'.");
Console.WriteLine($"Location at {qrSignature.Left}-{qrSignature.Top}. Size is {qrSignature.Width}x{qrSignature.Height}.");
}
}
// -----------------------------------------------------------------------------------------------------------------------------
// STEP 4. Update document QrCode Signature after searching it
// -----------------------------------------------------------------------------------------------------------------------------
foreach (QrCodeSignature qrSignature in signatures)
{
// change position
qrSignature.Left = qrSignature.Left + 100;
qrSignature.Top = qrSignature.Top + 100;
// change size. Please note not all documents support changing signature size
qrSignature.Width = 200;
qrSignature.Height = 50;
}
List <BaseSignature> signaturesToUpdate = signatures.ConvertAll(p => (BaseSignature)p);
UpdateResult updateResult;
updateResult = signature.Update(signaturesToUpdate);
if (updateResult.Succeeded.Count == signatures.Count)
{
Console.WriteLine("\nAll signatures were successfully updated!");
}
else
{
Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
Helper.WriteError($"Not updated signatures : {updateResult.Failed.Count}");
}
Console.WriteLine("List of updated signatures:");
foreach (BaseSignature temp in updateResult.Succeeded)
{
Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
}
// -----------------------------------------------------------------------------------------------------------------------------
// STEP 5. Update document QrCode Signature on saved SignatureId
// create list of QrCode Signature by known SignatureId
// -----------------------------------------------------------------------------------------------------------------------------
signaturesToUpdate.Clear();
foreach (var item in signatureIds)
{
QrCodeSignature temp = new QrCodeSignature(item)
{
Width = 150,
Height = 30,
Left = 100,
Top = 100
};
signaturesToUpdate.Add(temp);
}
// update all found signatures
updateResult = signature.Update(signaturesToUpdate);
if (updateResult.Succeeded.Count == signatures.Count)
{
Console.WriteLine("\nAll signatures were successfully updated!");
}
else
{
Console.WriteLine($"Successfully updated signatures : {updateResult.Succeeded.Count}");
Helper.WriteError($"Not updated signatures : {updateResult.Failed.Count}");
}
Console.WriteLine("List of updated signatures:");
foreach (BaseSignature temp in updateResult.Succeeded)
{
Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
}
// -----------------------------------------------------------------------------------------------------------------------------
// STEP 6. Delete document QrCode Signature by id
// create list of QrCode Signature by known SignatureId
signaturesToUpdate.Clear();
foreach (var item in signatureIds)
{
QrCodeSignature temp = new QrCodeSignature(item);
signaturesToUpdate.Add(temp);
}
// delete all signatures
DeleteResult deleteResult = signature.Delete(signaturesToUpdate);
if (deleteResult.Succeeded.Count == signaturesToUpdate.Count)
{
Console.WriteLine("\nAll signatures were successfully deleted!");
}
else
{
Console.WriteLine($"Successfully deleted signatures : {deleteResult.Succeeded.Count}");
Helper.WriteError($"Not deleted signatures : {deleteResult.Failed.Count}");
}
Console.WriteLine("List of deleted signatures:");
foreach (BaseSignature temp in deleteResult.Succeeded)
{
Console.WriteLine($"Signature# Id:{temp.SignatureId}, Location: {temp.Left}x{temp.Top}. Size: {temp.Width}x{temp.Height}");
}
}
}
