Update Text Signatures in Document Leave feedback
GroupDocs.Signature for Python via .NET provides functionality to manipulate text signatures’ location, size, and textual content.
Please note that the update method modifies the same document that was passed to the constructor of the Signature class, so the example below copies the signed document first and updates the copy.
Here are the steps to update a Text signature in a document with GroupDocs.Signature:
- Create a new instance of the Signature class and pass the source document path as a constructor parameter
- Instantiate the TextSearchOptions object with desired properties
- Call the search method; the
signaturesproperty of the returned SearchResult holds the found text signatures - Select from the list the TextSignature object(s) that should be updated and change their properties
- Call the Signature object’s update method and pass one or several signatures to it; for a single signature it returns
Truewhen the signature was updated
This example shows how to update a Text signature that was found using the search method:
import shutil
from groupdocs.signature import Signature
from groupdocs.signature.options import TextSearchOptions
def update_text_signature():
# update() saves the changes into the opened document, so work on a copy
shutil.copy("signed.docx", "updated_text_signature.docx")
with Signature("updated_text_signature.docx") as signature:
options = TextSearchOptions()
# Return only signatures added by GroupDocs.Signature, not the document's own text
options.skip_external = True
signatures = signature.search([options]).signatures
print(f"Found {len(signatures)} text signature(s)")
if not signatures:
return
text_signature = signatures[0]
old_text = text_signature.text
# Change the text
text_signature.text = "John Walkman"
# Change the position
text_signature.left = text_signature.left + 10
text_signature.top = text_signature.top + 10
# Change the size. Not all document formats support resizing a signature
text_signature.width = 200
text_signature.height = 100
if signature.update(text_signature):
print(f"Updated '{old_text}' to '{text_signature.text}' at "
f"({text_signature.left}, {text_signature.top}), "
f"size {text_signature.width}x{text_signature.height}")
else:
print(f"Text signature '{old_text}' was not updated")
if __name__ == "__main__":
update_text_signature()
signed.docx is the sample file used in this example. Click here to download it.
Binary file (DOCX, 147 KB)
NoteNot every document format accepts every change. In PDF documents, a text signature added with the default (native) implementation can be moved, but its text and size stay as they were, althoughupdatestill returnsTrue. Text signatures added to a PDF as annotations or stickers accept text, position and size changes.
You may easily run the code above and see the feature in action in our GitHub examples:
Along with the full-featured Python library, we provide simple but powerful free online apps.
To sign PDF, Word, Excel, PowerPoint, and other documents you can use the online apps from the GroupDocs.Signature App Product Family.
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.
