| SignatureReferenceElement Function | ||
|
||
|
Create a new SignatureReferenceElement.
|
Syntax
|
[C#]
|
Params
|
Notes
|
Create a new SignatureReferenceElement. The different constructors allow different ways of creating an Element. Some are used for wrapping existing Atoms or IndirectObjects and others are for creating new ones. The constructor taking a relation Element creates a new object in the document - it is typically the constructor you will want to use. Do not specify creation options unless you have very specific needs. However for your first Element - one you can use as a relation for the others - you will need to wrap an existing IndirectObject inside an Element. For this you might use code of the following form "CatalogElement root = new CatalogElement(doc.ObjectSoup.Catalog)". The parameterless constructor allows you to create an empty Element. By empty we mean it has no contents - no Atom within it. So before use an Atom must be Assigned or Created. In practice it is easiest to do this using one of the other constructors. The atom and host constructor is used to wrap an existing Atom. It creates an Element and then Assigns the Atom to it. The result is a specialized Element which can be used to examine or modify the contents of the Atom. The CreationOptions enumeration may take the following values:
|
Example
|
This code snippet is taken from Annotations.cs line 666 in the Annotations example project.
CommitSignature();
CatalogElement cat = new CatalogElement(Doc.ObjectSoup.Catalog);
cat.EntryAcroForm.EntrySigFlags = 3;
// NB If you don't want your signature to print then set the /F flag to 0
int fieldID = Doc.AddObject("<</Type /Annot /Subtype /Widget /F 4 /FT /Sig /DA (/TimesRoman 0 Tf 0 g)>>");
WidgetAnnotationElement widget = new WidgetAnnotationElement(Doc.ObjectSoup[fieldID]);
SignatureFieldElement field = (SignatureFieldElement)widget.FieldElement;
int sigDictID = Doc.AddObject("<</Type /Sig /Filter /Adobe.PPKLite /SubFilter /adbe.pkcs7.detached>>");
SignatureElement signature = new SignatureElement(Doc.ObjectSoup[sigDictID]);
if (inLocked) {
IndirectObject io = IndirectObject.FromString("<< /Type /SigFieldLock /Action /All /P 1 >>");
field.Host.Soup.Add(io);
SignatureFieldLockElement sigFieldLock = new SignatureFieldLockElement(io);
field.EntryLock = sigFieldLock;
field.Object.Version = 5; // PDF 1.5
}
field.EntryV = signature;
FormField formField = new FormField(this, inName, field.Object.ID);
formField.Widget.Rect = new XRect(inRect);
Doc.Form.Refresh();
mSig = (Signature)Doc.Form[inName];
sign(mSig);
if (inReason != null)
signature.EntryReason = inReason;
if (inLocation != null)
signature.EntryLocation = inLocation;
if (mSig.Signer != null)
signature.EntryName = mSig.Signer;
if (mCertify) {
// make it PDF 1.6, see the second point under "Validating MDP signatures" in the PDF reference
signature.Object.Version = 6;
// make signature MDP
int id = Doc.AddObject("<</Type /SigRef /TransformMethod /DocMDP /TransformParams <</Type /TransformParams /P 2 /V /1.2>>>>");
SignatureReferenceElement sigRef = new SignatureReferenceElement(Doc.ObjectSoup[id]);
signature.EntryReference = new ArrayElement<SignatureReferenceElement>(signature);
signature.EntryReference.Add(sigRef);
if (cat.EntryPerms == null)
cat.EntryPerms = new PermissionsElement(cat);
cat.EntryPerms.EntryDocMDP = signature;
}
if ((inAppearanceTextFormat != null) || (inImage != null)) {
XRect rect = widget.EntryRect.GetRect();
rect.Pin = XRect.Corner.TopLeft;
if (inAppearanceTextFormat != null) {
rect.Width = 200; // Change this to fit the Text
rect.Height = 60; // Change this to fit the Text
}
widget.EntryRect.SetRect(rect);
rect = rect.Clone();
rect.Pin = XRect.Corner.BottomLeft;
rect.Position(0, 0);
if (inImage != null) {
XRect imgRect = XRect.FromSides(0, 0, inImage.Width, inImage.Height);
imgRect.FitIn(rect, ContentAlign.Center, ContentScaleMode.ExactFit);
rect.String = imgRect.String;
}
double validityMessageHeight = 0;
int fontSize = 12;
if (mShowSignatureValidity) {
validityMessageHeight = Math.Min(0.3 * rect.Height, 0.1 * rect.Width);
fontSize = 8;
}
string theRect = Doc.Rect.String;
int theFont = Doc.Font;
int theFontSize = Doc.FontSize;
double charSpacing = Doc.TextStyle.CharSpacing;
double lineSpacing = Doc.TextStyle.LineSpacing;
int pageID = Doc.Page;
// Use a detached page to avoid changes to the current page
// or to the page tree for a new page
Doc.Page = Doc.AddObject("<</Type /Page /MediaBox [" + rect.String + "] >>");
Doc.Rect.String = rect.String;
StringBuilder apStream = new StringBuilder();
string imageResName = null;
int imageID = 0;
if (inImage != null) {
int imageLayerID = Doc.AddImage(inImage);
string imageStream = Doc.GetInfo(imageLayerID, "Stream");
ImageLayer il = (ImageLayer)Doc.ObjectSoup[imageLayerID];
imageID = il.PixMap.ID;
Doc.Delete(imageLayerID);
int l1 = imageStream.IndexOf("/Iabc", 0, imageStream.Length);
int l2 = imageStream.IndexOf(" ", l1, imageStream.Length - l1);
imageResName = imageStream.Substring(l1 + 1, l2 - l1 - 1);
apStream.Append(imageStream);
apStream.AppendLine();
}
string fontResName = null;
int fontID = 0;
if (inAppearanceTextFormat != null) {
if (validityMessageHeight != 0)
Doc.Rect.Top -= validityMessageHeight;
fontID = Doc.AddFont("Times-Roman");
Doc.Font = fontID;
Doc.FontSize = fontSize;
Doc.TextStyle.CharSpacing = 0;
Doc.TextStyle.LineSpacing = 2;
string text = string.Format(inAppearanceTextFormat, mSig.Signer, mSig.SigningUtcTime, inReason, inLocation);
int textID = Doc.AddText(text);
string textStream = Doc.GetInfo(textID, "Stream");
Doc.Delete(textID);
int l1 = textStream.IndexOf("/Fabc", 0, textStream.Length);
int l2 = textStream.IndexOf(" ", l1, textStream.Length - l1);
fontResName = textStream.Substring(l1 + 1, l2 - l1 - 1);
apStream.Append(textStream);
apStream.AppendLine();
}
Doc.Delete(Doc.Page);
Doc.Page = pageID;
Doc.Rect.String = theRect;
Doc.Font = theFont;
Doc.FontSize = theFontSize;
Doc.TextStyle.CharSpacing = charSpacing;
Doc.TextStyle.LineSpacing = lineSpacing;
FormXObjectElement appearance = MakeAppearance(rect, imageResName, imageID, fontResName, fontID, apStream.ToString());
if (mShowSignatureValidity) {
if (mBlankAppearance == null)
mBlankAppearance = MakeAppearance(XRect.FromSides(0, 0, 100, 100), null, 0, null, 0, "");
XRect clone = rect.Clone();
clone.Bottom = rect.Top - validityMessageHeight;
FormXObjectElement validityAppearance = MakeAppearance(clone, null, 0, fontResName, fontID, "");
double side = 0.9 * Math.Min(rect.Width, rect.Height);
string contents = string.Format(NumberFormatInfo.InvariantInfo,
"q 1 0 0 1 0 0 cm /n0 Do Q"
+ "\r\nq {0:0.#####} 0 0 {0:0.#####} {1:0.#####} {2:0.#####} cm /n1 Do Q"
+ "\r\nq 1 0 0 1 0 0 cm /n2 Do Q"
+ "\r\nq {0:0.#####} 0 0 {0:0.#####} {1:0.#####} {2:0.#####} cm /n3 Do Q"
+ "\r\nq 1 0 0 1 0 0 cm /n4 Do Q"
+ "\r\n", side / 100, (rect.Width - side) / 2, (rect.Height - side) / 2);
FormXObjectElement frmElement = MakeAppearance(rect, "", 0, null, 0, contents);
frmElement.EntryResources.EntryXObject.Add("n0", mBlankAppearance);
frmElement.EntryResources.EntryXObject.Add("n1", mBlankAppearance);
frmElement.EntryResources.EntryXObject.Add("n2", appearance);
frmElement.EntryResources.EntryXObject.Add("n3", mBlankAppearance);
frmElement.EntryResources.EntryXObject.Add("n4", validityAppearance);
appearance = MakeAppearance(rect, "", 0, null, 0, "q 1 0 0 1 0 0 cm /FRM Do Q\r\n");
appearance.EntryResources.EntryXObject.Add("FRM", frmElement);
}
widget.EntryAP = new AppearanceElement(widget);
widget.EntryAP.EntryN = appearance;
}
return formField;
|